Перейти к основному содержимому
Версия: 15.x

Как добавить обложки

Вы можете добавлять собственные обложки для папок и плейлистов, чтобы ваш интерфейс отображал пользовательские миниатюры вместо стандартных изображений по умолчанию.

В этом руководстве объясняется:

  • какие форматы изображений поддерживаются
  • как называть файлы обложек
  • где размещать эти файлы
  • что происходит, когда изображение плейлиста отсутствует

Поддерживаемые форматы изображений

Поддерживаются следующие типы файлов, которые проверяются в указанном порядке. Используется первый подходящий файл изображения:

  • webp
  • png
  • jpeg
  • jpg
  • bmp
  • gif

Вы можете использовать любой из этих форматов как для обложек папок, так и для обложек плейлистов.

Папка

Чтобы установить обложку для папки, поместите файл изображения с именем folder.ext внутрь этой папки.

Замените .ext на одно из поддерживаемых расширений.

Примеры:

  • папка.webp
  • папка.jpg
  • папка.png

Плейлисты

Чтобы установить обложку для плейлиста, используйте то же базовое имя файла, что и у файла плейлиста.

Пример:

  • Файл плейлиста: Jazz.m3u8
  • Файл обложки: Jazz.jpg (или Jazz.webp, Jazz.png и так далее)

Если подходящий файл обложки для плейлиста не найден, в качестве запасного варианта используется обложка папки.

Пример структуры папок

Используйте это в качестве примера:

Music/
|-- folder.jpg
|-- Jazz/
| |-- folder.png
| |-- Jazz.m3u8
| |-- Jazz.jpg
| |-- Smooth.m3u8
| `-- smooth-track01.mp3
`-- Rock/
|-- folder.webp
|-- RockHits.m3u8
`-- track01.mp3

В этом примере:

  • Music/folder.jpg — это обложка для папки верхнего уровня Music.
  • Music/Jazz/folder.png — это обложка для папки Jazz.
  • Music/Jazz/Jazz.jpg используется для плейлиста Jazz.m3u8.
  • Music/Jazz/Smooth.m3u8 не имеет соответствующего изображения Smooth.*, поэтому используется обложка папки Jazz.