CLI Commands Reference
Detailed reference for all CLI commands.
Command: process-new-media
Processes new media files from download directories.
Options
| Option | Description |
|---|---|
--dry-run |
Preview changes without executing |
--media-type TYPE |
Process specific type (music/book/comic) |
--verbose |
Enable verbose output |
Examples
# Process all new media
./run.sh process-new-media
# Preview without executing
./run.sh process-new-media --dry-run
# Process only music
./run.sh process-new-media --media-type music
Command: organize
Opens interactive organization menu.
Command: interactive
Opens full interactive menu with all operations.
Command: music-genre-backfill
Fixes genres in the database.
Options
| Option | Description |
|---|---|
--execute |
Apply changes (default is preview) |
--dry-run |
Preview changes |
Command: suggest-filenames
Generates filename improvement suggestions.
Command: apply-filename-suggestions
Applies filename suggestions.
Options
| Option | Description |
|---|---|
--execute |
Apply changes (default is preview) |
--dry-run |
Preview changes |
Command: navidrome-test
Tests Navidrome connection.
Command: navidrome-sync-simple
Syncs playlists to Navidrome.
Options
| Option | Description |
|---|---|
--genre TEXT |
Filter by genre |
--year YEAR |
Filter by year |
--artist TEXT |
Filter by artist |
--playlist-name NAME |
Target playlist name |
Examples
# Sync all rock music
./run.sh navidrome-sync-simple --genre="Rock"
# Sync 2024 releases
./run.sh navidrome-sync-simple --year=2024
Command: stats
Shows organization statistics.
Options
| Option | Description |
|---|---|
--genre-quality |
Show genre quality report |
Command: backup-integrity
Verifies backup integrity.
Options
| Option | Description |
|---|---|
--cleanup |
Remove old backups |
Command: test
Runs the test suite.