Configuración

Casi todo se ajusta en la interfaz, en Configuración. El archivo de configuración y las variables de entorno solo hacen falta para la instalación (puerto, ubicación de la base de datos) y casos especiales. Esta página cubre ambos.

Configuración

Las pestañas de Configuración, en orden. Algunas solo aparecen en el nivel de interfaz Avanzado o Experto (menú de la cuenta › Interfaz).

Para encontrar un ajuste rápidamente, usa Buscar un ajuste… en el menú de la cuenta.

Actualizaciones

Cuando hay una nueva versión disponible, Tune la anuncia en la barra lateral ("Actualización disponible"). Para comprobarlo tú mismo, usa Buscar actualizaciones en Configuración › Sistema › Acerca de › Actualizaciones. En Windows, macOS, el paquete .deb y Tune OS, la actualización se instala desde Tune; cualquier escaneo en curso se detiene antes. Con Homebrew, Tune ejecuta brew upgrade o te indica que lo hagas. Con Docker, descarga tú mismo la nueva imagen.

Nota sobre el .deb: una actualización instalada desde Tune reemplaza los archivos de /opt/tune sin pasar por apt. Si después reinstalas un .deb más antiguo, se recupera la versión de ese paquete.

Copia de seguridad

Configuración › Sistema › Base de datos › Copia de seguridad / Restauración crea una copia de la base de datos. Las copias se guardan en una carpeta backups junto a la base de datos, y Tune conserva las cinco más recientes. No está disponible con PostgreSQL: usa pg_dump en su lugar. Configuración › Dispositivos › Copia de seguridad de los ajustes guarda los ajustes de tus zonas en un archivo. El volumen, la cola y los grupos no se incluyen. Vuelve a cargar el archivo con Abrir una copia de seguridad….

El archivo de configuración tune.toml

Tune no necesita ningún archivo para arrancar. Si creas uno, Tune usa el primer tune.toml que encuentre, en este orden:

1. Windows: %APPDATA%\Tune\tune.toml
2. la carpeta desde la que se inicia Tune: ./tune.toml
3. /etc/tune/tune.toml
4. macOS: ~/.config/tune/tune.toml

port = 8888
db_path = "tune.db"
auto_scan = false
log_level = "info"
music_dirs = ["/srv/music"]
# local_audio_backend = "asio"     # Windows: auto, wasapi or asio
# dlna_play_delay_ms = 0

Atención: un archivo mal formado se omite sin ningún mensaje de error, y Tune pasa al siguiente o a los valores predeterminados.

Variables de entorno

Las variables de entorno tienen prioridad sobre tune.toml. Tune también lee un archivo .env en la carpeta desde la que se inicia (y en Windows, en %LOCALAPPDATA%\TuneServer\ o junto a tune-server.exe). Con el paquete .deb, colócalas en /etc/default/tune-server (una por línea, sin comillas) y ejecuta después sudo systemctl restart tune-server.

Carpetas de música. TUNE_MUSIC_DIRS (o music_dirs) se copia en los ajustes solo en el primer arranque. Después, lo que cuenta es la lista de Configuración › Biblioteca › Ubicaciones, y cambiar la variable no tiene ningún efecto. Una carpeta inexistente o vacía no se copia.

Variables eliminadas. Las antiguas variables PORT, HOST, MUSIC_DIRS, DB_DRIVER, API_KEY, AUDIO_DEVICE, DSD_MODE, WRITE_TAGS, WATCH_FILESYSTEM y similares ya no se leen. Varias variables de .env.tune.example tampoco tienen ningún efecto: TUNE_TIDAL_ENABLED, TUNE_QOBUZ_ENABLED, TUNE_DEEZER_ENABLED, TUNE_SPOTIFY_ENABLED, TUNE_YOUTUBE_ENABLED, TUNE_DEFAULT_OUTPUT_FORMAT. Los servicios se activan en la interfaz.

Dónde se guardan los datos

La caché de carátulas se encuentra a su lado: %LOCALAPPDATA%\TuneServer\artwork_cache en Windows, ~/Library/Application Support/Tune/artwork_cache en macOS, /data/artwork_cache en Docker, /opt/tune/data/artwork_cache en Tune OS. El archivo de registro está limitado a 10 MiB, con una copia de seguridad (.1). En Tune OS, un equipo instalado antes de la 1.0 conserva su caché original, /opt/tune/artwork_cache.

Base de datos: SQLite o PostgreSQL

Tune usa SQLite por defecto, sin ninguna configuración. PostgreSQL es compatible con las compilaciones publicadas para Windows, macOS y Linux (x86-64 y aarch64). No es compatible con la imagen Docker ni con la compilación Linux aarch64-musl. Dos maneras de activarlo:

• en la interfaz: Configuración › Sistema › Base de datos › Migrar a PostgreSQL (nivel Experto);
• al arrancar: TUNE_DATABASE_URL=postgres://user:password@host:5432/tune, o TUNE_DB_ENGINE=postgres junto con TUNE_DB_HOST, TUNE_DB_PORT, TUNE_DB_NAME, TUNE_DB_USER y TUNE_DB_PASS.

Puertos de red

Tune escucha en todas las interfaces de red; la dirección de escucha no se puede cambiar. En Tune OS, el puerto 80 se redirige al 8888.

Seguridad

Por defecto, Tune no tiene contraseña ni HTTPS: cualquiera con acceso a tu red local puede abrir la interfaz. No expongas el puerto 8888 a Internet. La autenticación por cuenta y token existe en la API (consulta la Guía técnica), pero no se puede configurar desde la interfaz.

Véase también

• Primeros pasos: instalación según la plataforma
• Guía técnica: detalles de la API y la arquitectura
• Solución de problemas: problemas de configuración habituales