tox client 1N0D3

Terminal TUI for Tox

Encrypted P2P messaging without central servers. Python + Textual + libtoxcore. GPL-3.0.

Download Install
8 themes groups files SQLite

$ About

What it is

TOXTUI is a concise terminal client for Tox: direct chats, groups, file transfers, friend statuses. Works over SSH and on VPS hosts.

Stack

Features

  • Themes: inode3, matrix, nord, and more
  • Message queue for offline friends
  • --mock for demo on a single PC
  • --compact for narrow terminals

Data

Profiles and config: ~/.config/toxtui/
UI theme: config.toml → ui_theme

$ Interface

Acid-green inode3 theme in a real terminal.

TOXTUI — chat screen
TOXTUI — hotkeys
TOXTUI — terminal, screen 0
TOXTUI — terminal, screen 1
TOXTUI — terminal, screen 2
TOXTUI — terminal, screen 3
TOXTUI — terminal, screen 4
TOXTUI — terminal, screen 5
TOXTUI — terminal, screen 6
TOXTUI — interface 1
TOXTUI — interface 2
TOXTUI — interface 3
TOXTUI — interface 4
TOXTUI — interface 5
TOXTUI — interface 6

$ Download

TOXTUI source archive — no git required, ready to build on Debian/Ubuntu.

v0.1.0 58 KB · tar.gz
Download toxtui-0.1.0.tar.gz

GPL-3.0-or-later · Python 3.11+ · Linux

01

Extract

tar -xzf toxtui-0.1.0.tar.gz
cd toxtui-0.1.0

$ Install & run

After extracting the archive. Debian/Ubuntu, local .venv.

01

Dependencies & venv

sudo apt update && sudo apt install -y \
  python3 python3-venv python3-dev python3-pip \
  libsodium-dev libtoxcore-dev pkg-config cython3 \
  git cmake ninja-build

python3 -m venv .venv && source .venv/bin/activate
python -m pip install -U pip setuptools wheel
python -m pip install -e ".[dev]"
02

Build py-toxcore

chmod +x scripts/build_py_toxcore.sh
./scripts/build_py_toxcore.sh
source scripts/tox_env.sh
python -c "import pytox.toxcore.tox; print('OK')"

On low-RAM VPS: TOXTUI_LOW_MEM=1 ./scripts/build_py_toxcore.sh

03

Run

./scripts/run_toxtui.sh          # real Tox
./scripts/run_toxtui.sh --mock   # demo on a single PC
./scripts/run_toxtui.sh --compact

Alias: ln -sf "$(pwd)/scripts/run_toxtui.sh" ~/bin/toxtui

One-liner (Debian)

sudo apt update && sudo apt install -y python3 python3-venv python3-dev python3-pip \
  libsodium-dev libtoxcore-dev pkg-config cython3 git cmake ninja-build && \
cd toxtui-0.1.0 && rm -rf .venv && python3 -m venv .venv && source .venv/bin/activate && \
python -m pip install -U pip setuptools wheel && python -m pip install -e ".[dev]" && \
chmod +x scripts/build_py_toxcore.sh && ./scripts/build_py_toxcore.sh && \
source scripts/tox_env.sh && python -c "import pytox.toxcore.tox; print('OK')" && \
./scripts/run_toxtui.sh

$ Contacts

Email toxtuisupp@atomicmail.io
Tox QR Tox ID QR code
Monero QR Monero wallet QR code
Monero (XMR)
46z2ZgPBXWriVKthPQ4neDNGZYq8CkoebVUKcDzNxdjEHFSNm2r5u9pPvW31FFvLhYVhNLzQYMZbiTEP1ANGb2TX1HJwQHK

$ License

TOXTUI is distributed under the GPL-3.0-or-later license. Source code, libtoxcore build, and Tox usage are subject to free software terms.