Skip to content

Repository files navigation

IXC Music - YouTube music player + control dock for OBS Studio

Download CI License: MIT Windows 10/11 OBS Studio

A free, lightweight music player that lives inside OBS Studio.
Search YouTube or paste YouTube / Spotify links from an OBS dock, and choose with one click whether Kick, Twitch or YouTube viewers hear it.

⬇ Download the latest release · Install guide · How to use · Troubleshooting

Important

IXC Music is now part of IXC 3, together with IXC ChatBox, in one program that also reads chat on its own (Streamer.bot is optional). New installs and updates come from infernoxc/ixc-chatbox.

  • New users: download IXC-Setup.exe from the IXC releases.
  • Using IXC Music 2.x: just run the IXC 3 setup. Your queue, settings and Spotify keys are moved over automatically, and the old phone tunnel program is removed (phones scan a new QR code once).
  • What IXC 3 adds to music: local music folders, a queue that survives OBS and PC restarts, song requests from chat with limits and cooldowns, Now Playing overlays and text files, and chat-voice ducking that always restores the volume.

This repository stays available for IXC Music 2.x. The rest of this page describes 2.x.


IXC Music dock inside OBS

Features

  • 🎯 Music goes to: ALL · TWITCH ONLY · KICK ONLY · YOUTUBE ONLY. One click really switches the OBS audio tracks of the player source, then IXC reads them back from OBS to confirm. It's instant, and nothing is added to the audio path.

  • 🔎 Search YouTube from OBS. No account needed.

  • 🔗 Paste links:

    • YouTube videos, Shorts, YouTube Music and playlists;
    • Spotify songs, matched to the same song on YouTube;
    • Spotify playlists and albums, with your own free Spotify developer key.

    Every link is checked first. Private, deleted, duplicate and unsupported links get a clear message.

  • 📜 Queue, 🔀 shuffle, 🔁 repeat, ♾️ autoplay similar songs, ▶️ start with OBS (resumes where it stopped).

  • 🛟 Robust playback: unexpected pauses resume by themselves; blocked, age-restricted or removed videos are skipped with the reason shown.

  • 📱 Phone remote from anywhere, including mobile data: now playing, controls, volume, the destination switch and adding songs.

  • 🪶 Light: one small native background program (IXC Core), with instant pushed updates and no polling. About 40 MB RAM and practically 0 % CPU.


Requirements

Windows 10 or 11 (Windows PowerShell 5.1 and .NET Framework 4.8 are built in)
OBS Studio 30 or newer (its built-in WebSocket server is used for the destination switch)
Internet Needed for YouTube
Tested on Windows 11 (build 26200) with OBS Studio 32.2.2 (obs-websocket 5.7.4)

Install

  1. Download IXC-Music-Setup-vX.Y.Z.exe or the portable .zip from Releases.
  2. Close OBS. Run the installer (or unzip and double-click Install.bat). No admin rights needed.
  3. In OBS, add the browser source and the dock:
Add in OBS URL Settings
Sources › + › Browser: "IXC Music Player" http://localhost:8767/music/player.html 320×180, ✅ Control audio via OBS, custom FPS 30, keep visible (move it off-canvas)
Docks › Custom Browser Docks: "IXC Music" http://localhost:8767/music/dock.html
  1. For the destination switch: OBS › Tools › WebSocket Server Settings › ✅ Enable. IXC reads the password from OBS's settings by itself.

The full guide, including the audio-track setup for multistreaming, is in docs/INSTALL.md.

Honest limitations

  • Spotify can't be streamed into OBS (its audio is DRM-protected, and its terms don't allow broadcasting). IXC Music finds the same song on YouTube instead. Without Spotify keys the match uses the title only, so it can pick a different version.
  • Spotify playlists and albums need your own free Spotify developer app (how). Spotify doesn't give apps its own editorial or algorithmic playlists (Top 50, Discover Weekly…), or private playlists.
  • YouTube search and "similar songs" read YouTube's public web pages. That can break when YouTube changes them. You can add an official YouTube Data API key for search. Links are always checked with YouTube's official oEmbed service.
  • Age-restricted and region-blocked videos pass the link check but can't play outside youtube.com; they're skipped with the reason when they come up.
  • The destination switch changes which OBS tracks carry the music. Which track goes to which platform is set in your OBS output or multistream plugin (default map: Twitch 1, Kick 2, YouTube 3; you can change it).

Documentation

Install · Usage · Configuration · Troubleshooting · Update and uninstall · Architecture and API · Releasing

Build from source

git clone https://github.com/infernoxc/ixc-music.git
cd ixc-music
powershell -ExecutionPolicy Bypass -File tests\smoke.ps1 -Online     # tests (builds IXC Core in a temp folder)
powershell -ExecutionPolicy Bypass -File scripts\install.ps1         # install from source
powershell -ExecutionPolicy Bypass -File build\build.ps1 -Installer  # dist\ ZIP + Setup.exe (needs Inno Setup 6)

⚠️ Music copyright

Most commercial songs are copyrighted. Streaming them can get VODs muted or your channel struck. Use music that's licensed for streaming (for example NCS or StreamBeats), and follow your platform's rules.

Works great with

IXC ChatBox: Twitch, Kick and YouTube chat in one OBS dock, with replies and chat TTS. Both share the same IXC Core.

License and credits

Code © 2026 Ishan (InFerNoxC), released under the MIT License. This project uses YouTube's embedded player, oEmbed and public pages, Spotify's oEmbed and Web API, OBS Studio and Cloudflare's tunnel. Those belong to their owners and have their own terms: see THIRD-PARTY-NOTICES.md. Not affiliated with or endorsed by YouTube/Google, Spotify, the OBS Project or Cloudflare.

Made by InFerNoxC, built for streamers who want music without losing FPS.

About

Free, lightweight YouTube music player + control dock for OBS Studio on Windows: search, queue, autoplay, start-with-OBS. No API key.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages