Both sides previous revisionPrevious revisionNext revision | Previous revision |
clients:toxic [2015/07/12 00:08] – include clients table zetok | clients:toxic [2020/05/23 18:05] (current) – add status skeleton1 |
---|
**Toxic** is a Tox-based CLI (Command Line Interface) client with an ncurses interface, written in C. Development is currently lead by Jfreegman. All Unix-like operating systems are currently supported (e.g. Linux, OSX, FreeBSD). | ======Toxic====== |
| |
| GitHub: | https://github.com/Tox/toxic | | **Toxic** is a Tox client with a command-line interface. Development is currently lead by Jfreegman. |
| Maintainers: | [[wiki:user:Jfreegman]], [[https://github.com/mannol|mannol]] | | |
| |
| | Repository: | https://github.com/Jfreegman/toxic | |
| | Maintainers: | [[wiki:user:Jfreegman]], [[https://github.com/mannol|mannol]] | |
| | Language: | C | |
| | Graphical Toolkit: | [[https://www.gnu.org/software/ncurses/ncurses.html|ncurses]] | |
| | Operating Systems: | Linux, OS X, FreeBSD | |
| | Status: | Active | |
===== History ===== | ===== History ===== |
Toxic was originally [[https://github.com/Tox/toxic/commit/1974fa23d21bedb672f1c0d77dfa85f73037f5c1|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 deprecated [[nTox]] as the reference CLI client. Toxic was initially part of the toxcore repository, but was [[https://github.com/irungentoo/toxcore/commit/c759967ad403a22b5baa729f9b6b395f9c766cd4|moved]] to its own github repository as a stand-alone project on August 23, 2013. | Toxic was originally [[https://github.com/Jfreegman/toxic/commit/1974fa23d21bedb672f1c0d77dfa85f73037f5c1|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 [[https://github.com/irungentoo/toxcore/commit/c759967ad403a22b5baa729f9b6b395f9c766cd4|moved]] to its own github repository as a stand-alone project on August 23, 2013, and moved again to Jfreegman's account on October 15, 2015. |
| |
{{ users:toxic.png?380px|Toxic Running on Linux}} | {{ users:toxic.png?380px|Toxic Running on Linux}} |
===== Install ===== | ===== Install ===== |
==== Package installation (recommended) ==== | ==== Package installation (recommended) ==== |
To install Toxic via the official Tox repository, follow [[https://wiki.tox.im/Binaries#Repositories|these instructions]], then install it as you would any other package (for example, on debian based systems: ''`apt-get install toxic`''). deb and rpm packages can be directly downloaded from [[https://jenkins.libtoxcore.so/job/toxic-linux-pkg|here]]. | |
| |
| Install the [[:binaries|Tox Debian repository]] per the instructions. For debian-based systems (Ubuntu, Mint etc.) use the command **apt-get install toxic** or **apt-get install toxic-no-x11** to install the fully featured and no-X11 versions of toxic respectively. |
==== Building from Source (advanced) ==== | ==== Building from Source (advanced) ==== |
To build Toxic from source, installation instructions and library dependencies can be found in [[https://github.com/Tox/toxic/blob/master/README.md|Toxic's Readme]]. | To build Toxic from source, installation instructions and library dependencies can be found in [[https://github.com/Jfreegman/toxic/blob/master/README.md|Toxic's Readme]]. |
| |
==== FreeBSD ==== | ==== FreeBSD ==== |
| |
=== Binary === | === Binary === |
---- | |
Use pkg utility to install binary package: | Use pkg utility to install binary package: |
pkg install toxic | pkg install toxic |
| |
=== Compiling === | === Compiling === |
---- | |
Update ports tree: | Update ports tree: |
portsnap fetch update | portsnap fetch update |
Compile and install client with all dependencies: | Compile and install client with all dependencies: |
cd /usr/ports/net-im/toxic | cd /usr/ports/net-im/toxic |
make install clean | make install clean |
| |
===== Usage ===== | ===== Usage ===== |
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 [[https://github.com/Tox/toxic/blob/master/misc/toxic.conf.example|example config file]]. | Once toxic is compiled and/or installed, it 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 [[https://github.com/Jfreegman/toxic/blob/master/misc/toxic.conf.example|example config file]]. |
| |
===== Features ===== | ===== Features ===== |
* 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) | * Audio and native desktop notifications (may be disabled with build options or in settings) |
* Chat logging (disabled by default) | |
* Pseudo-offline messaging | * Pseudo-offline messaging |
* SOCKS5 Proxy support (Disable UDP with the --force-tcp option to prevent IP leakage) | * SOCKS5 and HTTP Proxy support (Disable UDP with the --force-tcp option to prevent IP leakage) |
* DNS-based username lookups | * Contact blocking |
* Contact blocking (not supported by toxcore; may be buggy) | * Password protected profiles |
* Optional save file encryption/password protection | * Ability to encrypt and unencrypt Tox profiles (works with profiles from any Tox client) |
* Personal avatars (setting only) | |
* Advanced command-line behaviour such as tab-completion, killing/yanking, word deletion etc. | * Advanced command-line behaviour such as tab-completion, killing/yanking, word deletion etc. |
| * Ability to act as a TCP relay in the Tox network |
| * Configurable bootstrap nodes list |
===== Other clients ===== | ===== Other clients ===== |
| |
{{page>include:clients}} | {{page>include:clients}} |