Minimal client for Tox
Switch branches/tags
Nothing to show
Clone or download
hqwrong Merge pull request #9 from iphydf/void-param
Use (void) for empty parameter list in C.
Latest commit 20d9685 Nov 23, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore add gitignore Jun 25, 2018
LICENSE Initial commit Apr 16, 2018
Makefile add Makefile Jun 25, 2018 Use nanosleep instead of usleep. Aug 26, 2018
minitox.c Merge pull request #9 from iphydf/void-param Nov 23, 2018
minitox.jpeg add pic Apr 16, 2018



minitox is a minimal client written for toxcore. It's an example of tox client implementation and also a toy which new developers coming to tox can play and start with, therefore getting familiar with the project.


  1. Single file and small codebase;
  2. Fully standalone (No 3rd library needed, only rely on toxcore and system C library);
  3. Covered most APIs of friend & group, and more to come;
  4. Fun to play with (colored text, async REPL, etc.).


If toxcore has been installed into the system path, use


Or link it manually (assuming exists in TOX_LIB_DIR, and tox.h in TOX_H_DIR/tox):

$ gcc -o minitox minitox.c -I TOX_H_DIR -L TOX_LIB_DIR -Wl,-rpath TOX_LIB_DIR -ltoxcore


To keep things simple, minitox does not provide command line options, except for -h and --help. To change its behaviour, you are encouraged to modify the source file and rebuild. The source file has been heavily commented.