quasseltui

Terminal client for Quassel IRC cores. Connects to your existing quasselcore and gives you a Textual-based TUI as an alternative to quasselclient (the Qt GUI) or Quasseldroid.

quasseltui in action

Quick start

Run via UVX without downloading/installing:

uvx --from git+https://github.com/linsomniac/quasseltui@main quasseltui

Run via UV:

#  clone this repo, then:
uv sync
uv run python -m quasseltui --help

Config file

Instead of using command-line arguments (quasseltui --help for more information), you can use a config file.

Connection settings can be loaded from ~/.config/quasseltui/config.ini (or $XDG_CONFIG_HOME/quasseltui/config.ini) so that --host, --port, --user, etc. don't have to be repeated on every invocation.

Example:

[quasseltui]
default_server = home

[server:home]
host = irc.example.com
port = 4242
user = linsomniac
password = hunter2
# tls = true              (default; set to false for plain TCP)
# insecure = false        (skip cert verification; self-signed cores)
# cafile = /path/to/ca.pem
# connect_timeout = 10

[server:work]
host = irc.work.example
port = 4242
user = linsomniac

Because the file stores the password, make sure it's readable only by you:

chmod 600 ~/.config/quasseltui/config.ini

With a config in place, three shortcuts become available:

  • quasseltui — connects to default_server.
  • quasseltui <NAME> — connects to [server:<NAME>].
  • quasseltui ui --server <NAME> — same as above, explicit form, and also works with login-only / stream-only / dump-state / probe-only.

Any command-line flag still overrides the corresponding config value.

Development

uv run pytest          # unit tests
uv run ruff check      # lint
uv run ruff format     # format
uv run mypy src        # type-check
uv run lint-imports    # enforce layer boundaries

Project links

Data verified by PyPI on Jun 2, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for jafo from gravatar.com jafo

Credits

Author: Sean Reifschneider

GitHub Statistics

Data verified by PyPI on Jun 2, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

CC0-1.0
View SPDX License List

Requires

Python >=3.11

Tags

chat irc quassel terminal textual tui

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

quasseltui-0.9.1.tar.gz (294.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

quasseltui-0.9.1-py3-none-any.whl (137.9 kB view details)

Uploaded Python 3

File details

Details for the file quasseltui-0.9.1.tar.gz.

File metadata

  • Download URL: quasseltui-0.9.1.tar.gz
  • Upload date:
  • Size: 294.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for quasseltui-0.9.1.tar.gz
Algorithm Hash digest
SHA256 6e1ff141d9a963957c6675377bf0e0d44d3ae15a16aab0250288389c9571b23a
MD5 7bdf0b8928cc24c4b11fe3cefc9947d4
BLAKE2b-256 e4bcd3d4a3bf5fbd2cdff8b0e15de3130784552f1572c8fea74bb45d5356f171

See more details on using hashes here.

Provenance

The following attestation bundles were made for quasseltui-0.9.1.tar.gz:

Publisher: release.yml on linsomniac/quasseltui

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file quasseltui-0.9.1-py3-none-any.whl.

File metadata

  • Download URL: quasseltui-0.9.1-py3-none-any.whl
  • Upload date:
  • Size: 137.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for quasseltui-0.9.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3b6300bf6a13066b14935d1c93f0b4430a413d5773884de5b3cf287730cd17f0
MD5 4d9b2d031612ab7bc05f386836496ab7
BLAKE2b-256 bbcbe7bc0d95387ee2461264956003c13e43bef5c726bb3e3bc05e49e438ab8b

See more details on using hashes here.

Provenance

The following attestation bundles were made for quasseltui-0.9.1-py3-none-any.whl:

Publisher: release.yml on linsomniac/quasseltui

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.9.1 This release

2 files

0.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page