This commit is contained in:
2026-10-02 00:11:50 -07:00
parent c28290374f
commit 6f1d839e6a
+15 -46
View File
@@ -4,6 +4,8 @@
Lintunes is 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 if you're worried). FWIW I've been using it for months without major issues. Lintunes is 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 if you're worried). FWIW I've been using it for months without major issues.
A lot of these docs were written by LLM but I've tried to clean them up a bit!!
#### why I did this #### why I did this
I've been a mac user for ~34 years. I gave up daily driving a mac in 2021 but kept my music library in itunes. After 5 years I got tired of my music being solely on my desktop. But I couldn't find anything with all the features of itunes I wanted and also with the ability to import my 26 year old mp3 library. So. I've been a mac user for ~34 years. I gave up daily driving a mac in 2021 but kept my music library in itunes. After 5 years I got tired of my music being solely on my desktop. But I couldn't find anything with all the features of itunes I wanted and also with the ability to import my 26 year old mp3 library. So.
@@ -64,60 +66,26 @@ Fedora, enable [RPM Fusion](https://rpmfusion.org/Configuration), then run
_(written by LLM, cleaned up by me)_ _(written by LLM, cleaned up by me)_
Space play/pause · ←/→ previous/next - Space play/pause · ←/→ previous/next
Ctrl+B column browser · - Ctrl+B column browser
Ctrl+I get info for currently selected track - Ctrl+I get info for currently selected track
Ctrl+L go to current song - Ctrl+L go to current song
Ctrl+O add files - Ctrl+O add files
Ctrl+N new playlist (Ctrl+Alt+N smart, Ctrl+Shift+N folder) - Ctrl+N new playlist (Ctrl+Alt+N smart, Ctrl+Shift+N folder)
Ctrl+Z undo - Ctrl+Z undo
Ctrl+, preferences - Ctrl+, preferences
Ctrl+C/Ctrl+X/Ctrl+V copy/cut/paste tracks - Ctrl+C/Ctrl+X/Ctrl+V copy/cut/paste tracks
click sidebar art for a big art window - click sidebar art for a big art window
# LLM-written docs:
## Importing an existing iTunes library
In iTunes 12.x: **File ▸ Library ▸ Export Library** to get the XML, then:
```sh
lintunes --import-xml "iTunes Library.xml" \
--music-root "/path/to/iTunes Media" \
--data-dir /path/to/library-data --save-config
lintunes # from now on, just run it
```
This brings across your tracks, playlists, playlist folders and smart playlists
(auto-updating and still editable), along with play counts, ratings and dates.
Mac paths are remapped to `--music-root` automatically, including
case/accent differences. Anything it couldn't find is written to
`import_missing_files.txt` in your data dir. Untested on iTunes versions other
than 12.
## Sharing music with friends (Cassette) ## Sharing music with friends (Cassette)
Cassette lets you and a friend peek at each other's libraries and ask for Cassette lets you subscribe to friends' playlists, peek at their libraries and download their songs via a program called **Syncthing**.
songs. There's no server and no account: your two computers talk directly
through a free program called **Syncthing**, and LinTunes just tells Syncthing
what to do. Neither of you can change or delete anything on the other's
computer.
You'll both need LinTunes and Syncthing.
### 1. Install and start Syncthing (once) ### 1. Install and start Syncthing (once)
Open a terminal (see *Quick start* above) and paste the line for Open a terminal and paste the line for your distro:
your distro:
```sh ```sh
sudo apt install syncthing # Debian / Ubuntu / Mint sudo apt install syncthing # Debian / Ubuntu / Mint
@@ -353,6 +321,7 @@ _(written by LLM and cleaned up a bit by me)_
you'd like; those songs arrive in your library by themselves. you'd like; those songs arrive in your library by themselves.
- Follow a friend's playlist and play it right from your own sidebar. - Follow a friend's playlist and play it right from your own sidebar.
\
# BUT WAIT, THERE'S MORE # BUT WAIT, THERE'S MORE