Public beta · SIN pool live

MetaSync

The network layer for SoulSync

SoulSync works completely on its own. MetaSync is the small companion program installs can choose to plug in: it connects your SoulSync to shared networks that make every connected library smarter, while no install ever gives up control of its own data.

Charts Updated weekly
Trending · from ListenBrainz
Seed chart · public listening data
46 tracks
Just Landed · from ListenBrainz
Seed chart · public listening data
44 tracks
Trending: 2020s · from ListenBrainz
Seed chart · decade edition
34 tracks
Top Tracks · from ListenBrainz
Seed chart · all-time favourites
50 tracks

Live in every MetaSync node's Charts page today. The community's own charts take over once 15 installs are reporting.

8 Signal types counted
15 Installs to publish a chart
1 Report a week, for the week just ended
0 Reports stored. Counted on arrival, then gone
One companion, two networks

What MetaSync Is

MetaSync runs next to your SoulSync, with its own interface on its own port, and speaks to SoulSync only through SoulSync's API. It is the bridge to two opt-in networks.

Live

SIN: The SoulSync Intelligence Network

Installs that join SIN send one small report a week: anonymous counts of what got watchlisted, wishlisted, added, downloaded and kept, sent as MusicBrainz IDs, never names or files. The pool adds the counts up, and a release can only chart once at least 15 installs stand behind it.

Charts are real playlists of around 50 tracks, led by each album's best song. They appear in MetaSync's own Charts page, ready to browse, and nothing is ever pushed into your SoulSync.

Trending · Most Wanted · Just Landed · Loved & Kept · On Repeat · Rising · Breakout Artists, plus genre and decade editions
Live

The Companion

MetaSync is free and open source, like SoulSync. Run it as a Python program on the same machine, or as a Docker container next to it.

Installing it joins nothing. Connecting to a network is a separate, deliberate step, and MetaSync starts in dry run: it shows you the exact report it would send, line by line, before anything leaves your machine. Stop it, unplug it, or never install it, and SoulSync runs exactly as before.

In development

The Metadata Pool

The second network is still being built. Every SoulSync install spends real work resolving metadata: matching tracks, albums and artists across providers. The pool will let installs share that resolved metadata, keyed by the SoulID every track, album and artist already gets in SoulSync, so one install's work does not have to be redone by every other install.

It will carry metadata only: never audio, never your files, and your own library's data will always win over the pool's. Not live yet.

Live now

The Charts Page Isn't Empty

SIN's own charts need 15 reporting installs, and the network is still gathering them. So the pool opens with seed charts built from ListenBrainz's public listening data, named honestly so nobody mistakes them for the community's own taste. Same shape as the real thing: around 50 tracks, best songs first, refreshed weekly. When the community's counts take over, the seeds retire.

46 TRACKS

Trending · from ListenBrainz

What the wider listening world is playing right now, resolved to full albums with each album's five most popular tracks.

44 TRACKS

Just Landed · from ListenBrainz

The newest arrivals making noise, the seed edition of the chart SIN will build from fresh additions across the network.

50 TRACKS

Top Tracks · from ListenBrainz

All-time favourites, plus a Trending: 2020s decade edition at 34 tracks. Editions only publish when they add something their parent chart doesn't already say.

Getting connected

How to Connect

Three steps. The first connects MetaSync to your SoulSync. Only the third one joins a network.

STEP 1

Connect MetaSync to your SoulSync

Run MetaSync next to your SoulSync and open its interface. In SoulSync, go to Settings, Advanced, MetaSync and press Connect: SoulSync finds MetaSync, shows a pairing code to approve on the MetaSync dashboard, and the two swap keys. Typing the keys by hand works too. Nothing has left your machine.

STEP 2

Get a pool key

Sign in at the MetaSync portal, metasync.ssync.net, and create a key. It is shown once; the portal keeps only its fingerprint. That key is how the pool knows a real account is connecting. Regenerate or revoke it at any time: revoking cuts that install off on its very next request, without affecting anyone else.

STEP 3

Join the pool, and approve your MetaSync

Paste your key into SoulSync's MetaSync section, or add the pool on MetaSync's Pools page. The first time MetaSync presents it, the portal asks you to approve that MetaSync by its fingerprint: from then on the key works only from that one install, so a copied key is useless anywhere else. MetaSync starts in dry run, so you can read the exact report yourself. Turn it off, and it sends one report a week for the week just ended.

Privacy

What Leaves Your Machine, and What Never Does

SIN runs on counts, not on your data. A report covers the week that just ended, and a week with hundreds of imports is a migration, not taste: bulk weeks are held back rather than sent.

A report contains

  • MusicBrainz IDs for artists you watchlisted that week
  • Release IDs you wishlisted, added, downloaded, kept for two weeks, or are still hunting for, each counted once
  • Albums you downloaded and later removed Optional, off by default
  • Albums you played at least three different tracks from, top 50 at most Optional, off by default

It never contains

  • Your identity. Your key checks you in at the door; the report itself carries no name, account or install ID
  • Listening history. The optional listening signal is a yes or no per album: no play counts, no times, no track names, and nothing from profiles that keep their own history
  • Your library. No file paths, no library listings, no artist or album names as text, no audio, ever
  • A stored report. There isn't one. Counting happens the moment a report arrives, and the pool keeps only the tally per release

Preview Before It Sends

MetaSync shows you the exact report before the first send, and the latest report is always one click away in its interface. If you do not like what you see, do not join the pool, or leave it. Leaving takes effect immediately; the pool keeps only the anonymous counts already combined into past weeks.

Keys That Only Work From Home

A pool key is exchanged for short-lived, signed access tokens, and it only works from the one MetaSync you approved by fingerprint. Copy the key anywhere else and it is useless. Revoke it, and every token dies on the very next request.

Only Official Playlists Are Official

The shared playlists are published by the network itself, from the combined counts. Individual installs can only send their own signals and pull the finished playlists down. Nobody can edit the shared lists, inject tracks into them, or publish on anyone else's behalf.

Status

Where This Stands

Public beta, honestly labelled. The full data map, every signal and every rule, is in the MetaSync repository.

Live now
  • The SIN pool, counting weekly reports on arrival
  • The portal at metasync.ssync.net, issuing pool keys
  • Seed charts from ListenBrainz, refreshed weekly
  • Daily automated composing, so charts publish without anyone pressing a button
  • Pairing from SoulSync's Settings, Advanced, MetaSync
Gathering
  • Founding installs. Community charts publish the first week 15 installs report the same release
  • On Repeat, the listening chart, needs its own crowd of installs that switch the optional signal on
  • Genre and decade editions of the community charts, once the counts are deep enough to split
In development
  • The metadata pool: shared SoulID records, checked before they are trusted
  • Charts inside SoulSync's Discover page, browsable without leaving SoulSync

Be one of the first 15.

The charts switch from seeds to the community's own taste the week 15 installs are reporting. Early testers are exactly what the network needs, and the report your install sends is one you can read first, in full, before it goes anywhere.

Get a pool key