Skip to content
Control Your Player
Branch: master
Clone or download
ondras Merge pull request #4 from tincho/node-version
mention required node version 10
Latest commit fbf98ad May 14, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
app external range Apr 30, 2019
misc systemd absolute exec Apr 26, 2019
.gitignore systemd service Apr 23, 2019
.npmrc mention required node version 10 May 13, 2019
LICENSE.txt license Apr 16, 2019
Makefile external range Apr 30, 2019 mention required node version 10 May 13, 2019
index.js tickets Apr 15, 2019
package.json mention required node version 10 May 13, 2019

CYP: Control Your Player

CYP is a web-based frontend for MPD, the Music Player Daemon. You can use it to control the playback without having to install native application(s). It works in modern web browsers, both desktop and mobile.



  • Control the playback, queue, volume
  • Save and load playlists
  • Browse the library by artists/albums/directories
  • Display album art via native MPD calls (no need to access the library; requires MPD >= 0.21)
  • Youtube-dl integration
  • Dark/Light themes


Make sure you have a working MPD setup first and Node version >= 10

git clone && cd cyp
npm i
node .

Point your browser to http://localhost:8080 to open the interface.


  • Connected to MPD via WebSockets (using the ws2mpd bridge)
  • Token-based access to the WebSocket endpoint (better than an Origin check)
  • Modern ES6+ (modules, async/await)
  • Responsive layout via Flexbox
  • CSS Custom Properties
  • SVG icons (Material Design)
  • Can spawn Youtube-dl to download audio files
  • Album art retrieved directly from MPD (and cached via localStorage)


  • Bundling
  • Range styling
  • Browser testing
You can’t perform that action at this time.