Koel logo

Koel

Personal music streaming server that works

Alternative to: spotify, apple music, youtube music


About Versions (100)

v7.15.0

2025-09-09

What’s Changed

Upgrade

With #2086, Koel will now store and serve all generated and uploaded images (album covers, artist images, radio station logos, user avatars, etc.) in one unified public/img/storage directory. Thus, before upgrading:

  1. Make a backup of your public/img directory.

  2. Create a public/img/storage directory and move all (image) files under public/img/artists, public/img/covers, public/img/playlists, public/img/radio-stations, public/img/avatars there. You can do it manually or use a simple bash script like this for the task:

    #!/usr/bin/env bash
    set -euo pipefail
    
    BASE_DIR="public/img"
    DEST_DIR="$BASE_DIR/storage"
    SUBFOLDERS=("artists" "covers" "playlists" "radio-stations" "avatars")
    
    mkdir -p "$DEST_DIR"
    
    for folder in "${SUBFOLDERS[@]}"; do
      SRC="$BASE_DIR/$folder"
      [[ -d "$SRC" ]] || continue
    
      echo "Moving files from $SRC ..."
      mv -n "$SRC"/* "$SRC"/.* "$DEST_DIR"/ 2>/dev/null || true
    
      rmdir "$SRC" 2>/dev/null || true
    done
    
    echo "All done. Files are now in $DEST_DIR"

Everything else should go per usual.

New Contributors

Full Changelog: https://github.com/koel/koel/compare/v7.14.0…v7.15.0