Check out my personal blogsVisit maxrave.dev
SimpMusicSimpMusic Docs
User Guide

Links & Sharing

Open YouTube links straight into SimpMusic, share what you're playing, and hand off links between the web and the app.

SimpMusic plugs into the system beyond its own screens — it can open YouTube links directly, hand a song off to another app, and be handed a link back.

On Android, SimpMusic registers itself as a handler for YouTube and YouTube Music links, so tapping one — in a browser, a chat app, anywhere — can open straight into SimpMusic instead of the YouTube app.

What you tapHostsOpens
A video link (/watch, /v/, /embed/, or a bare youtu.be/<id>)youtube.com, m.youtube.com, www.youtube.com, music.youtube.com, youtu.beThe song or video
A playlist link (/playlist)same hostsThe playlist or album
A channel link (/channel/, /user/, /c/)same hostsThe artist/channel
A vnd.youtube: or vnd.youtube.launch: linkcustom scheme, no hostWhatever it references

These filters are declared as Android App Links (autoVerify), so once Android has verified the domain, tapping a link opens SimpMusic directly with no "Open with" prompt. If verification hasn't happened yet, you'll see the usual app chooser instead.

Android "Open with" chooser listing SimpMusic for a youtube.com link, or the link opening straight into SimpMusic's player
Android "Open with" chooser listing SimpMusic for a youtube.com link, or the link opening straight into SimpMusic's player

Desktop handles the same links too: macOS receives them through the system's URL-open handler, while Windows and Linux receive them as a command-line argument when the OS launches SimpMusic for that link.

Sharing from SimpMusic

Songs, albums, playlists, and podcasts all have a Share action in their "" menu.

Open the "" menu on a song, album, playlist, or podcast.

Tap Share.

What happens next depends on the platform:

PlatformBehaviour
AndroidOpens the OS share sheet with a music.youtube.com link, ready to send to any app
DesktopCopies the link to your clipboard and shows a toast — there's no OS share sheet
Android system share sheet opened from a song's "⋯" menu → Share action
Android system share sheet opened from a song's "⋯" menu → Share action

On Android, SimpMusic also appears as a share target: from another app's own share menu (YouTube, a browser, a chat app), you can share a YouTube link to SimpMusic and it opens the same way as tapping the link directly. This is Android-only — Desktop has no share-target integration.

Android share sheet from another app (e.g. YouTube) with SimpMusic listed as a share target
Android share sheet from another app (e.g. YouTube) with SimpMusic listed as a share target

Web → app handoff

Links under simpmusic.org/app/ and the simpmusic:// custom scheme both hand content straight from the web to the app, on both Android and Desktop:

LinkOpens
.../app/watch?v=<id> or simpmusic://watch?v=<id>The song or video
.../app/playlist?list=<id> or simpmusic://playlist?list=<id>The playlist or album
.../app/channel/<id> or simpmusic://channel/<id>The artist/channel
.../app/album?id=<id> or simpmusic://album?id=<id>The album

This is what powers "Open in app" links from simpmusic.org.

NFC tags

Android also listens for the same tap-to-open behavior via NFC: a YouTube or SimpMusic link written to an NFC tag opens straight into the app when your phone taps it, using the same link filters described above.

Community

Get involved in our community. Everyone is welcome!

SimpMusic is sponsored by:

Get free $200 credit over 60 days on DigitalOcean: GET NOW

Crowdin and Sentry both have a free enterprise plan for Open-source projects. Follow the URLs:

Check out the Vercel open-source program

SimpMusic app is FOSS and under GPL-3.0 license.

© 2023-2026 SimpMusic - @maxrave-dev

We are not affiliated with or endorsed by Google, YouTube, Spotify, or any other third-party brands or applications.