RepoRadar Tagr: управление и редактирование метаданных музыкальных файлов
Tagr — это саморазвёртывающееся веб-приложение для управления и редактирования метаданных музыкальных файлов. Оно позволяет тебе без лишних зависимостей, используя любой браузер, просматривать свою музыкальную библиотеку, играть треки и вносить изменения в теги непосредственно в аудиофайлы.
Основное отличие Tagr — это интуитивно понятный интерфейс с тремя панелями, где можно легко организовывать свою коллекцию, редактируя более 40 полей метаданных, включая пользовательские теги и обложки альбомов. На фоне традиционных настольных приложений и CLI-утилит, Tagr предлагает более доступный и современный подход к работе с музыкальным контентом.
Проект построен на Next.js и React, использует Prisma с SQLite и node-taglib-sharp. Для его запуска потребуется установить зависимости и развернуть приложение на своем сервере. Обрати внимание, что функциональность работает только в локальной среде, а публичная демо-версия ограничена редактированием данных.
Tagr — это саморазворачиваемый редактор метаданных музыки с современным и интуитивно понятным веб-интерфейсом. С его помощью можно просматривать, редактировать и управлять тегами аудиофайлов через любой браузер — как с настольного компьютера, так и с мобильного устройства. Просто укажи папки с музыкой, и ты получишь чистый интерфейс для организации своей музыкальной библиотеки без необходимости в настольных приложениях или сложных командных строках.
Основные функции
- Редактирование метаданных: Более 40 метаданных полей для редактирования, включая название, исполнителя, альбом, год, жанр и обложки альбомов.
- История изменений: Полная аудитория всех изменений с возможностью отката отдельных изменений или группы редактирований.
- Встроенный музыкальный плеер: Интерактивная визуализация звуковой волны, возможность воспроизведения, паузы и навигации между треками.
- Управление библиотекой: Трехпанельный интерфейс с возможностью сортировки, фильтрации и настраиваемых столбцов.
- Поддержка пользователей и ролей: Несколько пользователей с разными правами доступа, такими как администраторы и слушатели.
- Поддерживаемые форматы файлов: MP3, FLAC, WAV, AAC, OGG и другие.
- Мобильная поддержка: Полностью адаптивный интерфейс для мобильных устройств с удобным редактированием и просмотром.
Установка и запуск
Tagr можно установить несколькими способами: через Docker или вручную. Для установки с помощью Docker нужно выполнить следующие шаги:
1. Склонировать репозиторий:
wget https://raw.githubusercontent.com/suitux/Tagr/main/docker-compose.yml
2. Сгенерировать секретный ключ:
openssl rand -hex 32
3. Настроить файл docker-compose.yml с нужными параметрами.
4. Построить и запустить контейнер:
docker compose up -d
5. Открыть браузер и перейти по адресу http://localhost:3000.Для ручной установки необходимо иметь Node.js версии 22 и выше, после чего нужно выполнить следующие команды:
git clone https://github.com/suitux/Tagr.git
cd tagr
pnpm install
pnpm build && pnpm start # для продакшна
# или
pnpm dev # для разработкиОграничения и требования
Tagr имеет некоторые ограничения и требования к системе:
- Потребляется Node.js 22+ для ручной установки.
- Конфигурацию необходимо проводить через переменные окружения, такие как `DATABASE_URL` для подключения к базе данных и `AUTH_SECRET` для защиты JWT-сессий.
- Количество поддерживаемых форматов файлов и функциональность может варьироваться — в зависимости от текущей версии проекта.
В документации также упоминается, что если вы запускаете Tagr на сервере, необходимо учитывать настройки хостинга, особенно для правильной работы с правами пользователей и доступом к аудиофайлам.
Скробблинг
Tagr может интегрироваться с ListenBrainz для отправки информации о прослушанных треках. Для этого каждому пользователю нужно будет настроить свой токен ListenBrainz в настройках приложения. Все отправляемые данные шифруются, а при недоступности ListenBrainz, записи сохраняются в очереди и автоматически отправляются при следующем прослушивании.
Tagr — это мощный инструмент для управления музыкальными метаданными, который подойдет тем, кто хочет организовать свою музыкальную коллекцию, не углубляясь в сложные параметры и настройки.
Открыть на GitHub: suitux/Tagr →
