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'。若要使用全局按键说话(一键通)功能,还需安装可选的 [hotkeys] 扩展。
在慢速或电台链路上使用,有什么限制吗?在极慢的链路(如 LoRa、分组无线电、裸铜线)上,你需要使用专门的 PTT/慢速模式房间,采用可低至 700bps 的 Codec2 编解码器;由于音频会被打包成更少但更满的数据包,并使用更大的抖动缓冲区,这会带来一些额外延迟。
我在 Partyline 上说话时,声音会被加密吗?会的。只要链路速率超过 6 kbps,无论通过哪种 Reticulum 传输方式,实时群组语音的声音和音频都会进行端到端加密。
什么是拨入功能?哪些客户端支持?服务器开启拨入功能后,rnphone、Sideband、MeshChatX 等类似电话的 LXST 客户端就可以呼叫该服务器,并直接进入指定的房间。
房间能用来播放音乐,而不是语音吗?可以。服务器可以配置仅广播的音乐房间,使用高质量 Opus 配置(14–56 kbps),且只有白名单中的身份才能发送音频。此外,还附带了一个示例音乐机器人脚本,位于 bots/musicbot.py。
如何控制对房间的访问?每个房间可以设为开放访问、仅限已验证身份的用户、限制为身份哈希白名单,或设置密码保护;服务器本身也可以要求密码或白名单。
界面是否支持英文以外的语言?支持。客户端采用基于 gettext 的国际化(i18n)机制,目前已内置世界语、西班牙语、荷兰语和俄语翻译,并且可以通过 .po 文件添加更多语言。
作者
RFnexus
大小
0.8 MB
星标
138
时长
2个月
提交 · 90 天