Toxic

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

Installation

Dependencies

Base

• libtoxcore
• ncurses (for Debian based systems, 'libncursesw5-dev')
• libconfig (for Debian based systems, 'libconfig-dev')

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 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:

• Linux 32 bit
• Linux 64 bit

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.