docs

README.md

@@ -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.
 
+A lot of these docs were written by LLM but I've tried to clean them up a bit!!
+
 #### 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.
@@ -64,60 +66,26 @@ Fedora, enable [RPM Fusion](https://rpmfusion.org/Configuration), then run
 
 _(written by LLM, cleaned up by me)_
 
-Space play/pause · ←/→ previous/next
-Ctrl+B column browser ·
-Ctrl+I get info for currently selected track
-Ctrl+L go to current song
-Ctrl+O add files
-Ctrl+N new playlist (Ctrl+Alt+N smart, Ctrl+Shift+N folder)
-Ctrl+Z undo
-Ctrl+, preferences
-Ctrl+C/Ctrl+X/Ctrl+V copy/cut/paste tracks
-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.
-
-
+- Space play/pause · ←/→ previous/next
+- Ctrl+B column browser
+- Ctrl+I get info for currently selected track
+- Ctrl+L go to current song
+- Ctrl+O add files
+- Ctrl+N new playlist (Ctrl+Alt+N smart, Ctrl+Shift+N folder)
+- Ctrl+Z undo
+- Ctrl+, preferences
+- Ctrl+C/Ctrl+X/Ctrl+V copy/cut/paste tracks
+- click sidebar art for a big art window
 
 
 
 ## Sharing music with friends (Cassette)
 
-Cassette lets you and a friend peek at each other's libraries and ask for
-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.
+Cassette lets you subscribe to friends' playlists, peek at their libraries and download their songs via a program called **Syncthing**.
 
 ### 1. Install and start Syncthing (once)
 
-Open a terminal (see *Quick start* above) and paste the line for
-your distro:
+Open a terminal and paste the line for your distro:
 
 ```sh
 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.
 - Follow a friend's playlist and play it right from your own sidebar.
 
+\
 
 
 # BUT WAIT, THERE'S MORE