Código abierto, AGPL-3.0, self hosted
El editor de metadatos de música self hosted para toda tu biblioteca
Escanea tus carpetas de música y explora, filtra, reproduce y edita etiquetas de MP3, FLAC, M4A y Opus desde el navegador. Funciona en Docker. Tus archivos nunca salen de tu servidor.
demo / demo, solo lectura
docker run -d -p 3000:3000 -v /ruta/a/tu/musica:/music ghcr.io/suitux/tagr:latest
- AGPL-3.0
- amd64 y arm64
- Sin telemetría
- SQLite, sin base de datos externa
- Funciona en el móvil
Por qué usar un editor de metadatos de música self hosted
Tu música, tu servidor.
Sin nube, sin cuentas, sin subidas. Tagr escribe las etiquetas directamente en los archivos de tu NAS.
Pensado para bibliotecas grandes.
El scroll virtual y el índice en SQLite aguantan decenas de miles de pistas sin despeinarse.
Edita desde donde quieras.
Solo hace falta un navegador. Nada de Wine, nada de VNC, nada de editores de escritorio.
Un editor de etiquetas MP3 autoalojado que hace el trabajo entero
Edita más de 40 campos de metadatos.
Título, artista, álbum, año, género, compositor, BPM, letras, campos de ordenación, números de catálogo, códigos de barras. Añade tus propias etiquetas personalizadas más allá del conjunto estándar. Gestiona la carátula: verla, sustituirla, subirla. Valoración de 1 a 5 estrellas. Códec, bitrate, frecuencia de muestreo, canales y profundidad de bits en modo lectura.
Historial completo con reversión en un clic.
Cada cambio queda registrado con su valor anterior y el nuevo. Revierte una edición, o selecciona con shift y ctrl para deshacer decenas de golpe. Hay historial por canción y por carpeta.
Reproductor integrado con onda.
Una onda de WaveSurfer.js con clic para saltar, play y pausa, anterior y siguiente, avance automático. Un reproductor lateral plegable con carátula. Escucha la pista que estás etiquetando sin salir de la página.
Explora una biblioteca de cualquier tamaño.
Tres paneles redimensionables: árbol de carpetas, lista de canciones y editor de detalle. Ordena por cualquier columna. Filtra por texto, rango numérico, rango de fechas o valor booleano. Muestra u oculta cualquiera de las más de 40 columnas. Scroll virtual y paginación infinita.
Comparte la biblioteca, no la contraseña.
Cada persona con su propia cuenta. La de administrador sale de tu fichero de entorno; el resto se crean dentro de Tagr con un rol: un Tagger navega, escucha, edita metadatos y reescanea; un Listener solo navega y escucha. La interfaz oculta lo que el rol no puede hacer y la API lo comprueba en cada petición. El historial de escuchas y las reproducciones se guardan por usuario.
Envía tus escuchas a ListenBrainz.
Pega tu token de ListenBrainz una vez y cada reproducción llega a tu perfil, además del aviso de reproduciendo ahora mientras suena la pista. Cada usuario conecta su propia cuenta, los tokens se cifran antes de tocar la base de datos y las escuchas se encolan y reintentan si ListenBrainz no responde. Puedes apuntarlo a tu propio servidor compatible si también lo autoalojas.
Búsqueda en MusicBrainz
Compara canciones con MusicBrainz y elige exactamente qué campos aplicar.
Edición masiva
Selecciona muchas canciones, aplica los mismos cambios o carátulas de una vez, confirma y revisa el resumen.
Interfaz mobile first
Paneles a pantalla completa con gestos, reproductor expandido y acciones de edición siempre visibles. Se instala como PWA.
Listas personalizadas
Agrupa canciones al margen de la estructura de carpetas.
Detección de lossless
FLAC, WAV, AIFF y compañía reciben una insignia Lossless automática.
Estado en la URL
Carpeta, canción, orden y filtros viven en la URL. Guarda o comparte cualquier vista.
Autenticación multiusuario
Acceso protegido por contraseña, con gestión de usuarios incluida.
Oscuro por defecto
Porque vas a pasar un buen rato aquí dentro.
Formatos de audio compatibles: MP3, FLAC, M4A, Opus y más
- MP3
- FLAC Lossless
- WAV Lossless
- AAC
- OGG
- M4A
- M4B
- WMA
- AIFF Lossless
- Opus
Tagr lee y escribe etiquetas con node-taglib-sharp y extrae los metadatos con music-metadata, las mismas librerías en las que se apoyan los editores de escritorio. Los formatos sin pérdida se detectan de forma automática.
Tagr en funcionamiento
Tagr frente a otros editores de etiquetas
Casi todos los editores de etiquetas son aplicaciones de escritorio que tienes que ejecutar en la misma máquina que tus archivos. Tagr se ejecuta donde ya vive tu música.
| Capacidad | Tagr | MusicBrainz Picard | Mp3tag | beets | MetadataRemote |
|---|---|---|---|---|---|
| Funciona en el navegador, self hosted | Sí | No, es de escritorio | No, es de escritorio | No, es CLI | Sí |
| Funciona en el móvil | Sí, con gestos e instalación PWA | No | No | No | Responsive, no específico para móvil |
| Docker, multiarquitectura | amd64, arm64 | n/a | Windows primero | Sí | amd64, arm64, armv7 |
| Interfaz de edición manual | Sí, más de 40 campos | Sí | Sí, muy a fondo | No, CLI y configuración | Sí, todos los campos más campos personalizados |
| Campos de metadatos personalizados | Sí | Sí | Sí | Sí | Sí |
| Edición masiva | Sí, selección múltiple con resumen | Sí | Sí | Sí | Sí, por archivo o carpeta entera |
| Búsqueda en MusicBrainz | Sí | Sí, la mejor del sector | Con un plugin | Sí | Sí, con puntuación de confianza |
| Deshacer y revertir | Registro persistente en SQLite, sobrevive a los reinicios, por canción y por carpeta | No | No | No | Deshacer y rehacer hasta 1.000 operaciones, en memoria, se pierde al reiniciar el contenedor |
| Reproductor integrado | Sí, onda con clic para saltar | Vista previa básica | No | No | Sí, streaming en el navegador |
| Gestión de carátulas | Sí: ver, sustituir, subir, aplicar en masa | Sí | Sí | Con un plugin | Sí |
| Tabla ordenable y filtrable con más de 40 columnas | Sí | No | Sí | n/a | No |
| Filtros avanzados: texto, número, fecha, booleano | Sí | No | Parcial | Con consultas | Solo filtro de búsqueda |
| Autenticación y multiusuario | Sí, incluida | n/a | n/a | n/a | Ninguna, solo LAN, necesita un proxy inverso |
| Estado en la URL, compartible y guardable | Sí | No | No | No | No |
| Formatos | MP3, FLAC, WAV, AAC, OGG, M4A, M4B, WMA, AIFF, Opus | Amplios | Amplios | Amplios | MP3, FLAC, OGG, Opus, M4A, M4B, WMA, WAV, WavPack |
| Licencia | AGPL-3.0 | GPL-2.0 | Freeware, cerrado | MIT | AGPL-3.0 |
Picard y beets brillan organizando bibliotecas de forma automática a partir de huellas acústicas, y Mp3tag es el editor manual más profundo de Windows. Los tres quieren ejecutarse en la máquina donde están tus archivos. Tagr deja la biblioteca donde ya está y te entrega un navegador: una vista ordenable y filtrable de cada pista, un registro persistente de cada cambio que puedes revertir, autenticación incluida y una interfaz que funciona de verdad en el móvil.
Más sobre en qué se diferencia Tagr, en las preguntas frecuentesInstala Tagr con Docker
Tres comandos y un volumen montado. El fichero compose de abajo es el del repositorio.
-
Genera el secreto de autenticación
Ejecuta openssl rand -hex 32 y pega el resultado en AUTH_SECRET.
-
Levanta el contenedor
Ejecuta docker compose up -d en la carpeta donde esté tu fichero compose.
-
Ábrelo y escanea
Entra en http://localhost:3000, inicia sesión y pulsa escanear para indexar tu biblioteca.
services:
tagr:
image: ghcr.io/suitux/tagr:latest
container_name: tagr
restart: unless-stopped
ports:
- "3000:3000"
environment:
- PUID=1000
- PGID=1000
- NODE_ENV=production
- DATABASE_URL=file:/data/tagr.db
- AUTH_SECRET=paste-your-generated-secret-here
- AUTH_USER=admin
- AUTH_PASSWORD=your-password-here
- AUTH_URL=https://your-domain.com
volumes:
- sqlite_data:/data
- /path/to/your/music:/music
volumes:
sqlite_data:docker run -d \
--name tagr \
-p 3000:3000 \
-e PUID=1000 \
-e PGID=1000 \
-e DATABASE_URL=file:/data/tagr.db \
-e AUTH_SECRET=paste-your-generated-secret-here \
-e AUTH_USER=admin \
-e AUTH_PASSWORD=your-password-here \
-v tagr_data:/data \
-v /path/to/your/music:/music \
ghcr.io/suitux/tagr:latestgit clone https://github.com/suitux/Tagr.git
cd Tagr
pnpm install
pnpm build && pnpm startPreguntas frecuentes
¿Qué es un editor de metadatos de música y por qué alojarlo uno mismo?
Un editor de metadatos lee y escribe las etiquetas que van dentro de los archivos de audio: título, artista, álbum, año, género, carátula y decenas más. Esas etiquetas son las que leen Jellyfin, Navidrome o Plex para construir tu biblioteca, así que unas etiquetas malas significan una biblioteca rota. Alojar el editor tú mismo quiere decir que los archivos se quedan en tu servidor y los arreglas desde el navegador, en vez de copiar terabytes a un portátil.
¿Tagr modifica mis archivos de audio originales?
Sí, y de eso se trata. Tagr escribe las etiquetas en los archivos reales del disco con node-taglib-sharp, así que cualquier otro reproductor ve el cambio. El audio en sí no se vuelve a codificar nunca. Cada escritura queda anotada en el historial con su valor anterior y el nuevo, de modo que puedes revertirla.
¿Qué formatos de audio admite Tagr?
MP3, FLAC, WAV, AAC, OGG, M4A, M4B, WMA, AIFF y Opus. Los formatos sin pérdida se detectan solos y llevan una insignia Lossless en la lista de canciones.
¿Puedo ejecutar Tagr en un Synology, un Unraid o una Raspberry Pi?
Sí. La imagen de GHCR es multiarquitectura y cubre linux/amd64 y linux/arm64, así que funciona en NAS x86, en Apple Silicon y en una Raspberry Pi 4 o 5 con un sistema de 64 bits. Monta tu carpeta de música en /music dentro del contenedor y pon PUID y PGID al usuario que sea dueño de los archivos.
¿Cómo de grande puede ser la biblioteca?
Decenas de miles de pistas. Los metadatos se indexan en SQLite durante el escaneo, la lista de canciones usa scroll virtual con paginación infinita, y los filtros y las ordenaciones se resuelven en la base de datos, no en el navegador. La parte lenta es el primer escaneo, porque hay que leer cada archivo una vez.
¿Tagr es libre y de código abierto?
Sí, con licencia AGPL-3.0-only. El código está en GitHub, no hay versión de pago ni claves de licencia. Si te ahorra una tarde de etiquetado, puedes invitar a un café al autor.
¿Tagr envía datos a la nube?
Ni telemetría, ni analítica, ni llamadas a casa. La única salida a internet que puede hacer Tagr es a la API de MusicBrainz, y solo cuando le pides explícitamente que busque una canción. Si no usas esa función, el contenedor no habla con internet.
¿Puedo usar Tagr desde el móvil?
Sí. La interfaz es responsive y mobile first: paneles a pantalla completa con gestos para moverte entre el árbol de carpetas, la lista y el editor, un reproductor expandido, y acciones de edición siempre visibles en vez de escondidas tras el hover. Se instala como PWA desde el navegador.
¿En qué se diferencia Tagr de MusicBrainz Picard o Mp3tag?
Picard y Mp3tag son aplicaciones de escritorio que necesitan ejecutarse en la máquina donde están tus archivos, que para la mayoría de los que autoalojan es un servidor sin pantalla. Tagr se ejecuta en ese servidor y te da una interfaz web. Además guarda un registro persistente de cada edición y funciona en el móvil, cosa que ninguno de los dos hace.
¿Pueden usar la misma instancia varias personas?
Sí. Tagr trae acceso protegido por contraseña y gestión de usuarios, así que puedes crear una cuenta para cada persona que comparte la biblioteca, con un rol que decide lo que puede hacer: los taggers editan metadatos y reescanean, los listeners solo navegan y escuchan. El acceso es por usuario, no una única contraseña compartida.
¿Puedo deshacer un cambio de metadatos?
Sí. Cada cambio se guarda en SQLite con su valor anterior y el nuevo, y el registro sobrevive a los reinicios del contenedor. Revierte una edición suelta desde el historial de la canción, o selecciona un rango con shift y ctrl y revierte decenas de golpe. Hay vistas de historial por canción y por carpeta.
¿Necesito exponer Tagr a internet?
No. Lo normal es dejarlo en la red local y entrar por http://servidor:3000. Si quieres llegar desde fuera, ponlo detrás de un proxy inverso con TLS y configura AUTH_URL con la URL pública para que las sesiones y las redirecciones se resuelvan bien.
Recupera el control de tus etiquetas
Libre y de código abierto. Se ejecuta en tu hardware. AGPL-3.0.