CLI Reference

grabr provides a full-featured command-line interface. Run grabr --help or grabr help to see all available commands.

Commands

`grabr add <url>`

Add a new download job.

bash

grabr add https://example.com/file.zip
grabr add https://example.com/file.zip --output ./videos
grabr add https://example.com/file.zip --chunks 8
grabr add https://example.com/file.zip --name myfile.zip

Options

Flag	Description	Default
--output, -o	Output directory	~/Downloads
--chunks, -c	Number of parallel chunk workers	4
--name, -n	Custom output filename	Auto-detected from URL

`grabr list`

List all download jobs and their statuses.

bash

$ grabr list
 ID          FILENAME        STATUS       PROGRESS         SPEED       ETA
 ——————————— ——————————————— ———————————— ——————————————— ——————————— ————————
 abc123defg  ubuntu-24.04…   DOWNLOADING  42% (512MB…)     12 MB/s     0:42

`grabr pause <id|all>`

Pause active downloads. Use all to pause everything.

bash

grabr pause abc123defg
grabr pause all

`grabr resume <id|all>`

Resume paused or failed downloads.

`grabr remove <id>`

Remove a download job from the queue and disk state.

`grabr clear --completed`

Clear all completed jobs from the database.

`grabr ui`

Open the Web UI dashboard in your default browser. Starts the background daemon automatically if it is not already running.

`grabr daemon [start|stop|status]`

Manage the background server daemon. Grabr features Automatic Daemon Startup, which means the daemon will automatically start in the background when running client command-line instructions if it isn't already active.

bash

grabr daemon start    # Start background server
grabr daemon stop     # Stop background server
grabr daemon status   # Check if daemon is running

Interactive Dashboard

Run grabr without any arguments to open the split-pane interactive full-screen dashboard. It features a responsive layout, automatic version check alerts, live chunk download indicators, and key bindings to manage downloads directly.

text

█▀▀ █▀█ ▄▀█ █▄▄ █▀█  ● Daemon Mode
 █▄█ █▀▄ █▀█ █▄█ █▀▄  Port: 7474 | Version: v1.0.11 | Speed: ↓ 12.4 MB/s (1 active)
 ┌───────────────────────────────────┐┌───────────────────────────────┐
 │ QUEUE LIST (2 jobs)               ││ JOB DETAILS                   │
 │ ▶ ubuntu-24.04.iso [███░░] 60% ↓  ││ ubuntu-24.04.iso              │
 │   node-v22.tar.gz  [█████] 100% ✓ ││ ID: j-abc123def               │
 │                                   ││ Size: 2.1 GB / 3.6 GB         │
 │                                   ││ Speed: ↓ 12.0 MB/s            │
 │                                   ││ ETA: 0:42                     │
 │                                   ││ Parallel Chunks (4 Threads)   │
 │                                   ││ █ █ ▒ ░                       │
 └───────────────────────────────────┘└───────────────────────────────┘

Keyboard Shortcuts

Key	Action
q	Quit interactive dashboard
a	Open inline form to add a new download job (with YouTube formats support)
p	Pause downloading of the selected job
r	Resume downloading of the selected job (or retry failed ones)
x	Remove the selected job from the queue (opens confirmation dialog)
c	Clear all completed jobs from the queue database
Enter	Open output destination directory of the selected job in system file manager
o	Open Web UI dashboard in default browser (starts daemon if stopped)
↑/↓	Navigate selector cursor between jobs in the queue list