SUPYSONIC-SERVER(1)

📦
version 0.7.9 · 4 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💖 SUPYSONIC-SERVER 💖

okay bestie, welcome to supysonic-server — the Supysonic era of your life starts here. It's a Python implementation of the Subsonic server API, and it's literally the moment. 🎀

✨ SYNOPSIS ✨

supysonic-server [--server gevent | gunicorn | waitress] [--host <hostname>] [--port <port>] [--socket <path>] [--processes <n>] [--threads <n>]

like, that's it. that's the whole incantation. 💅

🌸 DESCRIPTION 🌸

so supysonic-server is the main character of the Supysonic operation — it's the component that actually serves content to your clients. ✨

under the hood? ngl, it's a basic wrapper over Gevent, Gunicorn or Waitress. and here's the vibe check: you need at least one of them installed for it to run at all. no WSGI server, no party. 🙈

💅 OPTIONS 💅

  • -S <name>, --server <name> — tells it which WSGI server to use. <name> has to be one of gevent, gunicorn or waitress, and the matching package must actually be installed, okay? if you don't pass this option, it'll just grab the first one it finds available. lowkey considerate of it. 🦋
  • -h <hostname>, --host <hostname> — the hostname or IP address to listen on. default is 0.0.0.0, which means listen on all IPv4 interfaces on this host (very "open to everyone" energy fr fr). Cannot be used with --socket. 🚫
  • -p <port>, --port <port> — the TCP port to listen on. default is 5722 ✨ (memorize it, bestie). Cannot be used with --socket.
  • -s <path>, --socket <path> — path of a Unix socket to bind to. if you give a path here, it makes a Unix domain socket instead of the usual inet domain socket. Cannot be used with --host or --port. and heads up — not available on Windows. 😭
  • --processes <n> — number of worker processes to spawn. only applicable when you're using the Gunicorn WSGI server. 👑
  • --threads <n> — the number of worker threads for handling requests. only applicable when using the Gunicorn or Waitress WSGI server. 🔥

🐛 BUGS 🐛

found a bug? not the vibe, but it happens. report it to your distribution's bug tracker, or upstream at ‐ https://github.com/spl0k/supysonic/issues. 🫶

👀 SEE ALSO 👀

  • supysonic-cli (1)

go read that one too, iykyk. 💜

🌈 AUTHOR 🌈

Alban Féron — the icon, the legend. ⭐

2013-2023, Alban Féron

okay and one last thing, my love: this whole thing is Supysonic version 0.7.9, dated Apr 15, 2025 — that's the source, that's the version, that's the date, no cap. slay, go stream some music. 🎀💖✨

📦 where this page comes from