docs: add Profiles section with multi-profile config example

Co-authored-by: aider (openai/gpt-5) <aider@aider.chat>
This commit is contained in:
Chaos Rogers 2025-10-31 22:45:29 +00:00
parent 67c08343f6
commit 75bbc3d654

View file

@ -53,6 +53,39 @@ cookies_file = "/path/to/your/apple-music-cookies-file.txt"
- `nas_path`: The destination path on your NAS or local filesystem. - `nas_path`: The destination path on your NAS or local filesystem.
- `cookies_file`: The path to your Apple Music cookies file for `gamdl`. - `cookies_file`: The path to your Apple Music cookies file for `gamdl`.
## Profiles
`jamdl` supports multiple profiles so you can target different destinations (NAS paths, hosts, or local folders) without editing the config each time. Profiles live under a top-level `[profiles]` table. The profile named `default` is used when no `--profile` is specified.
Example multi-profile configuration:
```toml
# Multi-profile configuration for jamdl
[profiles.default]
nas_host = "localhost"
nas_user = "your_ssh_user"
nas_path = "/path/on/nas"
cookies_file = "/path/to/your/apple-music-cookies-file.txt"
[profiles.work]
nas_host = "work-nas"
nas_user = "alice"
nas_path = "/srv/media/music"
cookies_file = "/home/alice/apple-cookies.txt"
[profiles.laptop]
nas_host = "localhost"
nas_user = "your_ssh_user"
nas_path = "/Users/you/Music"
cookies_file = "/Users/you/cookies.txt"
```
- Choose a profile when running `jamdl`:
- `jamdl --profile work "https://music.apple.com/us/album/some-album/123456789"`
- Short form: `jamdl -p work "https://music.apple.com/us/album/some-album/123456789"`
- If the requested profile is missing, `jamdl` falls back to `default` and lists available profiles.
- Backwards compatibility: legacy single-profile configs (top-level keys without `[profiles]`) are still supported.
## Usage ## Usage
Once configured, you can download media by passing a URL to `jamdl`: Once configured, you can download media by passing a URL to `jamdl`: