Skip to content
This repository has been archived by the owner on Jun 11, 2020. It is now read-only.

Latest commit

 

History

History
99 lines (70 loc) · 5.3 KB

INSTALL.md

File metadata and controls

99 lines (70 loc) · 5.3 KB
Raw

Installation

Dependencies

Name Version
Qt >= 5.2.0
C++ compiler supporting C++11 (i.e. gcc 4.6+)
toxcore most recent

Unix-like (Linux, Unix, OS X):

Grab and install Qt 5.2.0+ from qt-project website. Alternatively you could get it from your distro's package repository (qtbase5-dev on Debian Jessie).

Then install toxcore following these instructions.

Clone this repo and build it with Qt's qmake:

git clone https://github.com/nurupo/ProjectTox-Qt-GUI.git
cd ProjectTox-Qt-GUI
mkdir build && cd build
qmake -Wall ../projectfiles/QtCreator/TOX-Qt-GUI.pro
make

On success, this will produce a TOX-Qt-GUI executable.

See building using Qt Creator if you want to build the project by using Qt Creator IDE, rather than shell commands.

Troubleshooting

  • Note that qmake might not be found by bash or it might be found, but from Qt4 installation. In the case of qmake not working, make sure you use the right qmake.

    • If you have installed Qt5 from the qt-project website, you should specify the full path to Qt's qmake, since it's not added to /user/bin/. For example, in my case I used /home/nurupo/Qt5.2.0/5.2.0/gcc_64/bin/qmake.
    • If you use qmake from your distro's package repository, you might need to pass -qt=5 option to it.

  • If Qt complains about missing GL library, install libgl-dev package (libgl1-mesa-dev on Debian). The exact package name might differ from distribution to distribution, but you get the idea of what you should look for.

  • On OS X you may get a warning while running qmake: "WARNING: Could not resolve Info.plist: 'Info.plist.app'. Check if QMAKE_INFO_PLIST points to a valid file". It should be safe to ignore it.

Windows

Grab and install MinGW version of Qt 5.2.0+ from qt-project website. The MinGW version includes MinGW compiler, so you don't have to bother with installing one manually.

Download and extract a ZIP archive of this repo's master branch, or, if you have git, clone the repository:

git clone https://github.com/nurupo/ProjectTox-Qt-GUI.git

Get toxcore appropriate for the platform your toolchain targets: toxcore-32bit or toxcore-64bit. If you use MinGW compiler that came with Qt MinGW, then you want toxcore-32bit.

Create libs directory in repo's root and extract contents of the toxcore archive in there.

Run cmd.exe, navigate to the repo' directory and run:

set PATH=%PATH%;C:\wherever\is\your\Qt\installed\Tools\mingw48_32\bin\
cd projectfiles && mkdir build && cd build
C:\wherever\is\your\Qt\installed\5.2.0\mingw48_32\bin\qmake.exe -Wall ../QtCreator/TOX-Qt-GUI.pro
C:\wherever\is\your\Qt\installed\Tools\mingw48_32\bin\mingw32-make.exe

On success, this will produce a TOX-Qt-GUI.exe binary. If you used Qt from qt-project webite, your binary would be dynamically linked to Qt's libraries, i.e. the executable would require Qt's dlls from C:\wherever\is\your\Qt\installed\5.2.0\mingw48_32\bin\ in order to run.

See building using Qt Creator if you want to build the project by using Qt Creator IDE, rather than command prompt.

Building using Qt Creator

Qt Creator is cross-platform, so the next instructions should be valid for all platforms.

If you downloaded Qt from the qt-project website, then it's likely that you already have it installed in the Qt's directory. Some generic Qt packages on Linux also install it.

To build the project with Qt Creator:

  1. Open the Qt Creator.
  2. Select File -> Open File or Project....
  3. Select the project file located at ProjectTox-Qt-GUI\projectfiles\QtCreator\TOX-Qt-GUI.pro.
  4. You will be prompted to configure the project, select one set of Qt5.2.0+ libraries (Release and Debug) and click on Configure Project.
  5. You will see two Debugs on the left, click on the lowest one and switch it to Release.
  6. Optional: if you want to speed up the building process a little:
  7. Click on Projects on the left.
  8. Under Build Steps find Make.
  9. Click on its Details.
  10. Add -jN to the Make arguments, where N is a number of cores your processor has + 1. For example, if your machine is dual core, add -j3.
  11. Close the Details.
  12. Click the big green arrow on bottom left (or press Ctlr+R), that should build and run the project in Release mode.
  13. Wait for it to be built.
  14. You should have a binary in whenever Project (on the left) -> Build directory points to.

Here is a screen capture of the process: Building-using-Qt-Creator.webm.