This is an old revision of the document!


Toxic is a Tox client with a command-line interface. Development is currently lead by Jfreegman.

Maintainers: Jfreegman, mannol
Language: C
Graphical Toolkit: ncurses
Operating Systems: Linux, OS X, FreeBSD


Toxic was originally written by Plutooo in the experimental branch of ProjectTox on July 29, 2013. Following Plutooo's disappearance soon after his initial commit, Jfreegman took over leadership and continued Toxic's development. Although extremely buggy and lacking in basic features in its initial state, rapid development by the Tox community made it the first 'usable' Tox client, and it soon superseded nTox as the reference CLI client. Toxic was initially part of the toxcore repository, but was moved to its own github repository as a stand-alone project on August 23, 2013.

Toxic Running on Linux


Coming soon

Building from Source (advanced)

To build Toxic from source, installation instructions and library dependencies can be found in Toxic's Readme.



Use pkg utility to install binary package:

 pkg install toxic


Update ports tree:

 portsnap fetch update

Compile and install client with all dependencies:

 cd /usr/ports/net-im/toxic
 make install clean


Once toxic is compiled and/or installed, Toxic can be run via the commandline with the command `toxic`. For a list of options run `toxic –help`. For detailed usage instructions, see the manpage with `man toxic`. For details on the user configuration file, run `man toxic.conf` or see the example config file.


  • 1-on-1 chats
  • 1-on-1 file transfers
  • 1-on-1 audio calls
  • Group chats
  • Audio and native desktop notifications (may be disabled with build options or in settings)
  • Chat logging (disabled by default)
  • Pseudo-offline messaging
  • SOCKS5 Proxy support (Disable UDP with the –force-tcp option to prevent IP leakage)
  • DNS-based username lookups
  • Contact blocking (not supported by toxcore; may be buggy)
  • Optional save file encryption/password protection
  • Personal avatars (setting only)
  • Advanced command-line behaviour such as tab-completion, killing/yanking, word deletion etc.

Other clients