Saltar al contenido

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
Tagr, un editor de metadatos de música self hosted, con su interfaz de tres paneles: el árbol de carpetas, una lista de canciones en FLAC y el editor de metadatos, con el reproductor de onda abajo a la izquierda
  • 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.

Editor de metadatos de Tagr con un filtro de búsqueda sobre la lista de canciones y el panel de detalle abierto en los campos de título, artista y álbum
Panel de historial de Tagr con la lista de cambios de metadatos, sus valores anterior y nuevo, y una acción de revertir en cada fila

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.

Reproductor lateral de Tagr expandido con carátula, título de la pista y una onda interactiva de WaveSurfer Reproductor mini de Tagr plegado, con la pista actual y los controles de reproducción en una sola fila

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.

Árbol de carpetas de Tagr con un menú contextual que ofrece reescanear la carpeta y ver su historial
Selector de columnas de Tagr con los interruptores de las más de 40 columnas disponibles en la lista de canciones

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.

Diálogo de ajustes de Tagr abierto en la sección de usuarios, con una cuenta tagger y otra listener, sus etiquetas de rol y las acciones de editar y borrar
Diálogo de ajustes de Tagr abierto en la sección de integraciones de terceros, con la conexión a ListenBrainz, el token guardado y el campo opcional de API root

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

El navegador de tres paneles.
Buscar y editar en la misma vista.
Cada cambio, con su reversión al lado.
Solo las columnas que usas.
Usuarios y roles, sin tocar ficheros de configuración.
Tus escuchas, en tu perfil de ListenBrainz.

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.

Comparativa de funciones entre Tagr, MusicBrainz Picard, Mp3tag, beets y MetadataRemote
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 frecuentes

Instala Tagr con Docker

Tres comandos y un volumen montado. El fichero compose de abajo es el del repositorio.

  1. Genera el secreto de autenticación

    Ejecuta openssl rand -hex 32 y pega el resultado en AUTH_SECRET.

  2. Levanta el contenedor

    Ejecuta docker compose up -d en la carpeta donde esté tu fichero compose.

  3. Ábrelo y escanea

    Entra en http://localhost:3000, inicia sesión y pulsa escanear para indexar tu biblioteca.

Documentación completa de instalación
docker-compose.yml
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:

Preguntas 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.