Заново откройте музыку на своём компьютере
Найдите следующий трек, не отдавая свою фонотеку облачному сервису
Превратите большую локальную коллекцию в фонотеку с удобным поиском. Начните со знакомого трека или описания идеи, а затем соберите подходящих кандидатов в подборку или черновик сета.
Приложение не загружает вашу коллекцию в интернет и не решает за вас, какое сведение будет хорошим. Оно помогает превратить большую папку с музыкой в короткий список треков, которые стоит послушать вместе.
Бэкенд Python и CLI используют новую схему v7: Core, обязательную базу Artifacts и необязательную Evaluation. Старые схемы не мигрируют. Перенос React отложен, поэтому для актуального контракта v7 используйте CLI или прямой API.
Идея проекта
Проект вырос из личной задачи: в большой локальной коллекции легко потерять именно тот трек, который сейчас нужен, даже если он уже лежит на диске. dj-track-similarity помогает заново открывать такую музыку с помощью тегов, аудиопризнаков, эмбеддингов, текстовых запросов и необязательных персональных классификаторов.
Более широкая цель — драматургия диджейского сета. Сет может быть не просто последовательностью технически совместимых треков, а историей со вступлением, напряжением, разрядкой, главами и финальной точкой. Приложение предлагает кандидатов для прослушивания, но последнее музыкальное решение всегда остаётся за диджеем.
Это прежде всего личный любительский проект. Автор не претендует на экспертность в машинном обучении или поиске музыкальной информации, а результаты моделей здесь следует воспринимать как локальные данные для ранжирования, а не как истину. Подробнее об идее проекта.
Что можно делать
Выберите знакомый трек и прослушайте упорядоченный список близких треков из собственной коллекции.
Опишите ритм, фактуру, инструменты, пространство или энергию, если подходящего референсного трека нет.
Превратите несколько опорных точек в редактируемую последовательность с выбранным движением энергии, темпа и разнообразия.
Разметьте важный для вас признак и применяйте его как фильтр фонотеки или мягкое предпочтение в SET.
Обычный путь
Рабочий процесс остаётся локальным
Создайте базу и просканируйте папку. Добавьте результаты моделей, которые нужны для вашей задачи. После этого ищите музыку и экспортируйте проверенные подборки. Приложение ранжирует кандидатов, а окончательный выбор по-прежнему делается на слух.
- 01СканированиеСделайте папку доступной для просмотра, не перемещая аудиофайлы.
- 02АнализПодготовьте сравнения звучания, необходимые для вашей задачи.
- 03ПоискПревратите треки, слова или личные критерии в короткие списки.
- 04ЭкспортПередайте проверенный список в следующую часть своего рабочего процесса.
Что читает приложение
- Пути к аудиофайлам и сведения о файлах.
- Доступные через Mutagen теги: исполнитель, название, альбом, жанр, год, BPM, тональность, лейбл, номер в каталоге, комментарии, ISRC, длительность и данные о формате.
- Декодированное аудио во время анализа, предварительного прослушивания или работы инструментов обслуживания.
Что приложение записывает по умолчанию
Большинство сценариев записывает только данные в локальные базы SQLite и локальные отчёты. Сканирование, Refresh Tags, анализ, поиск, прослушивание, сброс, очистка, предварительная проверка переноса путей, расчёт классификаторов и экспорт не изменяют исходные аудиофайлы.
Операции, которые действительно работают с файлами, выделены отдельно:
- MAEST genre tag apply записывает стандартное поле жанра в аудиофайл.
- Audio Doctor apply исправляет только ранее обнаруженные исправимые файлы, после предварительной проверки и точного подтверждения.
- Audio Dedup apply удаляет подтверждённые дубликаты только после точного подтверждения.
Применение переноса путей фонотеки изменяет лишь tracks.file_path в SQLite и не перемещает файлы.
Поиск, SET, прослушивание, анализ, сброс и экспорт не редактируют исходные файлы.
Запись жанра, применение Audio Doctor и применение Audio Dedup вынесены в отдельные защищённые сценарии.
Базы SQLite, отчёты, журналы, индексы и файлы классификаторов остаются на диске.
С чего начать
- Быстрый старт: сканирование, запуск интерфейса и анализ первой партии.
- Установка: требования, необязательные ML-зависимости и сборка.
- Первая фонотека: создание фонотеки в SQLite и поведение сканирования.
- Первый анализ: выбор анализа по желаемому результату.
- Подготовка и пересоздание релиза SONARA: резервное копирование и активация четырёх результатов до повторного анализа.
- Руководство пользователя: ежедневная работа в интерфейсе.
- Сценарии: практические маршруты для диджейских задач.
- Основные понятия: оценки, модели, безопасность и построение маршрута.
- Инструменты и скрипты: Rhythm Lab и инструменты обслуживания и отчётности.
- Справочник: CLI, API, конфигурация, база данных, анализ и интерфейс.
- Помощь: решение проблем, частые вопросы и известные ограничения.