Skip to content

FileOrganizer.UI v0.3.0 — Music + Video + Books (Wave 1)

Choose a tag to compare

@SysAdminDoc SysAdminDoc released this 01 May 00:26
· 259 commits to main since this release

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.
    Set FPCALC env var or drop on PATH.
  • AcoustID API key — free, register at
    https://acoustid.org/api-key. Set ACOUSTID_API_KEY or 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).