Metadata-Version: 2.4
Name: deadwax
Version: 0.0.1
Summary: A media library that lives in markdown. Notes etched next to the music.
Project-URL: Homepage, https://github.com/leolorenzomusic/deadwax
Author: Leo Music
License-Expression: MIT
License-File: LICENSE
Keywords: catalog,library,markdown,music,obsidian
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.11
Requires-Dist: jinja2
Requires-Dist: mutagen
Requires-Dist: pyyaml
Requires-Dist: yt-dlp
Description-Content-Type: text/markdown

# deadwax

*Notes etched next to the music.*

A media library that lives in markdown. Point deadwax at audio — a URL or a folder you already own — and it maintains a vault: one note per track with typed frontmatter, artist index notes with wikilinks, album indexes, a dashboard. Obsidian-native, but plain markdown, so it works anywhere.

No database. No cache. The notes are the library.

**Status: pre-alpha.** All commands work; the format may still shift before 0.1.

## Commands

```
deadwax init            # create deadwax.toml + vault dirs here
deadwax add <url>       # ingest via yt-dlp, write note + sidecars
deadwax <url>           # same as add
deadwax scan <dir>      # catalog an existing folder of audio
deadwax sync            # rebuild artist notes, indexes, dashboard
deadwax rm <query>      # remove a track (note + media)
deadwax open <query>    # open the closest-matching note
```

## License

MIT
