Tha_14/toxic
1
0
Fork 0
mirror of https://github.com/Tha14/toxic.git synced 2024-12-23 07:03:25 +01:00
Code Issues Projects Releases Wiki Activity
A Tox-based instant messaging and video chat client
1,374 Commits 20 Branches 34 Tags 18 MiB
C 95.5%
Makefile 1.8%
Objective-C 1%
Shell 1%
Python 0.6%
Other 0.1%
0a132b0eb5
Go to file
Loui Chang 0a132b0eb5 doc: Unlink docs from the rest of the build process. 
Since generated man pages are also included, we can't
guarantee proper timestamps. This should fix issues that trigger doc
building when it isn't needed.

Signed-off-by: Loui Chang <louipc.ist@gmail.com>
2014-10-12 23:21:48 -04:00
build doc: Unlink docs from the rest of the build process. 2014-10-12 23:21:48 -04:00
cfg doc: Unlink docs from the rest of the build process. 2014-10-12 23:21:48 -04:00
doc update settings and docs with peerlist-toggle keybinding 2014-10-08 03:08:08 -04:00
misc update DHTnodes 2014-10-08 14:44:15 -04:00
sounds replace call sounds 2014-10-01 19:38:09 -04:00
src prompt: Add version line to startup message. 2014-10-12 23:12:56 -04:00
.gitignore Update .gitignore: remove autotools 2014-06-24 12:37:43 +02:00
.travis.yml add asciidoc and libnotify-dev to install script 2014-09-29 01:54:53 -04:00
COPYING Put back license 2014-06-24 17:48:49 +02:00
README.md doc: Unlink docs from the rest of the build process. 2014-10-12 23:21:48 -04:00

README.md

Toxic Build Status

Toxic is a Tox-based instant messenging client which formerly resided in the Tox core repository, and is now available as a standalone application.

Toxic Screenshot

Installation

Dependencies

Base
Audio
  • libtoxav (libtoxcore compiled with audio support)
  • openal (for Debian based systems, 'libopenal-dev')
Sound notifications
  • openal (for Debian based systems, 'libopenal-dev')
  • openalut (for Debian based systems, 'libalut-dev')
Desktop notifications
  • libnotify (for Debian based systems, 'libnotify-dev')
Documentation
  • Asciidoc (only required for regenerating manpages)
    • Run make doc in the build directory after editing the asciidoc files to regenerate the manpages.
    • NOTE FOR DEVELOPERS: asciidoc files and generated manpages will need to be commited together.

Compiling

  1. cd build/
  2. make PREFIX="/where/to/install"
  3. sudo make install PREFIX="/where/to/install"

Compilation Notes

  • You can add specific flags to the Makefile with USER_CFLAGS="" and/or USER_LDFLAGS=""
  • You can pass your own flags to the Makefile with CFLAGS="" and/or LDFLAGS="" (this will supersede the default ones)
  • Additional features are automatically enabled if all dependencies are found, but you can disable them by using special variables:
    • DISABLE_X11=1 → build toxic without X11 support (needed for focus tracking)
    • DISABLE_AV=1 → build toxic without audio call support
    • DISABLE_SOUND_NOTIFY=1 → build toxic without sound notifications support
    • DISABLE_DESKTOP_NOTIFY=1 → build toxic without desktop notifications support

Packaging

  • For packaging purpose, you can use DESTDIR="" to specify a directory where to store installed files
  • DESTDIR="" can be used in addition to PREFIX="":
    • DESTDIR="" is meant to specify a directory where to store installed files (ex: "/tmp/build/pkg")
    • PREFIX="" is meant to specify a prefix directory for binaries and data files (ex: "/usr/local")

Troubleshooting

If your default prefix is "/usr/local" and you receive the following:

error while loading shared libraries: libtoxcore.so.0: cannot open shared object file: No such file or directory

you can attempt to correct it by running sudo ldconfig. If that doesn't work, run:

echo '/usr/local/lib/' | sudo tee -a /etc/ld.so.conf.d/locallib.conf
sudo ldconfig

Precompiled binaries

You can download precompiled binaries from jenkins:

Settings

Running Toxic for the first time creates an empty file called toxic.conf in your home configuration directory ("~/.config/tox" for Linux users). Adding options to this file allows you to enable auto-logging, change the time format (12/24 hour), and much more. You can view our example config file here.