partyline README

README проекта с github.com/RFnexus/partyline. Одним файлом markdown: README.md.

partyline

partyline

A group voice application for Reticulum, built on LXST, inspired by Mumble

Screenshot from 2026-09-04 07-05-40

Features

Installation

Requires Python 3.11 or newer

pip install partyline

For a system wide push to talk key, add the optional extra:

pip install "partyline[hotkeys]"

The graphical client uses Tk, which pip cannot install. On most OS/Distros it may already be installed by your system. If not:

On Debian or Ubuntu run sudo apt install python3-tk, on Fedora sudo dnf install python3-tkinter.

Installing from source

Requires Python 3.11 or newer, Reticulum, and LXST

git clone https://github.com/RFnexus/partyline
cd partyline
pip install .

Or install via rngit with:

git clone rns://4cf8a0651c4d73cacd0f93ac1d95e80a/public/partyline

For a system wide push to talk key, install the optional extra with:

pip install ".[hotkeys]"

This installs three commands: partyline, partyline-server and partyline-client.

Running

Start the GUI client:

partyline

Connect opens the server browser. Add a server by it's hash or use the server browser to find discovered servers from announces. Double click a room to join it. Settings has the audio devices, transmit mode, push to talk key, and UI appearance options Screenshot from 2026-09-04 07-06-15

Terminal client

partyline-client HASH --name Bob --room Lobby

Commands are: /join, /say, /poke, /who, /mute, /deaf

Type /ptt to toggle push to talk

Or as an operator: /kick, /ban, /smute, /op and /move

Server

Start a server:

partyline-server --name "My server" --profile opus-high

The server prints its destination hash for clients and with dial in enabled the number rnphone users call if configured for rooms. For rooms, access lists, operators, a server password and dial in, copy server_example.json and start with:

partyline-server --config server.json

Available --profile codecs for rooms:

See server_example.json for a full list of options. opus-high-med-low and the Codec2 modes are meant for voice, and music-high-med-low is meant for streaming music or broadcasting to a room. As a rule, use the highest bitrate your link can carry

Install as a systemd unit

To install as a systemd unit find the server command with which partyline-server then create /etc/systemd/system/partyline.service:

[Unit]
Description=Partyline voice server
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=partyline
ExecStart=/usr/local/bin/partyline-server --config /home/partyline/server.json
Restart=on-failure

[Install]
WantedBy=multi-user.target

Then:

sudo systemctl daemon-reload
sudo systemctl enable --now partyline

Music/Broadcasting Rooms & Bots

Server operators can also configure broadcast-only rooms for high quality music and audio using LXST's Opus CELT profiles. The options are music-high, music-med, and music-low. Music rooms are a special type of room where only the listed identities can send audio. Add their identity hash, seperated by commas, in music

{"name": "Broadcast", "profile": "music-med", "music": ["0123456789abcdef0123456789abcdef"], "description": "Music/broadcast room. Only listed identities may talk. Uses LXSTs Opus CELT profile"}
Screenshot from 2026-09-05 17-07-35

An example Music Bot can be found under bots/music_bot.py. When Partyline is installed with pip, run it with python3 -m partyline.bots.music_bot

PTT, or slow-mode rooms, are rooms designed to work over slower links like LoRa, bare copper wire bitbashing, and packet radio. Anything with more than a steady ~3.5 kbps throughput can use a PTT room. They can co-exist with regular rooms in a Partyline server, allowing both fast and slow clients to communicate over voice.

Unlike regular rooms there is a bit of latency. PTT rooms pack outgoing audio to fill the link's MTU, sending fewer, fuller packets instead of one frame per packet, and give every listener a larger receive jitter buffer to smooth out the bursty arrival you get over radio mediums like LoRa.

Mark any room push to talk with "ptt": true. Optionally set "ptt_jitter_ms" to change the buffer depth. It's recommended to use PTT rooms with the codec2 profiles.

{"name": "LoRa 1200", "profile": "c2-1200", "ptt": true, "description": "Slow-link push to talk"}
{"name": "Packet Radio Net 700",  "profile": "c2-700",  "ptt": true, "ptt_jitter_ms": 9000}

LLM Disclosure Notice

Kimi K3 (https://www.kimi.com/en) third party hosted API was used for the following tasks:

UI Translation

The .po files are located in partyline/locale/

To update a translation, change the msgstr line under its English msgid

To add a language, copy partyline.pot to a new .po file and add it to LANGUAGES in partyline/i18n.py.

Run python partyline/locale/compile.py, then open a pull request with your changes or submit it to the LXMF address:

Credits

partyline (RFnexus/partyline)

Ищем в базе…

Что это такое?Partyline — это зашифрованное групповое голосовое приложение для сети Reticulum, построенное на аудиостеке LXST и вдохновлённое Mumble. Вы разворачиваете лёгкий сервер, создаёте комнаты и подключаетесь к ним через графический или терминальный клиент по любому транспорту Reticulum.
Это десктопное приложение, сервер или и то и другое?И то и другое: 'partyline' — это графический клиент, а 'partyline-client' — терминальный клиент, который вы запускаете на своём компьютере. 'partyline-server' — это сервер, который вы разворачиваете сами, чтобы создавать комнаты, к которым подключаются другие.
Как всё запустить?Выполните pip install partyline (нужен Python 3.11+), затем запустите 'partyline' для графического клиента, 'partyline-client HASH --name Bob --room Lobby' для терминального клиента или 'partyline-server --name "My server" --profile opus-high', чтобы поднять сервер.
Нужно ли что-то кроме Python, чтобы запустить графический интерфейс?Нужны Python 3.11+, стек Reticulum и LXST, а также Tk для графического клиента, так как pip не может установить сам Tk. В Debian/Ubuntu используйте 'apt install python3-tk', в Fedora — 'dnf install python3-tkinter'. Для системной клавиши push-to-talk нужно установить необязательное дополнение [hotkeys].
Есть ли подвох при работе через медленные или радиоканалы?На очень медленных каналах (LoRa, пакетная радиосвязь, обычная медная линия) нужны специальные комнаты PTT/slow-mode с кодеком Codec2 вплоть до 700 бит/с. Они добавляют некоторую задержку, потому что аудио упаковывается в меньшее число более заполненных пакетов с увеличенными джиттер-буферами.
Шифруется ли мой голос, когда я говорю через Partyline?Да, голос и аудио шифруются сквозным шифрованием для группового голосового общения в реальном времени через любой транспорт Reticulum, если канал передаёт более 6 кбит/с.
Что такое dial-in и какие клиенты его поддерживают?Когда сервер включает dial-in, клиенты LXST в стиле телефона, такие как rnphone, Sideband и MeshChatX, могут позвонить на сервер и сразу попасть в настроенную комнату.
Можно ли использовать комнаты для стриминга музыки вместо голоса?Да, серверы могут настраивать комнаты только для вещания музыки с высококачественными профилями Opus (14–56 кбит/с). В таких комнатах передавать могут только идентификаторы из списка разрешённых. Пример скрипта музыкального бота включён в bots/musicbot.py.
Как контролируется доступ к комнате?Каждая комната может быть открытой, ограниченной для идентифицированных пользователей, доступной только по списку разрешённых хешей идентификаторов или защищённой паролем. Сами серверы также могут требовать пароль или список разрешённых.
Доступен ли интерфейс на языках, отличных от английского?Да, клиент использует i18n на основе gettext и уже включает переводы на эсперанто, испанский, нидерландский и русский. Добавить другие языки можно через файлы .po.
Какие есть похожие проекты?tincan-cli, p2wlan, bitchat, EasyTier, nebula, EnvoyMesh, MeshChatX, MeshLAN
Автор
RFnexus
Размер
0.8 MB
Звёзды
138
Возраст
2 мес
Коммиты · 90 дней