From 67c08343f612a8bad6632d8e15bb8080d2e0125e Mon Sep 17 00:00:00 2001 From: Chaos Rogers Date: Fri, 31 Oct 2025 22:45:22 +0000 Subject: [PATCH 1/2] chore: remove trailing newline from README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2400421..4c6c4d5 100644 --- a/README.md +++ b/README.md @@ -59,4 +59,4 @@ Once configured, you can download media by passing a URL to `jamdl`: ```bash jamdl "https://music.apple.com/us/album/some-album/123456789" -``` +``` \ No newline at end of file From 75bbc3d654e52b5dcf797603d354daceb43578bf Mon Sep 17 00:00:00 2001 From: Chaos Rogers Date: Fri, 31 Oct 2025 22:45:29 +0000 Subject: [PATCH 2/2] docs: add Profiles section with multi-profile config example Co-authored-by: aider (openai/gpt-5) --- README.md | 35 ++++++++++++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 4c6c4d5..10dbd23 100644 --- a/README.md +++ b/README.md @@ -53,10 +53,43 @@ 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`: ```bash jamdl "https://music.apple.com/us/album/some-album/123456789" -``` \ No newline at end of file +```