Download Latest Version koel-v7.15.1.tar.gz (34.8 MB)
Email in envelope

Get an email when there's a new version of koel

Home / v7.15.0
Name Modified Size InfoDownloads / Week
Parent folder
koel-v7.15.0.tar.gz 2025-09-09 34.7 MB
0
koel-v7.15.0.zip 2025-09-09 43.1 MB
0
README.md 2025-09-09 2.5 kB
0
v7.15.0 source code.tar.gz 2025-09-09 10.6 MB
0
v7.15.0 source code.zip 2025-09-09 11.4 MB
0
Totals: 5 Items   99.8 MB 0

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:

    ```bash

    !/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

Source: README.md, updated 2025-09-09