中文 ｜ English
By ZhaoBuyan
Sync what you're listening to — and what you're running — to your Steam status, in real time.
Works with NetEase Cloud Music / QQ Music / LX Music / KuGou Music — download, sign in, done. Free forever. Runs on 64-bit Windows 10 / 11.
- Download MuSync.exe (full edition, recommended — a portable single file, just double-click) from Releases
- Sign in to Steam on first launch (mobile authenticator / email code supported). If you hit an "unusual login" warning, follow the in-window instructions: Steam app on your phone → select "Steam Client" → confirm your location
- Open your music player — that's it, your friends can now see what you're listening to
- (Optional) Want friends to see which app you're using? Settings → Sync → enable "Sync non-game apps"
First launch on Windows: MuSync isn't code-signed yet, so Windows may show a "Windows protected your PC" / unknown-publisher warning. Click More info → Run anyway — that's the standard prompt for unsigned software, not a sign that anything is wrong.
LX Music users: enable "Open API service" under LX Music → Settings → Open API, and allow LAN access.
Co-existing with the Steam client: signing in to Steam on the same account from both MuSync and the Steam client won't log either out (both are SteamKit sessions). You'll see a device session named MuSync in Steam's account management — that's expected.
- The song you're listening to is something only you know — MuSync turns it into a line in your friends list
- No plugins to install, no Steam client to keep running — sign in once and it just syncs
- It syncs app status too (coding in VS Code, playing a non-Steam-launched game) — wording, style and colors are fully yours to define
- Supports NetEase Cloud Music / QQ Music / LX Music / KuGou Music
- Multiple players running at once are arbitrated automatically: whatever is playing wins; player priority is adjustable in Settings and takes effect immediately
- Music and app sync have independent switches; with "Hide music status when paused" enabled, a paused player never shows up in your friends list
- Sync the running state of any app to Steam: games, work software (like VS Code), anything
- A built-in dictionary recognizes ~50 common apps, plus fullscreen detection, to auto-classify them (game / work / media / social — adjustable)
- New apps land in the list for confirmation; you can also add the current foreground app from Settings
- Two display modes:
When in foreground(hidden when you switch away) /Always when running(shown even while idling) - System processes and music players are excluded by default; apps categorized as "Ignore" never affect your status
- Block editor: compose the status text from blocks — Song / Artist / Progress bar / App name / Separator / Custom text — reorder freely with a live preview
- Template presets: one click to switch between "Simple / With prefix (Playing·Listening) / Name only"
- Progress bar style: presets plus any characters you like, length 1–50; emoji work out of the box, e.g.
[❤️❤️❤️❤️❤️❤️💕💕💕💕] 1:59/3:32 - Appearance: title / song colors, font, background color, background image (stretch / fit / tile / center) — all customizable with one-click reset
- Crop the background image by dragging a frame after picking it (no frame = use the whole image); the main window scales to the image's aspect ratio, keeping its center and staying on screen
- Combined display and separator are configurable; text over Steam's limit is truncated intelligently at 128 bytes
- Persistent status: when nothing is playing and no app is being synced, show a custom line instead of clearing your status (emoji supported) — toggle it in Settings → Display
- Example output (templates + block editor — fully yours to define):
Non-Steam game running
Listening to: Rice Field - Jay Chou [#####-----] 2:30/4:15 ← while listening
Listening to: Rice Field - Jay Chou [❤️❤️❤️❤️❤️❤️💕💕💕💕] 2:30/4:15 ← any progress-bar style / length, paste emoji freely
VS Code ‖ Listening to: Rice Field - Jay Chou ← coding while listening (combined template)
Strinova ← playing a non-Steam-launched game
- Connects directly to the Steam network via SteamKit2; the Steam client doesn't need to be running
- Automatic reconnect with exponential backoff; signs back in with the saved token after recovery
- Falls back to WebSocket (port 443) when TCP fails; the server list is cached locally so it can connect even when official endpoints are unreachable; automatic server switching and retries up to 4 rounds when the server asks you to try another CM
- Auto-pauses while you play a real Steam game, resumes when you exit the game
- The login token is encrypted with Windows DPAPI; network hiccups never wipe your login state
- Sync rate options: Fast 0.25s / Standard 0.5s (recommended) / Data saver 1s
- Two panels on the main window: "Music" (follows the current player) and "App" — with live sync status; double-click the song title to open its page in your browser
- Lives in the notification area: hover shows the current status, right-click offers "Pause sync" for temporary invisibility, optional start with Windows
- The Settings dialog is a single window with tabs: General / Sync / Display / Apps / Diagnostics / About
- Update check: on launch, then every 6 hours; new versions surface on the "Settings" button and tray menu; the update dialog can download directly — the full/lite editions use "Exit & open folder" for a manual replace, the installer edition updates with one click ("Update now")
- The Diagnostics tab offers "Copy diagnostics" (one-click copy of the full state) and "Open logs folder"; logs live in
%LocalAppData%\MuSync\logs\
Which edition? We recommend MuSync.exe (full edition) — a portable single file, just double-click; MuSync-Setup.exe (installer edition) suits people who want zero maintenance — new versions auto-update with one click and no manual file replacement; MuSync-lite.exe is smaller but requires the .NET 10 Desktop Runtime. All three editions are functionally identical and share the same config & login.
Upgrading: the app checks for updates automatically — for the full/lite editions, download then click "Exit & open folder" and drag to replace; for the installer edition, click "Update now" and it's done.
-
Sign-in keeps failing / "Server busy" (TryAnotherCM) This is Steam's risk control reacting to a "new device + network environment change" — it usually clears up within minutes (MuSync automatically switches servers and retries, up to 4 rounds). If it happens often: turn off Steam network tools such as Steam++ (Watt Toolkit) and retry; if you use an accelerator, try to keep the same node.
-
A friend might not see you In rare cases the Steam client's friends list "drops" an individual friend entry, so that person can't see you (your profile still works). This is almost certainly on the Steam client side — right-click refresh or restart the Steam client to recover.
-
LX Music is not detected Please enable "Open API service" under LX Music → Settings → Open API, and allow LAN access.
-
Will my settings and login survive an upgrade? Yes. Config and login token live in
%LocalAppData%\MuSync\config.json, separate from the program files, and are picked up automatically after replacing the program (the token is DPAPI-encrypted, so the same PC and user won't need to sign in again). -
Config or login state looks broken If config parsing fails, the app backs it up automatically (
config.json.bak) and keeps as much as it can. Logs are in%LocalAppData%\MuSync\logs(Settings → Diagnostics → "Open logs folder"). -
Found a problem or have a suggestion? Please open a GitHub Issue — attaching the output of Settings → Diagnostics → "Copy diagnostics" helps a lot.
-
How do I uninstall MuSync? Installer edition: uninstall from Windows "Settings → Apps", or via the Start Menu shortcut. The uninstaller removes the program files only — your config and logs in
%LocalAppData%\MuSyncare kept; delete that folder for a complete cleanup. Full and lite editions: just delete the program file.
Before you hand your Steam account to MuSync, please read SECURITY.md: the sign-in flow, what it reads, network traffic, the risks, and how to revoke access — all explained honestly.
MuSync's player memory-reading implementation descends from an open-source lineage (all MIT licensed):
MuSync (this project)
└─ wuyan1337/yySync ............... direct base (the Steam-sync edition)
└─ kriYamiHikari/Music-DiscordRPC
└─ Kxnrl/NetEase-Cloud-Music-DiscordRPC
└─ Copyright (c) 2018 Kyle's original project
Only the player memory-reverse-engineering (NetEase pattern scan / QQ Music offsets / the LX interface) comes from that lineage; everything else — including the KuGou reader, the connection layer, state arbitration, display engine, app sync, config and security systems — is implemented independently by this project. As a note: the Chinese description 「半新写」 literally means "only half rewritten" — it refers to this lineage, not to a project name. For the full list of changes relative to yySync, see CHANGELOG.md.
dotnet build MuSync.sln -c Release # build
dotnet test MuSync.sln # unit tests
# Portable single-file publish (bundled .NET runtime)
dotnet publish MuSync.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:EnableCompressionInSingleFile=true -o publish
# Installer (requires Inno Setup 6.5+)
powershell -ExecutionPolicy Bypass -File installer\build.ps1CI (on main push / v* tag) builds three artifacts: MuSync.exe (portable, full edition), MuSync-lite.exe (lightweight, requires .NET 10 runtime), and MuSync-Setup.exe (installer edition).
MuSync.csproj # main app (WinForms)
Program.cs # entry point / tray / update checks
MainForm / SettingsForm # main window / settings dialog (single window, tabs)
FormatBlockEditorForm # block editor
UpdateForm # update dialog (download / open release page)
SteamLoginForm # Steam sign-in window
Players/ # player readers (NetEase / QQ / LX Music / KuGou)
Utils/ # foreground watcher / classifier / template codec / updates / logging / DPAPI etc.
Models/ # data models
Win32Api/ # Win32 / process memory access
installer/ # Inno Setup installer script and local build
tools/ # icon generator script (make-icon.ps1)
tests/MuSync.Tests/ # xUnit unit tests
reference-yySync/ # upstream reference source (MIT; not compiled, for comparison only)
MuSync is built on an open-source lineage (see "Relationship to upstream" above), with thanks to everyone who paved the way:
- wuyan1337/yySync — the direct base
- kriYamiHikari/Music-DiscordRPC
- Kxnrl/NetEase-Cloud-Music-DiscordRPC
- SteamRE/SteamKit — Steam network protocol support
Released under the MIT license, see LICENSE. Full third-party license texts are in THIRD-PARTY-NOTICES.md.