🖥️ pueue-tui
A terminal UI for monitoring pueue tasks.
Features • Installation • Usage • Keybindings • Compatibility
Tired of running pueue status over and over? pueue-tui gives you a live-updating dashboard for your running, queued, and completed tasks.
Features
- 📊 Live dashboard — auto-refreshing view of all tasks
- ⏱️ Timing info — start time, end time, and duration at a glance
- 🔍 Command preview — select a row to see the full command
- ⌨️ Keyboard shortcuts — quick actions without leaving the terminal
Installation
# Recommended
pipx install pueue-tui
# Or with pip
pip install pueue-tui
Usage
# Start with default 2-second refresh
pueue-tui
# Custom refresh interval
pueue-tui -r 1 # 1 second
pueue-tui -r 5 # 5 seconds
# Show more completed tasks
pueue-tui --completed 20
Keybindings
| Key | Action |
|---|---|
q |
Quit |
r |
Refresh now |
c |
Clean finished tasks |
Compatibility
Tested with pueue v4.x
pueue-tui parses the JSON output from pueue status --json. The JSON structure may differ between major pueue versions. If you encounter issues with a different version, please open an issue.
Requirements
- Python 3.10+
- pueue daemon running
Contributing
Contributions welcome! Feel free to open issues or submit PRs.
License
1 maintainer
Metadata
1 maintainer
Release files for pueue-tui 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pueue_tui-0.1.0.tar.gz | 358.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pueue_tui-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 367.7 kB
Release files / pueue_tui-0.1.0.tar.gz
| Download URL | pueue_tui-0.1.0.tar.gz |
|---|---|
| Size | 358.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f7d4ccf16d16c1d854e7b1f160428bbf41096ff4d0af842fd7259fa9e5fddd28
|
|
BLAKE2b-256 checksum How to use checksums |
480e80f87f94c5ea8b0baebbca65879e1972a0f8a79b5ebd01eb25bf1e2d10fd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.11
|
Release files / pueue_tui-0.1.0-py3-none-any.whl
| Download URL | pueue_tui-0.1.0-py3-none-any.whl |
|---|---|
| Size | 9.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
77bc6c660582885310342fdf8a0e38b5ee0eb764a3695dff87b9f850f03b1256
|
|
BLAKE2b-256 checksum How to use checksums |
2ae2fc784c773c4c924f0f40d1c16ba000ef97d6d0dedca530c8686906f3aad1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.11
|
