diff --git a/README.md b/README.md index 2400421..10dbd23 100644 --- a/README.md +++ b/README.md @@ -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. - `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 Once configured, you can download media by passing a URL to `jamdl`: