Aria2TUI is a download management tool. It acts as a TUI client for the aria2c download utility, facilitating bulk downloading, torrenting, queue control, the fine-tuning of download options (e.g., piece length, user-agent, max speed, etc.), downloading via proxy, and much more.
Aria2tui communicates with an aria2c daemon over RPC. The UI is provided by my TUI picker listpick.
aria2tui-demo-2025-08_720p.mp4
Install aria2tui using pip:
python -m pip install aria2tuiWhen you run aria2tui for the first time it will bring up a config creation form with the defaults pre-set. This creates a config file in ~/.config/aria2tui/config.toml when you click save. Just enter your url, port, and token into the form and you are good to go.
aria2tui- See the wiki, which covers basic usage.
- Make sure that you have aria2c installed and configured with RPC enabled.
- Press
?in aria2tui to see the help page which will list the available keybinds. Ctrl-lwill redraw the screen; useful if there are stray artifacts after dropping to the shell- Switch between open aria2tui instances with
{and} - Toggle the right-pane with
'and cycle between right-pane views with".
By default, the cursor follows the selected download task. If you're viewing an active download that completes and moves to the bottom of the list, the cursor moves with it.
For scenarios where you want the cursor to stay at a fixed position (e.g., watching active downloads at the top), you can enable pin cursor mode:
- Press
`and typepcto toggle pin cursor mode - Alternatively, press
~to open settings and select the pin cursor option - A pin symbol (📌) in the footer indicates which tracking mode is active
When performing bulk operations on rapidly changing downloads (e.g., hundreds of images transitioning from active/waiting to completed), it's recommended to disable auto-refresh to maintain data integrity during selection. To toggle auto-refresh:
- Press
~and toggle the auto-refresh option
- Aria2TUI was made to work on UNIX systems.
- Changing download options for a task that is in progress--whether active or paused--will most likely restart the download (!!).
yazifor selecting torrent files.nvimfor viewing/editing download options as well as adding URIs, magnet links and torrent filescursesfor controlling the terminal display- listpick for the terminal user-interface
- plotille for graphs
- pyperclip for clipboard access
- Ariang A web client for aria2c
Feel free to request features. Please report any errors you encounter with appropriate context.