feat: add tag script

Author: egvimo

pyproject.toml

@@ -12,6 +12,7 @@ dependencies = [
     "markdownify==1.2.3",
     "requests==2.34.2",
     "feedparser==6.0.14",
+    "mutagen>=1.48.1",
 ]
 
 [dependency-groups]

scripts/tag.py

@@ -0,0 +1,42 @@
+from pathlib import Path
+from mutagen.oggopus import OggOpus
+import re
+
+files = sorted(Path("/path/to/files").glob("*.opus"))
+
+current_book = None
+chapter_counter = 0
+
+for file in files:
+    stem = file.stem
+
+    # Match filenames like:
+    # 11_002_Chapter 2_Some Chapter Title
+    # 12_045_Chapter 45_Other Chapter Title
+    #
+    # but NOT:
+    # 11_003_Chapter 3
+
+    m = re.match(r'^\d+_\d+_Chapter \d+_(.+)$', stem)
+
+    if m:
+        current_book = m.group(1).strip()
+        chapter_counter = 1
+    else:
+        chapter_counter += 1
+
+    if not current_book:
+        print(f"Skipping {file.name} (no chapter book yet)")
+        continue
+
+    title = f"{current_book} - {chapter_counter:02d}"
+
+    try:
+        audio = OggOpus(file)
+        audio["TITLE"] = [title]
+        audio.save()
+
+        print(f"{file.name} -> {title}")
+
+    except Exception as e:
+        print(f"ERROR {file.name}: {e}")