Nomad Media CLI
Command-line interface for managing assets, metadata, and workflows in Nomad Media.
Nomad Media CLI
The Nomad Media CLI is a Python-based command-line tool for managing assets, metadata, and workflows in your Nomad Media environment. It provides direct access to asset storage, bucket management, metadata tagging, and advanced media operations from the terminal.
Prerequisites
- Python installed in your environment
- pip package manager
Quick Start
bash
Install
pip install nomad-media-cli
Initialize (run once)
nomad-media-cli init --service-api-url https://your-api.example.com --username [email protected] --password yourpassword
List buckets
nomad-media-cli list-buckets
Set default bucket
nomad-media-cli set-default-bucket --bucket my-bucket
List assets
nomad-media-cli list-assets --url my-bucket::media/
Command Groups
| Group | Description |
|---|---|
| Installation & Configuration | Install, initialize, and configure the CLI |
| Asset Management | Upload, download, list, sync, and delete assets |
| Metadata Commands | Manage tags, collections, related content, and properties |
| Advanced Commands | Clip, archive, annotate, share, transcribe, and more |
Asset Identification
All asset commands accept assets by ID, Nomad Media URL, or object-key:
- --id: Asset ID — takes precedence over all other identifiers.
- --url: Full Nomad Media URL in the form bucket-name::object-key. Case-sensitive; folders must end with /.
- --object-key: Object-key only — requires the default bucket to be set with set-default-bucket first.
Configuration File Locations
The CLI stores configuration locally. Use list-config-path to find the exact path on your system.
| Platform | Default Path |
|---|---|
| Windows | %APPDATA%\Local\nomad_media_cli\config.json |
| Linux | ~/.config/nomad_media_cli/config.json |
| Mac | ~/Library/Application Support/nomad_media_cli/config.json |
Use --config-path to specify a custom configuration location.