Music Culler — Free Stream Deck Companion
Plugin version 1.6.109

Requires the Music Culler Mac app and Elgato Stream Deck software on the same Mac. Stream Deck hardware or Stream Deck Mobile is separate. This plugin does not control the standalone Music Culler iPhone/iPad app.

INSTALL
1. Extract this ZIP.
2. Double-click com.adrianramos.musicculler.streamDeckPlugin and accept Stream Deck's installation or update prompt.
3. Fully quit and reopen Elgato Stream Deck after updating.
4. Open Music Culler on that Mac and choose your music folder. Keep both apps running.
5. In Stream Deck's actions list, find Music Culler. Drag actions onto keys or compatible dials. Configure strip positions and modes in the selected action's settings.

CONNECTION
The App Store/TestFlight Mac app connects automatically using a loopback-only connection on the same Mac. No NAS password, pairing code, or router port forwarding is needed. Do not expose the connection to your network.

Stream Deck Mobile connects to Elgato Stream Deck on your Mac; the plugin then controls the Mac version of Music Culler. It does not connect directly to the Music Culler mobile app.

TROUBLESHOOTING
If buttons do not update, confirm Music Culler is open and only one copy is running. Install plugin 1.6.109 or newer; 1.6.108 lacks the App Store/TestFlight connection. Restart Stream Deck after updating. Keep your existing profiles; do not delete your layout to troubleshoot the connection.

FILE SAFETY
Favorite copies. Keep and Top Pick move. Trash moves the track to the app's managed Trash location. Holding the Trash action can start Empty Trash; permanent deletion cannot be undone. Back up your collection and test using disposable copies first.

HELP
https://projectramos.com/music-culler/support/
adrian@projectramos.com
Do not email music files, passwords, or NAS credentials.
