From bd767eb8bec39fd18713eb426c4f474096cad9e7 Mon Sep 17 00:00:00 2001
From: John Rogers <git@shed.gay>
Date: Sun, 17 Aug 2025 14:54:33 +0100
Subject: [PATCH] docs: update README for Rust application

Co-authored-by: aider (gemini/gemini-2.5-pro-preview-05-06) <aider@aider.chat>
---
 README.md | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 60 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ccc0351..e54b700 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,62 @@
 # jamdl
 
-A shell script to download music using SCDL for soudcloud and gamdl for apple music
\ No newline at end of file
+A command-line tool to download music from various sources like Apple Music, SoundCloud, and others supported by yt-dlp.
+
+## Description
+
+`jamdl` is a wrapper around popular downloaders (`gamdl`, `scdl`, `yt-dlp`) that automates the process of downloading media and transferring it to a specified location, such as a local directory or a remote NAS via SCP.
+
+## Prerequisites
+
+You must have the following command-line tools installed and available in your system's `PATH`:
+- `gamdl` (for Apple Music)
+- `scdl` (for SoundCloud)
+- `yt-dlp` (for other sources)
+
+## Installation
+
+You can install `jamdl` using `cargo`:
+
+### From source
+
+Clone this repository and install using cargo:
+```bash
+cargo install --path .
+```
+
+### From a git repository
+
+You can also install it directly from a git repository:
+```bash
+cargo install --git <repository_url>
+```
+
+## Configuration
+
+The first time you run `jamdl`, it will create a default configuration file at `~/.config/jamdl/config.toml`.
+
+You **must** edit this file to match your setup before you can use `jamdl`.
+
+The configuration file looks like this:
+```toml
+# Default configuration for jamdl
+# Please edit these values to match your setup.
+
+nas_host = "localhost"
+nas_user = "your_ssh_user"
+nas_path = "/path/on/nas"
+cookies_file = "/path/to/your/apple-music-cookies-file.txt"
+```
+
+- `nas_host`: The hostname or IP address of your NAS. If set to `"localhost"`, files will be copied locally instead of using SCP.
+- `nas_user`: The SSH username for your NAS.
+- `nas_path`: The destination path on your NAS or local filesystem.
+- `cookies_file`: The path to your Apple Music cookies file for `gamdl`.
+
+## Usage
+
+Once configured, you can download media by passing a URL to `jamdl`:
+
+```bash
+jamdl "https://music.apple.com/us/album/some-album/123456789"
+```