✦ 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). Download a pre-filled copy creates an unsigned file for advanced use. That file may not import on your iOS version; use the signed button above for the standard setup.
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
Use Add the Shortcut ✦ for the signed file. Open this page in Safari on your iPhone or iPad and make sure the Shortcuts app is installed. If the file downloads instead of opening, find SoundCache.signed.shortcut in Files → Downloads and tap it. Review the shortcut, paste your pair code when asked, then tap Add Shortcut.
The optional pre-filled copy is unsigned. If iOS rejects it, return here and use the signed download; changing a sharing setting is not a guaranteed way to import an unsigned file. You do not need to look for an Allow Untrusted Shortcuts toggle for our signed download. See Apple’s shortcut-sharing guide for the current import flow.
"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 is unsigned and intended for advanced use; it is not the recommended iPhone installation path.
