Run shuffleset on your own server.

Setup

Mount your library roots.

Create a working folder, download the compose file, point AUDIO_DIR and VIDEO_DIR at your library roots, then start Docker Compose. Those roots can contain any number of artists, sets, shows, and episodes. The image is hosted in the Noise Factor registry, so Docker needs registry access before it can pull. By default Caddy listens at http://localhost:8080 and proxies to shuffleset.

mkdir shuffleset
cd shuffleset
curl -fsSLO https://shuffleset.stream/selfhost/docker-compose.yml
mkdir -p audio video

cat > .env <<'EOF'
AUDIO_DIR=./audio
VIDEO_DIR=./video
SITE_URL=http://localhost:8080
EOF

docker login registry.noisefactor.io
docker compose up -d

Library model

Content is config-driven.

Add as many artists, audio sets, shows, and gallery episodes as you want. Each folder has an index.json file for titles, descriptions, ordering, visibility, and file lists.

Content types. Audio sets are track lists. Video episodes are clip lists. Slideshow episodes play images or videos full-screen in sequence.

Presentation modes. Playlist. The default episode view is a player that moves through the files list. Gallery. Set "style": "gallery" for a browsable grid and lightbox. Set "style": "slideshow" for a full-screen sequence.

audio/
  artist-slug/
    index.json
    live-set/
      index.json
      mp3/
        track-01.mp3

video/
  artist-slug/
    index.json
    visual-show/
      index.json
      episode-one/
        index.json
        files/
          clip-01.mp4
      gallery-episode/
        index.json
        files/
          image-01.jpg

Index files

Use JSON to name and order things.

Artist indexes can define sets_order and shows_order. Set, show, and episode indexes define metadata and files. If a files list is omitted, shuffleset scans the folder.

{
  "metadata": {
    "title": "Gallery Episode",
    "description": "Photos and short clips",
    "style": "gallery"
  },
  "files": [
    { "file": "image-01.jpg", "title": "Image 01" },
    { "file": "clip-01.mp4", "title": "Clip 01" }
  ]
}

{
  "sets_order": ["live-set", "studio-set"],
  "shows_order": ["visual-show", "tour-diary"]
}