q3rcon-tui 0.8.0

A terminal user interface for managing Q3 compatible servers using RCON.

q3rcon tui

---

Table of Contents

• Installation
• License

Installation

with uv

uv tool install q3rcon-tui

with pipx

pipx install q3rcon-tui

The TUI should now be discoverable as q3rcon-tui.

Configuration

Flags

Pass --host, --port and --password as flags:

q3rcon-tui --host=localhost --port=28960 --password=rconpassword

Additional flags:

• --raw: Boolean flag, if set the RichLog will print raw responses without rendering tables.
• --min-status: Boolean flag, if set the status command will print a minified table.
  • note, this will have no effect if in raw mode.
• --append: Boolean flag, if set the RichLog output will append each response continuously.
• --version: Print the version of the TUI.
• --help: Print the help message.

Environment Variables

Store and load from dotenv files located at:

• .env in the cwd
• user home directory / .config / q3rcon-tui / config.env

example .env:

Q3RCON_TUI_HOST=localhost
Q3RCON_TUI_PORT=28960
Q3RCON_TUI_PASSWORD=rconpassword
Q3RCON_TUI_MIN_STATUS=false
Q3RCON_TUI_RAW=false
Q3RCON_TUI_APPEND=false

Use

Type in your Rcon command and press ENTER.

Press Ctrl+q to exit from the application.

Special Thanks

• lapetus-11 for writing the aio-q3-rcon package.
• The developers at Textualize for writing the textual package.

License

q3rcon-tui is distributed under the terms of the MIT license.