- Download and unzip. Drag Mac Island.app into Applications.
- Open Mac Island. Hover at the notch, or the top centre of a screen without one.
- Connect once. Then just press play. Open your player and play a song. Right-click the island → Music Connections, open the player’s entry and click Connect. Approve the macOS Automation request; browser entries include their setup instructions.
About the first-launch security prompt
This public preview is locally signed, not signed with an Apple Developer ID or notarized by Apple. macOS may block its first launch.
If you trust this download, try opening it, then go to System Settings → Privacy & Security. If offered for Mac Island, choose Open Anyway. Managed Macs may prevent this.
If macOS reports damage or malware, stop and contact us.
Apple's instructions for opening appsSet up YouTube Music in a browser
Open music.youtube.com in Safari, Chrome, Brave or Edge. Right-click Mac Island → Music Connections and open that browser’s entry for setup.
Chrome, Brave and Edge use View → Developer → Allow JavaScript from Apple Events. In Safari, enable web developer features in Settings → Advanced, then use Develop → Allow JavaScript from Apple Events. This setting permits browser automation; Mac Island does not enable it for you.
Click Connect and approve macOS Automation access. Mac Island checks open-tab URLs locally to locate YouTube Music, then reads and controls only that page’s player. It does not read other page content, cookies or account details.
Installed Chromium web apps work only when the parent browser exposes their window. Firefox, Safari Dock web apps and other third-party wrappers are not supported. Browser changes may affect the connection; a regular supported browser tab is the recommended starting point.
Set up YouTube Music in Pear Desktop
In Pear Desktop, enable Plugins → API Server. Set the host to 127.0.0.1 and port to 26538, keeping authorization enabled.
Open Music Connections → YouTube Music · Pear in Mac Island, click Connect and approve Mac Island in Pear. The connection stays on your Mac; its token is stored in Keychain. To revoke access, remove Mac Island from Pear’s authorized clients.
How automatic switching and Apple Music work
Mac Island follows the most recently started player and keeps a paused song when nothing is playing. Switching is always automatic. Old saved source selections are cleared on upgrade, and switching waits until you finish a seek or volume drag.
Apple Music uses the Music app’s local Automation interface. Some macOS versions do not expose the current track for radio, autoplay or songs outside your library. Try a library track if information is missing.
Live behavior depends on your player, browser and permissions. Use Music Connections to set up each player you want to use, then check playback, seeking and volume on your Mac.
Screenshots and floating notes
Click in a note and press ⌘V to paste a clipboard screenshot or an image file copied from Finder. Click the image to select it, then copy, cut or delete it. Double-click to enlarge it. Text wraps within the card and long notes scroll.
Click Float, or drag that button onto the desktop, to open a resizable note beside your work. It shares the same saved content. Drag its top handle toward the notch and release when you see Release to dock. Closing a floating window keeps the note; floating windows do not reopen automatically after quitting.
When the tray contains files, use the tray icon beside the note controls to view them. Use the two-card icon in the tray to return to music and notes. Your note’s cursor, scroll position and undo history are preserved.
Send selected text to Mac Island
Select text in an app that supports macOS Services. Open its Services menu and choose Send to Mac Island. Mac Island saves the selection as a new local note and reveals it in the island. The source text and your clipboard stay unchanged.
Availability depends on the source app exposing its selection to macOS Services.
Updating from an older version
Quit Mac Island from the right-click menu in the open island. Download the latest ZIP, replace the app in the same Applications folder and reopen it. Notes and file references are stored separately from the app. Existing text notes migrate to the image-capable format; older builds cannot edit that newer format.
This download uses manual updates. Automatic updates are not enabled in this release. The current public edition does not include Spotify likes or account setup.
Privacy: what leaves my Mac?
Your notes, embedded screenshots, captured text and file references stay on your Mac. Mac Island has no ads, analytics or notes/files cloud sync. Spotify, Apple Music and supported browsers use local Apple Events with your permission. Pear uses its API on this Mac, with its authorization token kept in Keychain.
Spotify and YouTube cover images download anonymously from their image servers, which receive the image request and normal connection information, including your IP address. Apple Music covers come locally from the Music app. Artwork is cached only in memory.
While floating lyrics are open, Mac Island sends the active song’s title, artist, album and duration to LRCLIB. LRCLIB also receives normal connection information. No notes or files are sent. Closing the panel cancels lookups; lyrics are cached only in memory.
The public download has no Spotify account sign-in or Spotify account API requests. It makes no automatic update requests. Your music apps and browsers retain their own account connections and privacy settings.
How do I quit or launch it at login?
Right-click an empty area of the open island for How to Update, privacy details and Quit Mac Island. Open Welcome & Launch at Login to revisit the guide or turn on launch at login. It is off by default; macOS may ask you to approve it in Login Items settings.