Readme and script added

README.md

@@ -1,2 +1,63 @@
 # filmarkivet-dl
-Downloads all videos from a given category page on filmarkivet.se using svtplay-dl.
+
+Downloads all videos from a given category page on [filmarkivet.se](https://www.filmarkivet.se/) using [svtplay-dl](https://github.com/spaam/svtplay-dl).
+
+Automatically paginates through all category pages, deduplicates URLs, and supports resuming interrupted sessions via a seen-file.
+
+## Requirements
+
+- Python 3.10+
+- [svtplay-dl](https://github.com/spaam/svtplay-dl) installed and available in `PATH`
+
+## Usage
+
+```bash
+python3 filmarkivet-dl.py
+```
+
+By default this downloads all videos from the [reklamfilm](https://www.filmarkivet.se/category/reklamfilm/) category.
+
+### Options
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--start-url URL` | `https://www.filmarkivet.se/category/reklamfilm/` | Category page to start from |
+| `--sleep SECONDS` | `0.5` | Delay between downloads |
+| `--page-sleep SECONDS` | `0.2` | Delay between page fetches |
+| `--max-pages N` | `0` (no limit) | Stop after N pages |
+| `--seen-file PATH` | `seen_urls.txt` | File tracking already-processed URLs |
+| `--output-dir DIR` | `downloads` | Directory to save downloaded videos in |
+| `--dry-run` | — | Print commands without running svtplay-dl |
+
+### Examples
+
+Preview what would be downloaded without actually downloading:
+
+```bash
+python3 filmarkivet-dl.py --dry-run
+```
+
+Download from a different category:
+
+```bash
+python3 filmarkivet-dl.py --start-url "https://www.filmarkivet.se/category/dokumentar/"
+```
+
+Save videos into a subdirectory:
+
+```bash
+python3 filmarkivet-dl.py --output-dir reklamfilm
+```
+
+Limit to the first 3 pages with a 2-second delay between downloads:
+
+```bash
+python3 filmarkivet-dl.py --max-pages 3 --sleep 2.0
+```
+
+## How it works
+
+1. Fetches the category page HTML and extracts all `/movies/` links.
+2. Detects the "next page" link via `rel="next"`, CSS class, or link text ("Nästa" / "Next").
+3. For each new video URL, runs `svtplay-dl -S <url>` to download all available subtitles and the best quality stream.
+4. Records processed URLs in `seen_urls.txt` so re-running the script skips already-downloaded videos.