This is for a person with a real Mac, testing a LinTunes build from start
to finish. Use test music only: a few albums you don't mind being
retagged, moved or trashed. Don't point LinTunes at a music collection
you'd miss.
Mark every line ✓ (works), ✗ (broken, and say what happened), or
– (skipped, and say why). A screenshot helps whenever something looks
wrong (⇧⌘4 selects an area). Send back the whole file.
Tester
Date
LinTunes version (bottom-left corner)
Download (AppleSilicon / Intel .dmg)
Mac model, chip
macOS version
Speakers / Chromecast / AirPlay devices available
To see the app's log, quit LinTunes and start it from Terminal instead:
/Applications/LinTunes.app/Contents/MacOS/LinTunes. Copy whatever it
prints around a failure into the notes.
1. Download and install
#
Step
Expect
Result / notes
1.1
Download the .dmg for this Mac, and SHA256SUMS
1.2
shasum -a 256 -c SHA256SUMS --ignore-missing in Downloads
…dmg: OK
1.3
Open the .dmg
A window with LinTunes and an Applications shortcut
1.4
Drag LinTunes to Applications, then eject
Copies, no errors
1.5
Double-click LinTunes in Applications
macOS refuses: "LinTunes" Not Opened. Note the exact wording.
1.6
System Settings › Privacy & Security › Security ›Open Anyway, then your password
LinTunes opens
1.7
Quit, and open it again from Launchpad/Spotlight
Opens with no warning
1.8
Get Info on the app in Finder
Version matches, the lint-ball icon, size noted: ____ MB
1.9
The Dock icon and the ⌘-Tab icon
The lint-ball icon, not a generic Python one
1.10
The app menu (left of File)
Says LinTunes, not "Python"
2. First run and library setup
#
Step
Expect
Result / notes
2.1
First launch
The window appears. A library is created in ~/Music/LinTunes. You're asked where the music should go.
2.2
Choose a music folder
Accepted. Nothing is copied yet.
2.3
Look in ~/Library/Application Support/LinTunes
config.json exists
2.4
Quit and relaunch
Same library, no questions this time
2.5
Window: resize, minimize, full screen (green button), zoom
Behaves like a Mac window. Corners and title bar look right in light and dark.
2.6
System Settings › Appearance › Dark, then Light
LinTunes follows, or keeps its own theme setting. Note which.
2.7
Menu bar: File, Edit, Controls, View, Track, Connections
Present. Preferences…/Settings… is in the LinTunes menu (⌘,). Quit LinTunes is there too (⌘Q).
2.8
Keyboard shortcuts use ⌘ (⌘O, ⌘I, ⌘Z, ⌘B, ⌘L, ⌘N)
Each one works
2.9
Connections menu
No Rabbit / andTunes / Shazam entries
3. Importing
#
Step
Expect
Result / notes
3.1
Drag a folder of songs into the window
Copied into the music folder, filed as Artist/Album
3.2
File › Add Files to Library… (⌘O)
The file picker opens, and the files are added
3.3
Drop an audio file on LinTunes' Dock icon while it's running
Imported
3.4
Right-click an mp3 in Finder › Open With › LinTunes
Imported (LinTunes may need to be running)
3.5
Drag a song onto a playlist in the sidebar
Added at the drop point
3.6
Importing an iTunes/Music library: LinTunes --import-xml "Library.xml" --music-root … --data-dir … from Terminal (optional)
Imports
3.7
Preferences › Importing › compress lossless to MP3, then import a FLAC
Converted to MP3
4. Playback, one format at a time
Play each one for a few seconds, seek in the middle, and let one play to
the end.
#
Format
Plays
Seeks
Duration right
Notes
4.1
MP3
4.2
AAC (.m4a)
4.3
Apple Lossless (.m4a)
4.4
FLAC
4.5
WAV
4.6
AIFF
4.7
A protected iTunes .m4p (if you have one)
Refused with a message, never a crash
#
Step
Expect
Result / notes
4.8
Space, ←/→
Play/pause, previous/next
4.9
Volume slider; per-track volume (Get Info)
Changes the volume
4.10
Controls › Normalize Volume on, then play two very different songs
The loudness evens out. No error about ffmpeg.
4.11
Shuffle and repeat (off/all/one)
As on Linux
4.12
Change the output in System Settings › Sound (e.g. headphones) while playing
Audio follows, or note what happens
4.13
Play counts go up after a song finishes
5. Media keys and Now Playing
#
Step
Expect
Result / notes
5.1
Keyboard ⏯ ⏮ ⏭ keys (F7–F9) with LinTunes in the background
Control LinTunes, not Music.app
5.2
Control Center › Now Playing
Shows title, artist, artwork and position
5.3
Play/pause/next from Control Center
Works
5.4
Seek using the Now Playing scrubber
Works
5.5
AirPods/headphone controls (if any)
Work
5.6
Lock screen Now Playing
Shows the song
6. Trash and Put Back
#
Step
Expect
Result / notes
6.1
Delete a song from the library (and its file)
Gone from the list. The file is in the Trash.
6.2
In the Trash, right-click the file ›Put Back
Returns to its folder
6.3
Delete a song whose file is on an external drive
Goes to the Trash (that drive's), and Put Back works
6.4
⌘Z after a delete
The song comes back into the library
7. Get Info and tags
#
Step
Expect
Result / notes
7.1
⌘I on a song, change title/artist/album/year, OK
Saved. Check the file in Finder's Get Info or another player.
7.2
Rename an album
The file moves to the new Artist/Album folder
7.3
Edit several songs at once
All changed
7.4
Paste artwork (copy an image in Preview, paste in Get Info)
Embedded, shown in the sidebar
7.5
Drag an image file onto the artwork square
Embedded
7.6
Download Album Art…
Finds covers
7.7
Edit the tags of the song that's playing
Playback doesn't glitch
7.8
Right-click › Calculate BPM
A BPM appears
8. Visualizers
#
Step
Expect
Result / notes
8.1
The transport-bar visualizer during playback
Moves with the music
8.2
Each style: bars, radial, oscilloscope, Kaleidostrobe, Lint Oontz
Each draws
8.3
Click the visualizer for the big window, especially Kaleidostrobe (the OpenGL one)
Smooth, no black window. Note the fps feel.
8.4
Big window on a Retina display
Sharp, not blurry or quarter-sized
8.5
Preferences › visualizer sync slider
Changes the lag
9. Chromecast and AirPlay
#
Step
Expect
Result / notes
9.1
Connections › Connect to Chromecast…
macOS asks to find devices on local networks. Note the exact text.
9.2
Allow
Your Chromecasts appear
9.3
Cast a song
Plays on the TV/speaker. A firewall prompt about incoming connections may appear: allow it.
If you denied the network prompt: System Settings › Privacy & Security › Local Network › LinTunes on
Devices appear after that
10. Import from URL
#
Step
Expect
Result / notes
10.1
Without yt-dlp: File › Import from URL…
A clear message saying yt-dlp is needed (brew install yt-dlp)
10.2
brew install yt-dlp, restart LinTunes, then import a song link
Downloads, imports, and Identify proposes tags
10.3
A playlist link
The checklist of songs appears
10.4
A Spotify link
Each song is found on YouTube
11. Identify Track
#
Step
Expect
Result / notes
11.1
Preferences: set an AcoustID key, then right-click a song › Identify Track…
Candidates appear. No "fpcalc not found".
11.2
Accept a candidate
Tags written
12. Export and web mix
#
Step
Expect
Result / notes
12.1
File › Export Playlist… › folder
Files and an .m3u
12.2
Export as a web mix, then open index.html in Safari
Plays; previous/next/shuffle work
12.3
A playlist with an ALAC song, as a web mix
Converted to FLAC
12.4
Upload to web server (only if you have one in ~/.ssh/config)
Uploads
12.5
Right-click › Convert to MP3… on a FLAC
Replaced by an MP3, and the original goes to the Trash
13. DJ mode
#
Step
Expect
Result / notes
13.1
View › DJ Mode
The shelf slides open
13.2
Drag a song onto each record
Loads, shows BPM, waveforms
13.3
Play both, crossfader, tempo, Keep pitch, Sync, loops
Sound is clean (no crackles). Note any.
13.4
Scratch a record; drag a waveform
Works
13.5
Air horn, click and hold
Plays
13.6
Preferences › DJ › set up Instant vocals (download)
Installs. Note how long, and any error.
13.7
Vocals slider on a loaded song
Splits, then fades vocals
13.8
Preferences › DJ › High quality (Demucs): follow the shown setup
Note what happens
13.9
Close DJ mode with a song playing on deck A
The main player carries on
13.10
Switch audio output while in DJ mode
Sound follows
14. Cassette (sharing with a friend)
Needs Syncthing (brew install syncthing && brew services start syncthing)
and a second person or computer.
#
Step
Expect
Result / notes
14.1
With Syncthing not running: open Cassette
A clear "Syncthing isn't running" message
14.2
With Syncthing running: make this Mac the host, then create an invite
An invite code
14.3
The friend accepts
Connected
14.4
Browse the friend's library; request a song; Save and Close
The song arrives and is imported
14.5
Follow a friend's playlist (the UFO)
Plays from the cache
14.6
A sync conflict between two of your own computers (optional)
The merge summary shows
15. Sleep, quitting, updates
#
Step
Expect
Result / notes
15.1
Play an album with the display set to sleep in 1–2 minutes
The Mac doesn't sleep while music plays (the display may). Check with pmset -g assertions in Terminal: a caffeinate assertion while playing.
15.2
Pause for a while
The assertion goes away
15.3
⌘Q while playing
Quits at once, no "unexpectedly quit" report
15.4
Close the window with the red button
Note: does it quit, or stay in the Dock like Music.app?
15.5
Relaunch
Same library, playlists, play counts and column widths
15.6
Version button in the bottom-left corner
vX.Y.Z. If a newer release exists, *, and a click opens the release page in your browser.
15.7
Force-quit during an import (⌥⌘Esc), then relaunch
The library is intact
16. Additional checks (merged in)
Desktop integration
First launch from Finder with no settings: it starts, makes ~/Music/LinTunes, and the app menu reads "LinTunes".
Preferences (⌘,) and Quit (⌘Q) are in the LinTunes menu.
Playing a song: Control Centre's Now Playing shows title, artist, album, cover and a moving progress bar; paused, the time stops.
F8 pauses and resumes, F9 / F7 skip, the Now Playing scrubber seeks — also with another app in front.
Embedding new art on the playing song updates the Now Playing cover.
While playing, pmset -g assertions lists caffeinate; paused, it's gone. Force-quit while playing: pgrep caffeinate finds nothing.
Right-click a song › Show in Finder selects the file.
Delete a song (move to Trash): it's in the Trash and Put Back works; Edit › Undo brings it back into the library.
The delete key (⌫) removes songs from a playlist; context menus show ⌘I / ⌘C / ⌫, never "Ctrl+".
⌘N, ⌘B, ⌘L, ⌘I, ⌘Z, ⌘⇧Z each fire once. Space and ← → play/pause and skip, but not while typing in the search box.
Renaming an artist by capitals only ("Rjd2" → "RJD2") leaves the file where it is, with its own name.
Connections has no Rabbit, Shazam or andTunes items; Preferences › Appearance has no "Hide the menu bar" row.
The look is the Linux one (flat buttons, the app's own scrollbars), not native Mac controls.
An mp3 dropped on the Dock icon is imported, with the app running and with it closed.
Web-mix upload with only Apple's rsync says to brew install rsync; with Homebrew's it uploads.
Import from URL after brew install yt-dlp downloads; on a YouTube bot check it retries with Firefox or Chrome cookies.
Cassette
With the Syncthing app running, Sync Settings shows its version (the key is read from ~/Library/Application Support/Syncthing/config.xml). Same with Homebrew's syncthing.
With Syncthing stopped, the status says how to open or get it.
An invite and handshake between this Mac and a Linux friend completes. Syncthing accepts the folders under ~/Library/Application Support/LinTunes/cassette/ (the path has a space).
Songs with accents in their names (é, ü) arrive and import, both ways.
The disk-space verdict looks right; the host name shows without .local.
DJ mode
Decks play through speakers, headphones and AirPods; switching output while playing follows it.
Activity Monitor: LinTunes' CPU with DJ mode open and nothing playing is low.
Preferences › DJ › Download Instant Vocal Splitting finishes, and a split puts .opus files in ~/Library/Caches/LinTunes/stems.
Download High-Quality Vocal Splitting finishes; splitting an m4a and an mp3 works; the ✕ beside the vocals note stops it.
A split is found again after editing the song's tags. BPM is detected on load.
AirPlay and Chromecast
The local-network prompt appears once; after Allow, speakers and Chromecasts are listed.
AirPlay plays to a speaker of your own; pause, seek and next behave.
With "airplay_backend": "cli" in config.json the helper downloads and plays. If macOS refuses to run it, note its exact words.
Chromecast: the TV plays the song, seeking works, the cover shows. Note whether the firewall prompt blocked the first try.
Anything else
Note anything that felt un-Mac-like, slow, ugly or confusing, even if it
"worked":