Koel (он же Коэли) – это певчий род птиц родом из Азии, Австралии и островов Тихого Океана. Довольно крупные представители семейства кукушковых, которые, по словам проживающих в этих краях людей, поют буквально день на пролёт. Именно в честь этой птицы было названо веб-приложение, о котором сегодня будет идти речь.
В нашем случае Koel – это домашнее музыкальное облако (или персональный стриминговый сервис), призванное для многих заменить такие сервисы, как Spotify, Apple Music и многие другие. Безусловно, полностью состоящие из медиабиблиотеки самого пользователя.
Доступность на платформах
Cloudron | YunoHost | CapRover |
+ | – | +* |
Установка Koel
Cloudron: доступен в качестве “приложения в 1 клик”. Для установки необходимо перейти в Магазин приложений, найти Koel в поиске и нажать “Установить”. Остальное Cloudron сделает за Вас.
Другие способы установки: Также вы можете установить Koel самостоятельно, не прибегая к помощи self-hosted платформ. Подробнее процесс установки описан в документации приложения.
Первичная настройка
Первым же делом после установки необходимо определить директорию для музыкальной библиотеки.
Koel необходима локальная директория, но также есть возможность настроить S3 бакет в качестве удалённого хранилища. Это полезно в том случае, если вы не располагаете большими дисковыми ресурсами у провайдера VPS и не хотите переплачивать за фиксированное место.
После того, как вы разобрались с расположением Вашей библиотеки, требуется загрузить сами аудио-файлы (что логично) либо через FTP/SFTP, либо с использованием веб-интерфейса. Второй вариант доступен только для пользователей с ролью администратора.

В последнюю очередь необходимо запустить сканирование директории с файлами. Koel поддерживает обновление библиотеки в двух форматах:
- Вы загружаете файлы в нужную директорию и единоразово сканируете её через настройки (изображение выше). Каждый раз при добавлении новых аудиозаписей это нужно проделывать повторно;
- Вы настраиваете Koel на периодическую проверку директории и не беспокоитесь о том, что вы забыли что-то дополнительно нажать. Сделать это можно, например, добавить в файл
crontab
следующую задачу:
0 0 * * * cd /home/user/webapps/koel/ && /usr/local/bin/php artisan koel:sync >/dev/null 2>&1
С этого момента вы готовы к прослушиванию любимой музыки.
Пользовательский интерфейс
Что можно сказать об интерфейсе? Koel имеет достаточно прямолинейный UI, схожий с другими стриминговыми сервисами, но при этом не перегруженный лишними деталями.

Всего доступно 4 зоны:
- Левая панель, содержащая поле поиска, меню категорий и плейлистов, а также обложку трека с кнопками Play / Pause;
- Непосредственно вид библиотеки для выбора проигрываемого материала. Есть выбор между полным списком треков, перечнем альбомов или артистов;
- Правая панель для информации из Last.fm, включая данные об исполнителе, текст песни и пр.;
- Нижняя панель с информацией о треке, кнопками регулировки громкости и эквалайзером.
В настройках пользователя можно выбрать тему интерфейса, включая несколько простых цветовых схем и ряда красивых пользовательских изображений. Добавить свои темы не получится, но уже существующих хватит на любой вкус.

Что касается использования на мобильных устройствах, здесь разработчик предлагает как адаптированный веб-интерфейс (с некоторыми нерабочими фишками, вроде эквалайзера), так и полноценное мобильное приложение.
К сожалению, русского языка разработчики не предусмотрели, но это не особо мешает пользованию.
Опыт использования Koel
В целом Koel спокойно “съедает” достаточно большую библиотеку музыкальных файлов и без проблем отображает вшитые в файлы тэги.
Сам же сервис не поддерживает редактирование тэгов и прочей информации, но способен заменить обложку при необходимости. Для этого надо лишь перенести картинку в область отображения обложки в GUI плеера. Остальная информация может “подтягиваться” при наличии интеграции с Last.fm.

Что определённо придётся по вкусу любителям послушать разной музыки, так это возможность создавать “Умные плейлисты”. Работают они достаточно просто, вы задаёте группы критериев по которым Koel автоматически отберёт композиции и добавит их в плейлист. Хотите конкретный жанр? Без проблем. Хотите вернуть 2007 год? Раз плюнуть.
Ещё в Koel есть встроенный эквалайзер. Он достаточно прост в использовании и позволяет пользоваться уже готовыми стандартными пресетами (Рок, Танцевальная музыка, Джаз, Полный басс и др.). Также можно настроить каналы по своему усмотрению, однако будьте готовы, что при смене пресета на любой стандартный все ваши настройки сбросятся.
Мобильное приложение
Одной из особенностей Koel является наличие мобильного приложения для устройств на Android и iOS. Приложение это не бесплатное и обойдётся вам единоразово в 899 рублей для устройтсв Apple или 869 рублей для телефонов с Android.
Уже сейчас в Koel для мобильных устройств реализован следующий функционал:
- Проигрывание музыки и очередь вопроизведения;
- Отметка “Понравившиеся;
- Управление плейлистами;
- Просмотр текста песен и информации (в том числе с интеграцией Last.fm)
Более того, мобильное приложение позволяет кэшировать музыку для оффлайн произведения, чего не позволяет делать веб-версия на мобильных устройствах.

Чего не хватает в Koel?
Koel, безусловно, сможет заменить вам любой стриминговый сервис, если вам не нужен лишний функционал, а где-то на внешнем жёстком диске завалялась библиотека из 50+ ГБ музыкальных файлов. Остальные же заметят определённые ограничения, которых нет у других конкурентов (например Navidrome).
Во-первых, нет официально заявленной поддержки любых форматов, кроме mp3. Любители lossless музыки или держатели библиотеки из iTunes в формате AAC должны искать другой подобный сервис.
.mp3
, .ogg
, .aac
, .m4a
, .opus
разработчик также заявляет экспериментальную поддержку lossless музыки в формате .flac
.Во-вторых, нет поддержки плейлистов в формате .m3u. Только создание через веб-интерфейс.
В-третьих, отсутствие поддержки API Subsonic/Ampache, которая бы позволила использовать любой клиент или приложение, а не только собственную разработку.
А ещё сервис отличился отсутствием какого-либо декодирования музыкального потока (для экономия трафика). Мелочь, но неприятная.
Вердикт
Koel – это хороший сервис для непритязательных пользователей, желающих получить доступ к своей медиатеке откуда угодно. Несмотря на всю свою простоту, безусловно советую пробовать его в виде Docker контейнера или приложения в Cloudron, так как для точечной настройки вам скорее всего придётся использовать терминал, а также провести некоторое время в документации.
Кратко резюмируя, можно составить следующую таблицу: