Trav
2af0d91a76
Cut (Ctrl-X) marks the selection on the clipboard with a `cut` flag; a paste of a cut from a real playlist is a *move* (single-undo across playlists via move_tracks_between_playlists; same-playlist reorders), while a copy — or a cut from the library, which has nothing to remove — just adds. Paste now inserts *above the selected track* rather than appending. Cut/Paste added to the track context menu; parse_tracks_mime now tolerates a None/empty clipboard. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
93 lines
2.9 KiB
Markdown
93 lines
2.9 KiB
Markdown
# 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](https://syncthing.net); 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
|
||
|
||
```sh
|
||
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:
|
||
|
||
```sh
|
||
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
|
||
|
||
```sh
|
||
python3 -m pytest tests/
|
||
```
|
||
|
||
`spec.md` is the original design brief; `tasks*.md` track what's built.
|