From 82e52a896786882990765d59b88fffb2fefecb50 Mon Sep 17 00:00:00 2001
From: aadit <aadit@noreply.localhost>
Date: Wed, 22 Oct 2025 01:28:00 +0530
Subject: [PATCH] Add README.md

---
 README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..23f1515
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# Audio Downloader & Tagger
+
+Download YouTube playlists and tag audio files with metadata and cover art.
+
+## Installation
+
+```bash
+pip install -r requirements.txt
+brew install yt-dlp ffmpeg  # macOS
+# or: sudo apt-get install yt-dlp ffmpeg  # Ubuntu
+```
+
+## Usage
+
+### Download a playlist
+
+```bash
+python downloader.py
+```
+
+Prompts for: playlist URL, album, artist, output folder, disc number, track start, workers.
+
+### Tag audio files
+
+```bash
+python tagger.py
+```
+
+Prompts for: folder path, album, artist, disc number, track start, cover filename.
+
+## Features
+
+- Parallel downloads & tagging
+- Converts to Opus format
+- Embeds metadata & cover art
+- Vorbis comment tags (standard)
+
+## Supported Formats
+
+**Download:** .opus, .ogg  
+**Tag:** .opus, .ogg
+
+## Requirements
+
+- Python 3.8+
+- yt-dlp, ffmpeg (system)
+- mutagen, joblib (Python)
\ No newline at end of file