Code resources for the local-first TikTok Sound Vault desktop app and workers.
0
stars
107
commits
Python
primary language
Sep 9, 2026
updated

Hoard your favorite sounds. A local-first desktop app that saves TikTok, Instagram, and YouTube sounds into a folder that is yours: searchable, tagged, offline, and unbothered.
soundcache.io · Blog · Pair your iPhone
local-first · no login · no cloud · GPU transcripts · macOS today (it is Python, so Windows and Linux are an easy port)
TikTok will not let you save the sound. "Favorites" are bookmarks that vanish the moment a video is deleted, a track is taken down, or an account goes private. Screen-recording is lossy, the sketchy mp3 sites are malware, and the link you texted yourself rots in your notes.
Sound Cache fixes that permanently. You save a sound once and it lands as a real, tagged audio file in a local folder you own, complete with the title, artist, artwork, transcript, and example videos, so your FYP's greatest hits outlive platform churn. Built for the editors and creators who need the trends offline and organized.
One tap on your phone, and a fully-tagged file appears on your computer. Offline. Unbothered. The relay only ever holds a link on its way to you, with no account, no files, and no tracking.
Setup:
Caching from TikTok REQUIRES an active logged in session on your computer

metadata.json per sound is the source of truth; SQLite is a disposable, rebuildable full-text cache. Everything stays browsable in Finder or on a NAS even if the app never runs.Local-first means what it says. Your collection lives on your machine, not on a server. There is no account, so there is nothing to leak.
Full Privacy Policy and Terms of Use, including the anti-piracy notice, live on the site.
Python 3.12 · PySide6 (Qt6) desktop · FastAPI relay on Vercel with Neon Postgres · SQLite FTS5 · yt-dlp and Playwright for ingest · faster-whisper and MLX for transcription.
# 1. External tools. TikTok sound capture drives a real browser via Playwright;
# yt-dlp and ffmpeg handle download and transcode.
brew install node ffmpeg yt-dlp # macOS (use your package manager elsewhere)
npm install # installs Playwright into ./node_modules
npx playwright install chromium # one-time browser download
# 2. Python app.
python -m venv ~/venvs/sound-cache && source ~/venvs/sound-cache/bin/activate
pip install -e ".[gui,ingest]" # GUI + on-device transcription + yt-dlp
sound-vault # launch the desktop app
# in-app: Settings -> Create pairing code -> Pair iPhone -> Connect TikTok
You need an active TikTok session. TikTok serves a sound's audio only to a logged-in browser, so the first run walks you through Connect TikTok, a one-time login the app keeps locally on your machine and never uploads. Without Node, Playwright, and Chromium the app still runs, but TikTok sound capture is disabled, and the in-app prompts tell you exactly what is missing.
Apple Silicon note. The transcription engines ship as native arm64 wheels. Launch the app natively (not under Rosetta) so the GPU path can load; the bundled launcher forces the arm64 slice for you, and the app warns you if it ever finds itself translated.
Tests: pytest -q (set SOUND_VAULT_DISABLE_RELAY_POLL=1 SOUND_VAULT_DISABLE_TRANSCRIBE=1 for a fast offline run).
MIT. Sound Cache is a tool for personal organization of sounds you are entitled to use; please respect creators' rights and platform terms.
107 commits
Python
97.6%
JavaScript
1.6%
Code resources for the local-first TikTok Sound Vault desktop app and workers.
0
stars
107
commits
Python
primary language
Sep 9, 2026
updated

Hoard your favorite sounds. A local-first desktop app that saves TikTok, Instagram, and YouTube sounds into a folder that is yours: searchable, tagged, offline, and unbothered.
soundcache.io · Blog · Pair your iPhone
local-first · no login · no cloud · GPU transcripts · macOS today (it is Python, so Windows and Linux are an easy port)
TikTok will not let you save the sound. "Favorites" are bookmarks that vanish the moment a video is deleted, a track is taken down, or an account goes private. Screen-recording is lossy, the sketchy mp3 sites are malware, and the link you texted yourself rots in your notes.
Sound Cache fixes that permanently. You save a sound once and it lands as a real, tagged audio file in a local folder you own, complete with the title, artist, artwork, transcript, and example videos, so your FYP's greatest hits outlive platform churn. Built for the editors and creators who need the trends offline and organized.
One tap on your phone, and a fully-tagged file appears on your computer. Offline. Unbothered. The relay only ever holds a link on its way to you, with no account, no files, and no tracking.
Setup:
Caching from TikTok REQUIRES an active logged in session on your computer

metadata.json per sound is the source of truth; SQLite is a disposable, rebuildable full-text cache. Everything stays browsable in Finder or on a NAS even if the app never runs.Local-first means what it says. Your collection lives on your machine, not on a server. There is no account, so there is nothing to leak.
Full Privacy Policy and Terms of Use, including the anti-piracy notice, live on the site.
Python 3.12 · PySide6 (Qt6) desktop · FastAPI relay on Vercel with Neon Postgres · SQLite FTS5 · yt-dlp and Playwright for ingest · faster-whisper and MLX for transcription.
# 1. External tools. TikTok sound capture drives a real browser via Playwright;
# yt-dlp and ffmpeg handle download and transcode.
brew install node ffmpeg yt-dlp # macOS (use your package manager elsewhere)
npm install # installs Playwright into ./node_modules
npx playwright install chromium # one-time browser download
# 2. Python app.
python -m venv ~/venvs/sound-cache && source ~/venvs/sound-cache/bin/activate
pip install -e ".[gui,ingest]" # GUI + on-device transcription + yt-dlp
sound-vault # launch the desktop app
# in-app: Settings -> Create pairing code -> Pair iPhone -> Connect TikTok
You need an active TikTok session. TikTok serves a sound's audio only to a logged-in browser, so the first run walks you through Connect TikTok, a one-time login the app keeps locally on your machine and never uploads. Without Node, Playwright, and Chromium the app still runs, but TikTok sound capture is disabled, and the in-app prompts tell you exactly what is missing.
Apple Silicon note. The transcription engines ship as native arm64 wheels. Launch the app natively (not under Rosetta) so the GPU path can load; the bundled launcher forces the arm64 slice for you, and the app warns you if it ever finds itself translated.
Tests: pytest -q (set SOUND_VAULT_DISABLE_RELAY_POLL=1 SOUND_VAULT_DISABLE_TRANSCRIBE=1 for a fast offline run).
MIT. Sound Cache is a tool for personal organization of sounds you are entitled to use; please respect creators' rights and platform terms.
107 commits
Python
97.6%
JavaScript
1.6%