Skip to content
rustbunkerPublic
forked from peymanAzad/ario

About

A batteries-included terminal download manager powered by aria2.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Β 
Β 

Latest commit

Β 

History

99 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Ario

A batteries-included terminal download manager powered by aria2.

CI License: MIT Built with Rust Built with Ratatui Powered by aria2

Ario demo showing download queues, scheduling, and clipboard imports

Like the look of the demo? Set theme = "catppuccin-frappe" in tui.toml.

Why Ario? Β· Features Β· Installation Β· Quick start Β· Configuration Β· Controls Β· Contributing Β· License

Why Ario?

Ario combines aria2 with a managed daemon, scheduled queues, and batch clipboard import in one terminal workflow. It offers a terminal alternative to web front-ends like AriaNg, supports HTTP/HTTPS alongside BitTorrent, and keeps downloads and schedules running after you close the interface. The TUI and daemon can also run on separate machines, connected through an SSH tunnel.

✨ Features

  • πŸŒ™ No extra window babysitting your downloads β€” Close the TUI and get on with your work. The separate daemon keeps your downloads and scheduled queues running in the background.
  • πŸ—“οΈ Download on your schedule β€” Set one-time, daily, or weekly download windows, including overnight schedules with automatic start and stop times.
  • 🧲 HTTP downloads and BitTorrent β€” Manage HTTP/HTTPS downloads, magnet links, and .torrent files in one interface.
  • πŸŽ›οΈ Your queues, your settings β€” Prioritize downloads within each queue and control concurrency, connections, retries, file allocation, and piece selection. Set queue defaults and override them for individual downloads.
  • πŸ¦€ Built for the terminal β€” Written in Rust with Ratatui, with keyboard shortcuts and mouse support.
  • πŸ“‹ Batch imports from your clipboard β€” Copy text containing download links and press v. Ario automatically finds HTTP/HTTPS URLs and magnet links, then lets you select items, choose a queue, and start downloading immediately or save them for later.
  • πŸ—‚οΈ Automatic file organization β€” Automatically categorize downloads by file type and save them to configurable folders.
  • 🎨 Make it yours β€” Choose Catppuccin themes or custom colors, and select Nerd Font, Unicode, or ASCII icons. Configure the server address, automatic daemon startup, and daemon behavior when you exit.

πŸ“¦ Installation

Every installation includes both ario (the TUI) and ario_daemon. Prebuilt packages do not require Rust.

Prerequisites

  • Nerd Font β€” Optional, but strongly recommended for displaying Ario's default icons correctly. Select a Nerd Font in your terminal's font settings.

For terminals without a Nerd Font, launch with ario --glyphs=unicode.

Linux (x86_64)

Linux release binaries require glibc 2.35 or newer. Download packages from GitHub Releases.

Debian and Ubuntu

Download ario_0.1.0-1_amd64.deb, then run this command in the download directory:

sudo apt install ./ario_0.1.0-1_amd64.deb

APT installs aria2 and the other required dependencies.

Fedora and other RPM-based distributions

Download ario-0.1.0-1.x86_64.rpm, then install it with DNF:

sudo dnf install ./ario-0.1.0-1.x86_64.rpm

DNF installs aria2 and the other required dependencies from your configured repositories. Use your distribution's package manager if it does not use DNF.

Arch Linux

For releases that include an Arch package, download ario-download-bin-<version>-1-x86_64.pkg.tar.zst from GitHub Releases, then run:

sudo pacman -U ./ario-download-bin-*-x86_64.pkg.tar.zst

Pacman installs aria2 and the other required dependencies. The package is named ario-download-bin; launch it with ario. It conflicts with Arch's unrelated ario music player because both install /usr/bin/ario.

To upgrade, install the newer package with pacman -U. This package is not currently published to the AUR.

Other Linux distributions

The archive does not install aria2 automatically. Install aria2 with your distribution's package manager and make sure aria2c is in your PATH. Download the Linux x86_64 archive, then extract and install both executables:

tar -xzf ario-x86_64-unknown-linux-gnu.tar.gz
sudo install -d /usr/local/bin
sudo install -m 755 ario-x86_64-unknown-linux-gnu/ario \
  ario-x86_64-unknown-linux-gnu/ario_daemon /usr/local/bin/

Make sure /usr/local/bin is in your PATH.

macOS (Apple Silicon and Intel)

Install Homebrew, then run:

brew install peymanAzad/tap/ario

Homebrew selects the binary for your Mac and installs aria2 automatically.

Windows (x64)

The ZIP does not install aria2 automatically.

  1. Install aria2 using WinGet:

    winget install --id aria2.aria2 --exact
  2. Download the Windows x64 ZIP and extract it to a permanent location.

  3. Add the directory containing both ario.exe and ario_daemon.exe to your user Path environment variable. Keep the two executables together.

  4. Open a new terminal so the updated Path takes effect, then run ario. Make sure aria2c is also available in that terminal.

Cargo (all platforms)

Install Rust and Cargo 1.95 or newer using rustup. Cargo and source installations do not install aria2 automatically; install it separately so that aria2c is in your PATH.

Install the published ario crate:

cargo install ario --locked

Or build and install from this repository:

git clone https://github.com/peymanAzad/ario.git
cd ario
cargo install --locked --path .

Both commands install ario and ario_daemon. Make sure Cargo's executable directory, usually ~/.cargo/bin on Linux/macOS or %USERPROFILE%\.cargo\bin on Windows, is in your PATH.

πŸš€ Quick start

  1. Launch Ario:

    ario

    The local daemon and aria2 start automatically with the default configuration.

  2. Add your first download: Copy one or more HTTP/HTTPS URLs or magnet links, then press v in Ario. Use ↑ / ↓ to navigate the detected links and Space to select or deselect them.

  3. Choose a queue and start: Use ← / β†’ to choose the destination queue. Press s to start the selected downloads immediately, or w to save them for later.

  4. Leave downloads running: Press q from the main screen to close the TUI. By default, the daemon stays running while downloads are active or scheduled queues are enabled. Run ario again to reconnect.

To add a local .torrent file, press a from the main screen, enter its path, press Enter to confirm, then s to start.

Press ? from the main screen to view keyboard shortcuts.

πŸ”§ Configuration

Ario creates server.toml and tui.toml automatically on first launch. Both files live in your configuration directory:

Platform Directory
Linux $XDG_CONFIG_HOME/ario/, or ~/.config/ario/
macOS ~/Library/Application Support/ario/
Windows %APPDATA%\ario\config\

The blocks below contain the default settings. Optional values are shown as commented examples.

Daemon β€” server.toml

[settings]
default_download_location = "~/Downloads"

# Reserved settings; currently have no effect.
# Configure exit behavior in tui.toml under [on-app-exit].
start_daemon_on_login = false
stop_daemon_on_close = false

[settings.category_locations]
Video = "~/Downloads/Videos"
Music = "~/Downloads/Musics"
Document = "~/Downloads/Documents"
Archive = "~/Downloads/Compressed"
Program = "~/Downloads/Programs"

# Extensions are listed without a leading dot.
# Unrecognized file types use the default download location.
[settings.category_extensions]
Video = [
    "mp4", "mkv", "avi", "mov", "webm", "flv", "m4v", "wmv",
    "mpg", "mpeg", "m2v", "3gp", "3g2", "ogv", "ts", "mts",
    "m2ts", "vob", "asf",
]
Music = [
    "mp3", "flac", "wav", "aac", "ogg", "m4a", "opus", "wma",
    "aiff", "aif", "alac", "ape", "amr", "oga", "mka", "mid", "midi",
]
Document = [
    "pdf", "doc", "docx", "txt", "epub", "odt", "rtf", "xls",
    "xlsx", "ods", "csv", "ppt", "pptx", "odp", "html", "htm",
    "md", "tex", "mobi", "azw", "azw3", "djvu",
]
Archive = [
    "zip", "zipx", "rar", "7z", "tar", "gz", "xz", "bz2",
    "tgz", "tbz", "tbz2", "txz", "zst", "cab", "iso",
]
Program = [
    "exe", "msi", "apk", "deb", "rpm", "app", "dmg", "pkg",
    "bin", "run", "com", "jar", "appimage", "ipa", "appx",
    "msix", "msixbundle", "flatpak", "snap", "sh", "bat", "cmd", "ps1",
]

# Reserved proxy configuration; currently not applied to downloads.
# Optional fields are unset by default.
[settings.proxy]
enabled = false
# host = "127.0.0.1"
# port = 8080
# username = "username"
# password = "password"

[aria2]
# Executable name from PATH, or a full path to aria2c.
binary_path = "aria2c"

# Internal aria2 RPC port, separate from Ario's server port (47812).
rpc_port = 6800

# Initial directory passed to aria2.
# Ario routes downloads using the locations under [settings].
download_dir = "~/Downloads"

TUI β€” tui.toml

server_url = "http://127.0.0.1:47812"

# Start and supervise the daemon automatically for a local HTTP address.
# Set to false if you manage the daemon yourself.
auto_start_server = true

# Empty: look for ario_daemon beside the TUI executable, then in PATH.
# Set a full path to use a different executable.
server_binary = ""

mouse_enabled = true

# Choices: "default", "catppuccin-latte", "catppuccin-frappe",
# "catppuccin-macchiato", "catppuccin-mocha".
theme = "default"

# Choices: "nerd", "unicode", "ascii".
# Unset by default: UTF-8 locales use Nerd Font icons; others use ASCII.
# The --glyphs command-line option overrides this setting.
# glyph_mode = "unicode"

[on-app-exit]
# Applies to the TUI-managed daemon; manually started daemons stay running.
# "when_idle": stop only when no downloads are active and no schedules are enabled.
# "never": keep running after the TUI exits.
# "always": stop even when downloads are active.
stop_managed_daemon = "when_idle"

[custom_theme]
# No overrides by default; colors inherit the selected theme.
# Uncomment any example below to override it with a six-digit hex color.
# foreground = "#cdd6f4"
# border = "#6c7086"
# border_focused = "#89b4fa"
# selected_bg = "#313244"
# selected_fg = "#cdd6f4"
# status_ok = "#a6e3a1"
# status_error = "#f38ba8"
# status_warning = "#f9e2af"
# text_muted = "#a6adc8"
# accent = "#cba6f7"

Restart the TUI after changing tui.toml. Changes to server.toml require restarting the daemon; reopening the TUI alone may reconnect to the existing daemon.

🧭 Controls

Use keyboard shortcuts or the mouse to navigate Ario. The footer shows available actions for your current selection.

Press ? or click Help from the main screen for the full keyboard reference. Mouse support is enabled by default and can be disabled in tui.toml.

🀝 Contributing

Bug reports, feature requests, documentation improvements, and pull requests are welcome.

For larger changes, open an issue first to discuss your approach. When submitting a pull request, describe what changed, why, and how you tested it.

πŸ“„ License

Ario is licensed under the MIT License. See LICENSE for details.

About

A batteries-included terminal download manager powered by aria2.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages