CLI Reference

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

Commands

`grabr add <url>`

Add a new download job.

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.

$ 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.

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 daemon if not running.

`grabr daemon [start|stop|status]`

Manage the background server daemon.

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 full-screen terminal dashboard with live progress tracking and keyboard shortcuts.

+- grabr ------------------------------------------------+
|                                                        |
|  ubuntu-24.04.iso                     84%  ↓ 12 MB/s   |
|  [====================----]  ETA 0:42                  |
|                                                        |
|  node-v22-linux.tar.gz                100%  ✓          |
|  [========================]  4.2 GB                    |
|                                                        |
|  q quit  p pause  r resume  ↑↓ navigate                |
+--------------------------------------------------------+

Keyboard Shortcuts

Key	Action
`q`	Quit dashboard
`p`	Pause selected job
`r`	Resume selected job
`x`	Remove selected job
`↑↓`	Navigate between jobs