Документация

Как пользоваться музыкальной библиотекой

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

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

Доступные среды

  • Настольное приложение: использует полнофункциональный сканер папок и сохраняет доступ к выбранным папкам между запусками. Настольная версия также позволяет показать трек в папке на диске.
  • Браузеры Chromium на ПК с File System Access: сохраняют доступ к выбранным папкам после перезагрузки страницы (браузер может повторно запросить разрешение).
  • Мобильные браузеры, Safari, Firefox и другие браузеры без File System Access: сохраняют доступ к выбранным файлам только на время текущего сеанса страницы. Каталог остаётся в памяти приложения, но после каждой перезагрузки нужно заново выбрать папку или файлы, чтобы EffeTune переподключил их.

Музыкальная библиотека индексирует аудиофайлы распространённых форматов, таких как MP3, WAV, OGG, FLAC, Opus, M4A и AAC. Она также умеет разделять альбомный файл WAV или FLAC на отдельные треки по внешнему файлу CUE в той же папке.

Музыкальная библиотека также индексирует файлы .dsf и .dff. Чтобы найти их в уже добавленной папке, повторно просканируйте её; поддерживаемые варианты описаны в разделе Файлы DSD.

Чтобы включить файлы MP4, WebM, M4V, MOV, MKV и 3GP, включите параметр Включать видеоформаты в Музыкальную библиотеку в разделе Настройки > Конфигурация… > Общие, а затем добавьте или пересканируйте папку. По умолчанию эта настройка выключена; её переключение не изменяет уже созданный каталог сразу. Фактическая поддержка воспроизведения, включая аудиокодек внутри видеофайла, зависит от декодера браузера или ОС. Об отображении видео см. руководство по музыкальному проигрывателю.

Чтобы включить файлы MIDI/KAR (.mid, .midi, .kar) и MusicXML (.musicxml, .xml, .mxl), включите параметр Включать MIDI-файлы в Музыкальную библиотеку в тех же настройках, а затем добавьте или пересканируйте папку. По умолчанию эта настройка выключена; её переключение не изменяет уже созданный каталог сразу. Чтобы услышать эти файлы, добавьте SoundFont Player и загрузите инструмент либо выберите внешнее устройство в списке Устройство MIDI-вывода; см. MIDI-файлы и Файлы MusicXML. Воспроизведение MIDI и MusicXML и добавление этих файлов в библиотеку доступны в настольном приложении и веб-/PWA-плеере. В приложении Android эти функции не поддерживаются.

Эти настройки действуют только на Музыкальную библиотеку. Поддерживаемые файлы по-прежнему можно открывать напрямую в музыкальном проигрывателе.

Как открыть музыкальную библиотеку

  • Интерфейс для ПК: нажмите кнопку Музыкальная библиотека в шапке окна.
  • Мобильный интерфейс: откройте вкладку Библиотека на нижней панели навигации.
  • Настольное приложение: используйте также меню Вид > Музыкальная библиотека или сочетание Ctrl+L (Command+L в macOS).

Чтобы вернуться к цепочке эффектов, нажмите кнопку Effect Pipeline на ПК, переключитесь на вкладку Эффекты на мобильном устройстве либо выберите Вид > Effect Pipeline или Ctrl+E (Command+E в macOS) в настольном приложении.

Музыкальную библиотеку можно сделать стартовым экраном: откройте Настройки > Конфигурация… и установите Вид при запуске: в значение Музыкальная библиотека. В соседнем списке выберите раздел, который будет открываться первым: Треки, Файлы, Альбомы, Исполнители, Жанры, Подпапки, Папки или Плейлисты.

Как добавить музыкальную папку

  1. Откройте раздел Музыкальная библиотека.
  2. Нажмите Добавить папку с музыкой.
  3. Выберите папку с музыкальными файлами. На мобильных устройствах и в браузерах без прямого доступа к папкам диалог выбора может предложить выбрать содержимое папки вместо предоставления постоянного доступа к ней.
  4. Дождитесь окончания сканирования. В строке состояния отображаются число треков и альбомов, а также ход индексации.

При попытке добавить папку, которая уже находится внутри другой добавленной папки, EffeTune выдаст предупреждение вместо повторного индексирования. Если вы добавляете родительскую папку, внутри которой уже есть проиндексированные папки, EffeTune предложит объединить их в новую папку.

Просмотр и поиск

Переключайтесь между разделами коллекции с помощью вкладок навигации:

  • Треки: все проиндексированные треки (таблица с сортировкой на ПК и компактный список на мобильных устройствах).
  • Файлы: треки, упорядоченные по пути к файлу для прямого выбора. Треки из индексного листа CUE отображаются как отдельные записи.
  • Альбомы: альбомы, сгруппированные по метаданным треков.
  • Исполнители: исполнители и исполнители альбомов из метаданных (значения через точку с запятой, например Artist A; Artist B, индексируются для каждого исполнителя с сохранением полной строки в подписи).
  • Жанры: группы жанров из метаданных.
  • Подпапки: треки, сгруппированные по непосредственной родительской подпапке внутри каждой корневой папки (например, Artist/Album).
  • Папки: зарегистрированные корневые папки, статус их сканирования и иерархия папок.
  • Недавно добавлено: недавно проиндексированные треки.
  • Плейлисты: плейлисты, созданные или импортированные в Музыкальной библиотеке.

В разделе Папки откройте зарегистрированную корневую папку, чтобы просматривать вложенные папки в режиме Дерево, или переключитесь на Плоский список, чтобы вывести все треки этой корневой папки единым списком. В режиме Дерево цепочки одиночных вложенных папок без собственных треков объединяются в одну строку (например, Artist / Album) для быстрого перехода к папке альбома, а навигационная цепочка позволяет открыть любую промежуточную папку.

Используйте поле Поиск в библиотеке для фильтрации треков, альбомов, исполнителей и плейлистов. Запросы из трёх и более символов ищутся в любой части названия, исполнителя, альбома, жанра, имени файла или пути; запросы из одного-двух символов совпадают с началами слов. На ПК нажимайте заголовки таблицы (Номер трека, Название, Исполнитель, Альбом, Жанр или Время) либо используйте список Сортировка в других разделах. На мобильном устройстве порядок меняется через список Сортировка во всех представлениях, кроме сохранённых плейлистов.

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

Если теги отсутствуют, EffeTune использует имена файлов и папок. В окне Свойства трека отображаются путь к файлу, формат, частота дискретизации, битовая глубина, битрейт, метаданные, а для треков CUE — путь к файлу CUE и границы трека.

Альбомные файлы с CUE

Поместите внешний файл .cue в одну папку с файлами WAV или FLAC, на которые он ссылается, и добавьте или пересканируйте папку. Каждая корректная запись TRACK ... AUDIO появится в Музыкальной библиотеке как отдельный трек.

Для обложки Музыкальная библиотека сначала проверяет изображение, встроенное в исходный аудиофайл, а затем ищет рядом с файлом .cue файлы cover.jpg, cover.png, front.jpg, front.png либо изображение с именем аудиофайла.

Файл .cue можно также открыть напрямую из плеера (Открыть музыкальные файлы, Файл > Открыть музыкальный файл… в настольном приложении или Открыть музыку на мобильном устройстве):

  • Настольное приложение: выберите только файл .cue.
  • Браузер Chromium на ПК: если папка альбома уже добавлена в Музыкальную библиотеку и доступ к ней разрешён, выберите только файл .cue.
  • Другие браузеры: выберите файл .cue вместе со всеми файлами WAV/FLAC, на которые он ссылается, и только с ними, а при желании — и с подходящим изображением обложки.

Если файл CUE некорректен или указанные в нём аудиофайлы не найдены, EffeTune сообщит об этом и импортирует файлы WAV или FLAC целиком как одиночные треки. Исправьте файл CUE или имена файлов в нём и повторно просканируйте папку.

Воспроизведение из библиотеки

Выберите трек, альбом, исполнителя, жанр, подпапку, папку, результат поиска или плейлист и нажмите:

  • Воспроизвести, чтобы заменить текущую очередь плеера и начать воспроизведение.
  • Перемешать, чтобы воспроизвести выбранное в случайном порядке.
  • Воспроизвести следующим, чтобы вставить выбранное сразу после текущего трека.
  • Добавить в очередь, чтобы добавить выбранное в конец очереди.
  • Добавить в плейлист, чтобы добавить выбранное в плейлист Музыкальной библиотеки.

На ПК дважды щёлкните строку трека, чтобы начать воспроизведение с него, либо щёлкните правой кнопкой мыши / откройте меню Еще для дополнительных действий. На мобильном устройстве коснитесь трека для воспроизведения или удерживайте его для выбора нескольких треков.

Обновление и повторное подключение папок

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

Состояния папок в разделе Папки:

  • OK: папка готова к просмотру и воспроизведению.
  • Не сканировано: папка добавлена, но ещё не проиндексирована.
  • Не найдено: путь к папке больше не существует.
  • Подключить заново: снова требуется разрешение браузера или доступ к папке; нажмите Подключить заново и предоставьте доступ к той же папке.

Если трек библиотеки не открывается, потому что его папка недоступна, подключите папку заново или импортируйте её повторно.

Кнопка Удалить убирает папку только из каталога EffeTune; файлы на диске никогда не удаляются.

Плейлисты

Плейлисты Музыкальной библиотеки хранятся внутри EffeTune и могут объединять треки из любых проиндексированных папок:

  • Создавайте плейлист из выбранных треков библиотеки или сохраняйте текущую очередь плеера через Сохранить очередь как плейлист.
  • Управляйте плейлистами с помощью Переименовать, Дублировать и Удалить, а порядок треков меняйте перетаскиванием (или кнопками Переместить вверх / Переместить вниз).
  • Используйте Импортировать плейлист для файлов M3U, M3U8, PLS и XSPF, а внутри плейлиста — Экспортировать M3U8 или Экспортировать XSPF.

Недавно воспроизведённые и Избранное

После первого использования в сетке плейлистов появляются два автоматических плейлиста:

  • Недавно воспроизведённые: хранит последние 100 разных треков, воспроизведённых из Музыкальной библиотеки, от новых к старым.
  • Избранное: собирает треки, отмеченные значком ☆ рядом с треком на ПК или командой Добавить в избранное в меню Еще трека (на ПК оно открывается и щелчком правой кнопки мыши). Нажмите кнопку воспроизведения на карточке Избранное, чтобы сразу запустить его.

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

Импорт и экспорт плейлистов

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

При экспорте плейлиста включите Относительные пути, если планируете переносить экспортированный файл M3U8 или XSPF вместе с музыкальной папкой. Поскольку стандартные форматы M3U8 и XSPF не хранят границы подтреков CUE, треки CUE при экспорте пропускаются, а EffeTune сообщает их количество.

Безопасность и хранение данных

  • Музыкальная библиотека читает аудиофайлы и метаданные, не изменяя файлы на диске.
  • Очистка данных сайта в браузере удаляет каталог и плейлисты веб-приложения; экспортируйте важные плейлисты, чтобы сохранить их.
  • Большие коллекции подгружаются постепенно по мере прокрутки. Используйте Музыкальную библиотеку только в одном окне EffeTune одновременно.

Музыка в вашей сети (настольное приложение)

Используйте Library для просмотра этого устройства или найденного сервера, а список устройств в верхней части окна — для выбора, где будет звучать музыка. Смена медиатеки меняет только просмотр и область поиска. Добавление папок, повторное сканирование и другие локальные операции доступны при выборе This device.

В медиатеке другого EffeTune доступны привычные разделы Tracks, Albums, Artists, Genres, Subfolders, Files, Folders, Recently Added и Playlists. Ищите музыку в выбранной медиатеке, сортируйте списки и открывайте альбомы, исполнителей или жанры, чтобы увидеть их треки. В Folders используйте Tree для просмотра дерева папок или Flat, чтобы вывести все треки выбранной папки одним списком. Отображается только музыка, открытая для общего доступа. Удалённые плейлисты можно просматривать и воспроизводить; редактировать их нужно на компьютере-источнике.

Другие музыкальные серверы показывают категории и структуру папок, которые они публикуют; поиск и сортировка доступны только при поддержке сервером.

Серверы Subsonic / OpenSubsonic

На компьютере откройте Настройки > Конфигурация… > Сеть > Subsonic / OpenSubsonic. Заполните Название, URL сервера, Имя пользователя и Пароль, затем нажмите Добавить. Выберите сервер в Library, чтобы просматривать альбомы, треки и серверные плейлисты, искать музыку, воспроизводить её или добавлять в очередь выбранного устройства. Порядок и повторяющиеся треки сохраняются; редактируйте плейлисты на сервере. Проверить подключение проверяет сохранённое соединение, а Удалить отключает его.

В PWA выберите Library > Добавить музыкальный сервер… для прямого подключения по HTTPS. Сервер должен разрешать доступ браузера (CORS); подключение и вход действуют только в текущем сеансе. Для воспроизведения на другом устройстве или при недоступности прямого соединения добавьте сервер на зарегистрированном компьютере EffeTune и разрешите просмотр других серверов. Выберите медиатеку через этот компьютер; см. настройку PWA.

Приоритет отдаётся исходному аудио. Если нужно проигрывателю, используется преобразованный сервером поток; его формат и качество могут отличаться от сохранённого файла. EffeTune не добавляет кодеки и не преобразует звук самостоятельно. Форматы и перемотка зависят от сервера и проигрывателя.

Чтобы слушать треки Music Library на другом проигрывателе, сначала откройте доступ к её папке через Настройки > Конфигурация… > Сеть > Общий доступ к медиатеке. Форматы и эффекты зависят от устройства воспроизведения; фрагменты CUE недоступны как отдельные сетевые треки. Настройка, подключение эффектов и устранение проблем описаны в разделе сетевая музыка и дистанционное управление.

Чтобы воспроизвести отдельные локальные файлы без общего доступа к медиатеке, выберите другой проигрыватель и используйте Open music files. EffeTune предоставляет этому проигрывателю только выбранные файлы; оставьте приложение запущенным на исходном компьютере.

Общая музыка в PWA

PWA воспроизводит общую музыку зарегистрированного компьютера EffeTune и разрешённые сетевые медиатеки с эффектами этого устройства либо управляет разрешённым сетевым проигрывателем. Доступны и прямые подключения Subsonic. Локальные файлы PWA нельзя отправлять другому проигрывателю. Добавление устройств, разрешения браузера и условия подключения описаны в разделе настройки и воспроизведения через PWA.

← Назад к README