trav
7e8266c14c
Auto-populating, criteria-driven playlists that import faithfully from iTunes. - lintunes/smart.py: recursive SmartCriteria/SmartGroup/SmartRule/SmartLimit model (JSON round-tripping), a shared FIELD_REGISTRY used by both the evaluator and the editor, and evaluate() (match all/any, nested groups, string/int/duration/rating/date/bool ops, "in the last N", limit by items/time/size). Null play/skip dates are treated as the distant past, matching iTunes. - iTunes import via a vendored MIT-licensed binary parser (lintunes/itunes_smart/, from cvzi/itunes_smartplaylist). Nested groups parse and evaluate; blobs we can't represent (MediaKind/iCloud/etc.) flag unsupported and keep the imported snapshot. "loved" is dropped per user pref. - library_manager: create/set/recompute smart playlists (undoable), field-scoped coalesced live recompute hooked into the edit/play/skip/add funnels, a no-op equality guard to avoid Syncthing churn, and manual-edit guards. main.py recomputes on load; conflict_resolver keeps newest criteria for smart lists. - GUI: ❧ glyph painted in the sidebar branch column, read-only track table for smart playlists, New/Edit Smart Playlist menus, and SmartPlaylistEditorDialog (per-field rule rows, match all/any, limits, live updating). Tests: tests/test_round14.py (real captured blobs in tests/smart_blobs.json). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
LinTunes
[screenshot]
an mp3 library manager and player for linux. Absolutely no guarantees, if it wrecks your itunes library or wipes your harddrive that's on you (maybe just have your LLM of choice review the software for bugs and vulns?).
Features
- can import an iTunes 12 (untested on other versions) library
How it works
- Your music files are never moved or rewritten (except when you edit tags).
- The library lives as plain JSON files (
library.json+ one file per playlist) in a directory you choose — designed to be synced with Syncthing; sync conflicts are merged automatically on startup (play counts take the max, edits take the newest, playlists take the union). - Playback via Qt Multimedia/FFmpeg (mp3, m4a, flac). Media keys work through MPRIS. Scrobbling to last.fm is optional (Edit → Preferences).
Why
I have been a mac user for ~34 years. I gave up daily driving mac os in 2020. I figured Apple
but my music library even some tracks I got from napster all the way back in 2000 (I have since paid for!!)
Quickstart
pip install -e . # PyQt6, mutagen, numpy, requests
# one-time import from iTunes (XML from iTunes 12.x: File > Library > Export Library)
lintunes --import-xml "iTunes Library.xml" \
--music-root "/path/to/iTunes Media" \
--data-dir /path/to/library-data --save-config
lintunes # run the app
Running it
The lintunes command only exists after pip install -e ., and it lives in
~/.local/bin, so that has to be on your PATH (it is by default on most
distros). If lintunes isn't found, you can always run it straight from this
checkout without installing — from the project directory:
python3 -m lintunes.main # same thing the desktop launcher runs
Fedora/Debian note: you need the FFmpeg codecs for Qt Multimedia
(qt6-qtmultimedia with ffmpeg, usually via RPM Fusion / regular apt).
LinTunes looks best with Century Gothic installed (~/.local/share/fonts/);
if it's missing, you'll be asked to pick a font on first run.
Keys
Space play/pause · ←/→ previous/next · Ctrl+B column browser · Ctrl+I get info · Ctrl+, preferences · Ctrl+C/Ctrl+X/Ctrl+V copy/cut/paste tracks · double-click sidebar art for a big art window
App icon
packaging/install-desktop.sh installs the launcher entry and icon for your
user (lets you pin LinTunes to the GNOME dash). The icon is just a file —
replace packaging/lintunes.png (256×256 PNG) and re-run the script to use
your own. GNOME caches icons, so if the old one lingers, log out and back in.
Unpinning from the dash does not uninstall LinTunes — it's still in the GNOME app grid (open Activities and search "LinTunes"). Right-click it there → Pin to Dash to get it back.
Development
python3 -m pytest tests/
spec.md is the original design brief; tasks*.md track what's built.