SpotiCloud Sync

Export and sync liked songs between Spotify and SoundCloud — as a Chrome extension that runs in your browser. No accounts, no cloud upload of your library, no API keys.

---

Why it exists

People keep libraries on both Spotify and SoundCloud. Official sync does not exist. SpotiCloud is a small personal tool that:

1. Exports your likes / playlist tracks to JSON
2. Searches the other site for each track
3. Likes matches when the title/artist score is high enough

Matching is tuned for messy SoundCloud titles (reuploads, bilingual names, Artist - Title, feat credits, Persian romanization quirks like ba ham ↔ baham).

Not affiliated with Spotify or SoundCloud. Site UIs change — scrapers can break and may need updates.

---

Features

---

Install (unpacked)

Chrome Web Store listing is optional; today you load it locally:

1. Clone the repo

   git clone https://github.com/artart222/spoticloud.git
   cd spoticloud
   

2. Open chrome://extensions
3. Enable Developer mode
4. Load unpacked → select the extension/ folder
5. Pin SpotiCloud Sync from the puzzle menu

After you pull updates, click Reload on the extension card.

---

Quick start

Export

1. Open Spotify Liked Songs or SoundCloud Likes (or any playlist page).
2. Open the extension popup.
3. Click Spotify Liked Songs or SoundCloud Likes.
4. Wait until scrolling finishes — a JSON file downloads.

Sync

SoundCloud likes → Spotify

1. Load the SoundCloud JSON (or Use last SoundCloud tracks).
2. Stay logged into open.spotify.com.
3. Click Like on Spotify.
4. Leave the tab alone while it searches and likes.

Spotify likes → SoundCloud — same flow the other direction.

Use Pause / Resume / Stop for long libraries. Match confidence threshold is 0.72 (shown in the popup footer).

Prefer the desktop Spotify web player; mobile web is limited.

---

How matching works (short)

For each SoundCloud track the extension:

1. Cleans the title (bitrate tags, bilingual | halves, producer credits, remix casts).
2. Builds search queries — usually title + artist, then bare title, sometimes a Latin/numeric hint (e.g. +3:30).
3. Scores Spotify rows with title + artist similarity (feat credits, reupload uploaders, spacing variants).
4. Likes only when the best score ≥ 0.72.

That keeps random same-name songs out, at the cost of skipping some ambiguous reuploads.

---

Project layout

spoticloud/
├── extension/          ← load this folder in Chrome
│   ├── manifest.json
│   ├── popup/
│   ├── background/
│   ├── content/
│   ├── shared/         ← normalize, similarity, filters
│   └── icons/
├── docs/               ← privacy, contributing, screenshots & demo
├── tools/match-lab/    ← optional matching experiments
├── scripts/            ← older standalone scripts
└── LICENSE

---

Privacy

• Runs entirely in your browser against pages you already have open.
• Does not send your library to a SpotiCloud server (there isn’t one).
• Permissions are limited to Spotify and SoundCloud hosts, plus storage/downloads/tabs for the sync job.

Full text: docs/PRIVACY.md

---

Disclaimer

• Personal tooling. Expect breakage when Spotify or SoundCloud redesign their DOM.
• Automated liking may conflict with each site’s terms of use — use at your own risk, preferably on your own accounts, at a human pace.
• Matching will miss tracks that are not on the other platform, or that only share a vague title.

---

Contributing

Issues and PRs welcome — especially DOM selector fixes when a site UI changes. See docs/CONTRIBUTING.md.

---

License

MIT © 2026 Artin Mobasher