✦ almost there
Pair your iPhone
Add the Save to Sound Cache shortcut. It puts a button in your share sheet — share a sound from TikTok, Instagram, YouTube or X and it lands in your vault.
- Tap Add the Shortcut below — it opens right in Shortcuts (it's signed, so no Settings toggle).
- When it asks, paste your pair code (right here ↓), then tap Add Shortcut.
- Open any app → Share → Save to Sound Cache. Done ✨
The button above installs a signed shortcut — one tap, no Allow Untrusted Shortcuts toggle.
It asks for your pair code once at install (paste it from below). Want it pre-filled with zero typing instead?
Download a pre-filled copy bakes your code in, but iOS needs Allow Untrusted Shortcuts on
(Settings → Shortcuts → Advanced) the first time.
Open this page from the Pair iPhone QR in the desktop app and your relay
URL + pair code fill in automatically. No pair code yet? In the app: Settings → Create pairing code.
what's actually happening 🔌
your phone only ever sends a link (plus your pair code) to the relay — never your audio, never a file. your desktop polls the relay, grabs the link, and does the real download locally into your own folder. no account, the pair code expires, and you can stop it any time. nosy about sounds, not about you. 💕
troubleshooting 🛠️
The shortcut won't import / "Add Shortcut" does nothing
iOS only installs custom shortcuts when Allow Untrusted Shortcuts is on: Settings → Shortcuts → Advanced. That toggle only appears after you've run at least one shortcut — so open the Shortcuts app, run any built-in shortcut once, then flip the toggle and try again. After downloading, the file lands in Files → Downloads; tap it there to import.
"Save to Sound Cache" doesn't show in the share sheet
Open the shortcut's ⓘ details and make sure Show in Share Sheet is on, with URLs and Text accepted. Still missing? Scroll to the bottom of the share sheet and tap Edit Actions… / More — you can pin it to the top there.
I shared a sound but nothing appears on my desktop
Three things to check: (1) the desktop app is running with auto-import on (or hit Download & import); (2) the pair code matches the one currently shown in the app — codes expire after 30 days, so regenerate if it's old; (3) the relay URL in the shortcut is exactly https://api.soundcache.io with no trailing space.
"unknown or expired pairing code"
Pair codes are short-lived for safety. In the app: Settings → Create pairing code, then re-scan the QR (it regenerates this page with the fresh code) or paste the new code into the shortcut's pair_code field.
Can I get a true one-tap install (no toggle)?
Yes — that's exactly what Add the Shortcut ✦ does. It's a signed shortcut, so it opens straight in the Shortcuts app with no Allow Untrusted Shortcuts toggle; it just asks for your pair code once at install. The Download a pre-filled copy option bakes your code in with zero typing, but that one needs the toggle on the first time.
