Перейти к содержанию

Первые шаги

Для кого: Для тех, кто впервые настраивает локальную фонотеку. Задача: Пройти путь от исходного кода до базы SQLite, готовой к поиску и анализу. Тип: Оглавление учебного раздела

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

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

Результат каждого шага

  1. Сканирование превращает дерево папок в фонотеку, которую можно просматривать и фильтровать.
  2. Анализ добавляет данные для поиска по звучанию и черновиков сета.
  3. Поиск сокращает большую коллекцию до списка для прослушивания.
  4. SET или подборка превращает полезных кандидатов в редактируемый рабочий список.
  5. Экспорт создаёт M3U или CSV для следующего этапа вашей работы.

Страницы раздела

  • Быстрый старт: кратчайший путь через сканирование, запуск сервера и первый анализ.
  • Установка: требования, дополнительные пакеты, FFmpeg и сборка интерфейса и документации.
  • Первая фонотека: устройство сканирования и содержимое базы данных.
  • Первый анализ: выбор анализа по желаемому результату, лимиты и вычислительное устройство.

Что понадобится

  • Локальная папка с аудиофайлами.
  • Локальный путь, по которому приложение сможет создать или открыть базу SQLite.
  • FFmpeg в PATH либо переменная DJ_TRACK_SIMILARITY_FFMPEG.
  • Дополнительные зависимости моделей, если нужен анализ SONARA, MAEST, MERT, MuQ или CLAP.

Привычка, которая помогает сохранить приватность

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

Документация локального инструмента анализа музыкальной библиотеки.