FileOrganizer.UI v0.3.0 — Music + Video + Books (Wave 1)
FileOrganizer.UI v0.3.0 — Music + Video + Books pages live (Wave 1)
Three new media-type pages, each backed by a new NDJSON sidecar at the
repo root. Together they take FileOrganizer from "design-asset organizer"
to "well-rounded organizer for any media type".
New live pages
| Page | Sidecar | Pillaged from | What it does |
|---|---|---|---|
| Music | music_run.py |
MusicBrainz Picard + beets chroma plugin |
Existing-tag → MusicBrainz text-search (RapidFuzz ≥ 90) → Chromaprint + AcoustID fingerprint fallback (≥ 0.85) → mutagen tag write → optional beets-style rename like Music/{albumartist}/{year} - {album}/{disc:02}-{track:02} {title}.{ext} |
| Video | video_run.py |
FileBot + Sonarr / Radarr | GuessIt parses each filename, then a Sonarr-style custom-format ladder scores it on resolution + source + video codec + audio codec + size. Three modes: preview, keepers (group by (type, title, year, S/E), mark the highest-scoring file as keeper), rename (move into Movies/{title} ({year})/... or TV/{title}/Season {season:02}/...) |
| Books | books_run.py |
Calibre + Komga / Kavita | EPUB via ebooklib · MOBI / AZW3 via PalmDB header · PDF via pikepdf docinfo + 5-page ISBN scan (regex + ISBN-10/13 checksum validation) · CBZ via ComicInfo.xml. Optional --isbn-lookup enriches missing fields via isbnlib |
New libraries
requirements.txt gains: pyacoustid, musicbrainzngs, guessit,
EbookLib, isbnlib, imagehash, pybktree. Last two are staged for
Wave 2's BK-tree perceptual-hash dedup index.
Music page setup
fpcalc.exe(Chromaprint) — needed for the fingerprint fallback path.
Download from https://acoustid.org/chromaprint, no install needed.
SetFPCALCenv var or drop on PATH.- AcoustID API key — free, register at
https://acoustid.org/api-key. SetACOUSTID_API_KEYor paste into
the page's password box.
Both are only required for the fingerprint fallback path. Existing-tag
and MusicBrainz text-search matches work without them.
Download
FileOrganizer-UI-v0.3.0-win-x64.zip — self-contained Windows x64 build,
~64 MB compressed / ~160 MB extracted. Bundles the WinUI 3 + Windows App
SDK runtime, the Python sidecars, and the fileorganizer/ package.
SHA256: C0296B807DE5AA33C3B2E1D2D8277FFED98CF0B3314430CE6A0DC5C5AC9F4BCF
Sourcing
Pillaged from the OSS landscape per the project's "all OSS licenses are
fine" rule. Source projects: MusicBrainz Picard (GPL-2.0+), beets (MIT),
FileBot (closed since 4.7.x; logic only), Sonarr / Radarr (GPL-3.0),
Calibre (GPL-3.0), Komga + Kavita (MIT / GPL-3.0).
Source
Tag: ui-v0.3.0 · Wave 2 already in motion (Fonts / Source code /
Subtitles / BK-tree dedup / Smart Sort dispatcher).