diff options
| author | Pinapelz <yukais@pinapelz.com> | 2026-09-27 15:38:17 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2026-09-27 15:38:17 -0700 |
| commit | 3d33a8b7bb2494b648fb3f87495fb455c86949aa (patch) | |
| tree | f6df9835fcf2b6d563cb85d5681645df478205f9 /README.md | |
| parent | 0b04663e417fa86b7aa8700684737effa367fcfe (diff) | |
Improve README formatting and add image
Updated README to enhance formatting and clarity.
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 16 |
1 files changed, 5 insertions, 11 deletions
@@ -1,5 +1,9 @@ # expergo -An opinionated music library tool to help you manage your FLACs, compatible with the Snowsky Echo/Mini. +#### An opinionated music library tool to help you manage your FLACs, compatible with the Snowsky Echo/Mini. + +<img width="1920" alt="image" src="https://github.com/user-attachments/assets/6e09e90c-1406-43ef-a1d8-fa99e1c73588" /> + +--- > [!IMPORTANT] > expergo works entirely in the directory you've pointed it to. It can work off of removable storage such as the Snowsky Echo Mini, but be aware that large jobs can take some time (limited by read-write speeds). @@ -55,15 +59,5 @@ What each command does: uv run gui.py [base_dir] ``` -- **Open Folder** scans recursively and lists every FLAC: filename, title, artist, album, album artist, genre and LRC status -- Double-click a cell to edit it. Edited cells are highlighted until you **Save Changes** (Ctrl+S). To edit many rows at once, right-click and choose "Set … for N rows" -- **Apply Echo Rules** runs the full script pipeline above on the selected rows, or on all visible rows if nothing is selected -- The LRC column shows `Missing` (no `.lrc` with the same name) or `Empty` (a lookup found nothing). Tick **Only missing LRC** to filter to those rows, then use **Fetch Missing LRC** to fill them in -- The **Album Art** panel beside the log shows the embedded cover of the highlighted row. **Edit Art** (Ctrl+E) searches MusicBrainz and shows covers from the Cover Art Archive to choose from. You can also pick a local image. The chosen cover is resized to 500x500 and embedded in every selected row, so select a whole album at once -- The **Art** column flags tracks without embedded album art. Tick **Missing art** to filter to them. **Fetch Missing Art** (Ctrl+Shift+E) looks up each album once on MusicBrainz and embeds the best-ranked cover it finds in every track of that album. Tracks without an Album tag are skipped, so use **Edit Art** for those -- The toolbar holds the common actions. The **File / Tracks / Options** menus contain everything, including the "Skip LRC" option and the parallel worker count, which are also in the arrow menu next to **Apply Echo Rules** -- **Add Songs** opens a window where you drop in new FLACs, fix their tags, then copy them into the library (optionally into `Artist/Album/` folders). The rules are applied to the copies unless you untick **Apply Echo rules**, in which case the files are copied as-is with only your tag edits (and LRC unless skipped). The original files are left alone -- **Reorganize** (Ctrl+Shift+O) moves every FLAC in the open folder (with its `.lrc`) into `Artist/Album/` folders. It uses Album Artist when set, so compilations stay together. It shows a preview of every move first. Filenames are kept, clashing files are skipped rather than overwritten, and empty folders can be removed afterwards - # Other Tools `apply_album_art.sh` - Recursively traverse all folders, automatically apply album art and resize to all FLACs that have a JPG/PNG in the same directory |
