Studios
Audio Propshouse-3.jpg

Song Conversion

SoonAudio PropsQbox
PAGE 07 OF 07  ·  COMMANDS & EXPORTS → SONG CONVERSIONdocs.glitchstudios.dev
Browse docs

Off by default. With it on, songs from YouTube, SoundCloud, Spotify (matched on YouTube) and the sites in Config.Convert.webSites are downloaded with yt-dlp and stored on your own Cloudflare R2 bucket, after which every DJ effect works on them. Files nobody has played for Config.Convert.keepDays days are deleted again.

  1. Put yt-dlp in bin/ (on Linux, make it executable).
  2. Copy server/r2.json.example to server/r2.json and fill in your R2 keys.
  3. Add add_unsafe_child_process_permission glitch-audioProps to server.cfg.
  4. In config.site.lua, set Config.Convert.enabled = true, Config.Convert.mirrorFiles = true and Config.Convert.publicBase to your bucket address.
  5. Fully restart the server. The console prints YouTube conversion ready when it works.

Without server/r2.json, conversion, mirroring and TV video downloads switch themselves off, and the console says so once.

[!WARNING] Downloading from YouTube and similar sites, and the Twitch relay (Config.TV.twitchRelay), may break those sites' terms of service and copyright law where you are. Both are off by default. If you switch them on, you are responsible for what your players add.