2014-06-25 04:19:37 +08:00
toxgui
======
For-fun Tox client that tries to follow the Tox UI mockup while running on all major systems. < br / >
This GUI uses code from @nurupo 's ProjectTox-Qt-GUI, in particular the "Core" Toxcore wrapper. < br />
However, it is not a fork.
< h2 > Features< / h2 >
2014-06-28 16:53:38 +08:00
- One to one chat with friends
- Group chats
2014-06-27 01:49:59 +08:00
- File transfers, with previewing of images
2014-06-28 04:00:06 +08:00
- Audio calls
2014-06-30 22:19:46 +08:00
- Video calls
2014-07-01 02:40:28 +08:00
- Tox DNS
2014-07-04 21:42:14 +08:00
- Translations in various languages
2014-06-25 04:19:37 +08:00
< h2 > Requirements< / h2 >
2014-06-27 02:59:45 +08:00
This client will run on Windows, Linux and Mac natively, but binairies are only be provided for Windows at the moment. < br / >
2014-07-01 19:23:33 +08:00
Linux and Mac users will have to compile the source code themselves.
2014-06-25 04:21:34 +08:00
2014-07-01 09:50:49 +08:00
< a href = "https://jenkins.libtoxcore.so/job/tux3-toxgui-win32/lastSuccessfulBuild/artifact/toxgui-win32.zip" > Windows download< / a > < br / >
< a href = "http://speedy.sh/XXtHa/toxgui" > Linux download (1st July 2014 01:30 GMT)< / a > < br / >
2014-07-04 21:42:14 +08:00
Note that the Linux download has not been tested and is not kept up to date.
2014-06-27 02:58:53 +08:00
2014-06-27 01:49:59 +08:00
< h3 > Screenshots< / h3 >
2014-06-28 01:14:19 +08:00
< h5 > Note: The screenshots may not always be up to date, but they should give a good idea of the general look and features< / h5 >
2014-07-01 18:42:53 +08:00
< img src = "http://i.imgur.com/mMUdr6u.png" / >
2014-06-27 01:49:59 +08:00
< img src = "http://i.imgur.com/66ARBGC.png" / >
2014-07-04 21:42:14 +08:00
< h3 > Compiling< / h3 >
Compiling toxgui requires Qt 5.2 with the Qt Multimedia module and a C++11 compatible compiler.
It also requires the toxcore and toxav libraries.
To compile, first clone or download the toxgui repository and open a terminal in the toxgui folder.
Then run the script bootstrap.sh (for Linux and Mac) or bootsrap.bat (for Windows) to download an up-to-date toxcore.
And finally run the commands "qmake" and "make" to start building toxgui.
2014-07-04 21:53:33 +08:00
2014-07-04 15:50:55 +08:00
< h3 > OSX Install Guide< / h3 >
< strong > This guide is intended for people who wish to use an existing or new ProjectTox-Core installation separate to the bundled installation with toxgui, if you do not wish to use a separate installation you can skip to the section titled 'Final Steps'.< / strong >
Installation on OSX, isn't quite straight forward, here is a quick guide on how to install;
The first thing you need to do is install ProjectTox-Core with a/v support. Refer to the INSTALL guide in the ProjectTox-Core github repo.
Next you need to download QtTools (http://qt-project.org/downloads), at the time of writing this is at version 5.3.0.
Make sure you deselect all the unnecessary components from the 5.3 checkbox (iOS/Android libs) otherwise you will end up with a very large download.
Once that is installed you will most likely need to set the path for qmake. To do this, open up terminal and paste in the following;
```bash
export PATH=/location/to/qmake/binary:$PATH
```
For myself, the qmake binary was located in /Users/mouseym/Qt/5.3/clang_64/bin/.
2014-07-06 05:29:37 +08:00
This is not a permanent change, it will revert when you close the terminal window, to add it permanently you will need to add echo the above line to your .profile/.bash_profile.
2014-07-04 15:50:55 +08:00
Once this is installed, do the following;
```bash
git clone https://github.com/tux3/toxgui
cd toxgui
qmake
```
Do not run make, as we need further modifications to toxgui.
Open up the Makefile in a text editor (TextEdit/TextWrangler, etc).
You will need to modify the Makefile to point to your toxcore libs/includes.
2014-07-06 05:29:37 +08:00
The first change you will need to make is to point the Makefile towards the tox libs installed on your system. (Generally this is /usr/local/lib/).
2014-07-04 15:50:55 +08:00
Look for the line in the Makefile which references /toxgui/lib/libs/ and replace with the above).
The second change to Makefile is to add the location of the includes (On my system these were placed in /usr/local/include/tox/).
To do this, search for the INCLUDES line and add the following to the end;
```bash
2014-07-06 05:29:37 +08:00
-I/usr/local/include/
2014-07-04 15:50:55 +08:00
```
2014-07-06 05:29:37 +08:00
Do not point it to the tox/ directory as the build script will look in there for you.
2014-07-04 15:50:55 +08:00
Save the Makefile.
2014-07-04 23:47:38 +08:00
< h5 > Final Steps< / h5 >
2014-07-04 15:50:55 +08:00
The final step is to run
```bash
make
```
in the toxgui directory, or if you are using the bundled tox core installation, you can use
```bash
./bootstrap.sh
```
Assuming all went well you should now have a toxgui.app file within the directory. Double click and it should open!
