Pasar al contenido principal
osky
Enviado por Oscar Hernández el
Doce segundos y una tecla: Osky Audio Player, mi reproductor para clasificar tracks
Categoría
Desarrollo

Cualquier DJ con una carpeta de descargas sabe cómo se ve el problema: cientos de tracks por revisar, un reproductor genérico, el explorador de archivos en otra ventana y un arrastre mal hecho que deja un duplicado donde no debía. Para eso hice Osky Audio Player, un reproductor ligero que hace una sola cosa: escuchar y clasificar miles de tracks lo más rápido posible. Abres un track, el reproductor lo recorre solo y, cuando ya sabes a dónde va, presionas 1, 2 o 3: lo detiene, lo mueve a su carpeta y pasa al siguiente.

Este es el primer review del proyecto: qué hace, cómo está armado y qué me preocupa.

Qué es y en qué estado está

El repo es público y arrancó el 12 de noviembre con dos commits. El primero ya trae la aplicación completa: escaneo automático por puntos, forma de onda, botones de destino configurables, mover y pasar al siguiente, deshacer, instancia única e instalación como reproductor predeterminado en Linux. El segundo agrega la portada del track desde sus etiquetas, una ventana de Acerca de (F1), scroll en la configuración, la licencia y los screenshots del README.

En números: unas 1,500 líneas de Rust repartidas en seis archivos y unas 1,100 de interfaz (HTML, CSS y JavaScript). La versión es la 0.1.0 y abre MP3, FLAC, WAV, AAC y M4A.

La pantalla principal de Osky Audio Player: portada, título, etiquetas de calidad, forma de onda y los botones Normal y Las que suenan

Cómo funciona el flujo

La idea central es el escaneo automático. El track se divide en 12 secciones (configurable) y en cada una suena un segundo de un punto al azar, en orden. En unos doce segundos pasas por la intro, el desarrollo, el drop y el final, que es justo lo que uno hace a mano dando clics en la línea de tiempo. Al terminar la pasada empieza otra con puntos nuevos. Si tocas la línea de tiempo o usas las flechas, ese track pasa a modo manual; el siguiente vuelve a arrancar en automático.

La clasificación se organiza con carpetas raíz y destinos. En la configuración agregas una raíz (por ejemplo Warmup Electronico) y sus destinos (Normal, Las que suenan). Cualquier track dentro de esa raíz, a cualquier profundidad, muestra esos botones, y el orden de los botones define su tecla: del 1 al 9 y el 0 para el décimo. Al mover, el track va directo al destino, junto con su .lrc si tiene. Cuando una subcarpeta se vacía, el reproductor salta solo a la siguiente y, si quedó vacía, la borra (se puede desactivar).

Mientras escuchas, ves la forma de onda (se calcula en segundo plano, así ubicas los breaks y el drop antes de oírlos) y unas etiquetas de calidad: FLAC y WAV salen en verde; en los formatos con pérdida, 320 kbps o más es verde, de 256 a 319 amarillo y menos de 256 rojo. Así los MP3 de baja calidad se delatan solos.

La arquitectura

Es una app de Tauri 2: el backend en Rust y la interfaz en JavaScript puro, sin framework.

Diagrama de la arquitectura de Osky Audio Player: interfaz web, comandos de Tauri en lib.rs y los módulos audio, decoder, library y config, más el esquema del escaneo automático en 12 secciones

  • audio.rs es el motor: maneja el Sink de rodio y el escaneo. Un hilo revisa cada 20 ms si ya toca brincar al siguiente punto.
  • decoder.rs decodifica con symphonia directamente y calcula la forma de onda (RMS y pico en 1,200 columnas) en otro hilo.
  • library.rs arma la cola en orden natural, lee metadatos y portada con lofty, y mueve o regresa archivos.
  • config.rs guarda raíces, destinos y parámetros del escaneo en un JSON.
  • lib.rs expone todo como comandos de Tauri que la interfaz llama con invoke.

Las decisiones que valen la pena

Un decodificador propio. El Decoder que trae rodio 0.20 no le pasa a symphonia el tamaño del archivo, y sin ese dato el lector de FLAC no puede hacer seek; además entra en pánico con algunos M4A. Para un reproductor cuyo chiste es brincar por todo el track, eso era inaceptable. La solución fue abrir el archivo directamente con symphonia y conectarlo a rodio como Source. Si un formato no soporta seek, hay un respaldo: reabre el archivo si hay que ir hacia atrás y descarta paquetes sin decodificarlos hasta llegar al punto. Un paquete dañado se salta en lugar de detener el track. Y para los MP4 fragmentados, que llegan sin duración en el encabezado (pasa con descargas de Tidal), la duración se mide recorriendo los paquetes.

Muestreo estratificado en lugar de azar puro. Elegir 12 puntos al azar sobre todo el track podría dejarte cinco segundos en la intro y nada en el drop. Repartirlos en secciones garantiza cobertura sin perder la variedad entre pasadas:

fn generate(&mut self) {
    let usable = self.duration - self.segment - 0.5;
    if usable <= self.segment { return; }
    let max_points = (usable / self.segment).floor().max(1.0) as u32;
    let n = self.n_points.clamp(1, max_points);
    let section = usable / n as f64;
    let mut rng = rand::thread_rng();
    for i in 0..n {
        let start = i as f64 * section;
        let jitter = (section - self.segment).max(0.0);
        let offset = if jitter > 0.0 { rng.gen_range(0.0..jitter) } else { 0.0 };
        self.points.push(start + offset);
    }
}

Nunca sobrescribir. Antes de detener la reproducción se revisa si ya existe un archivo con el mismo nombre en el destino. Si existe, el track sigue sonando y la interfaz te deja moverlo como nombre (2), saltarlo o cancelar. Si el destino está en otro disco, el rename falla con un error de dispositivo cruzado y se cae a copiar y borrar. El borrado de carpetas vacías usa remove_dir, que falla si queda cualquier cosa adentro, así que por diseño no puede llevarse archivos, y nunca toca la raíz ni los destinos.

Detalles que se notan al usarlo. La forma de onda lleva un contador de generación: si cambias de track antes de que termine, el cálculo viejo se abandona y no pinta la onda equivocada. La portada se pide aparte para no hacer más lenta la carga del track. La configuración se guarda de forma atómica (archivo temporal y luego rename). Y con el plugin de instancia única, el doble clic en otro archivo lo carga en la ventana que ya está abierta, en lugar de abrir otra. En Linux, un script lo compila, lo instala en ~/.local sin sudo y lo registra como reproductor predeterminado de MP3, FLAC, WAV, AAC y M4A.

Lo que me gusta

Que el alcance está bien cortado. No es un gestor de biblioteca, no tiene base de datos ni intenta competir con el software de DJ: es una herramienta para una tarea repetitiva, y cada decisión empuja hacia esa tarea. El flujo de "una tecla, mover, siguiente" quita justo la fricción que hace eterno clasificar.

También me gusta que la seguridad de los archivos está pensada desde el principio: revisar conflictos antes de detener, no sobrescribir nunca, soltar el archivo antes de moverlo (en Windows es indispensable) y tener deshacer. Con la música de un DJ, perder un archivo cuesta más que cualquier feature.

Y la dieta de dependencias: rodio solo para la salida de audio, symphonia con solo los codecs necesarios, perfil de release con LTO y una capa de permisos de Tauri mínima, con una política de contenido que solo permite recursos locales.

Lo que me preocupa

  • Cero pruebas automatizadas. Lo más delicado del proyecto (move_track, undo_move, unique_target, prune_empty_dirs) es justo lo más fácil de probar con carpetas temporales. Es lo primero que agregaría.
  • El deshacer vive en memoria. Si cierras la app, se pierde el historial. Además, un movimiento son varios archivos (el track y su .lrc); si regresarlos falla a la mitad, puede quedar uno de cada lado.
  • Una configuración dañada se pierde en silencio. Si el JSON no se puede leer, la app arranca con la configuración por defecto. Como cada cambio de volumen guarda la configuración, el primer ajuste sobrescribiría el archivo dañado y se perderían las raíces y destinos. Guardar una copia del archivo ilegible antes de seguir resolvería esto.
  • Mover entre discos sin verificar. Copiar y borrar es correcto, y si la copia falla no se borra nada, pero no se compara el tamaño del archivo copiado antes de borrar el original.
  • Multiplataforma por demostrar. El código contempla Windows y macOS (códigos de error, apertura de archivos desde Finder, iconos .ico e .icns), pero el script de instalación es solo para Linux y todavía no hay binarios publicados ni un pipeline que los compile.
  • Detalles menores: la interfaz pide el estado cada 80 ms en lugar de recibir eventos, y medir la duración de un MP4 fragmentado recorre el archivo completo antes de empezar a sonar.

Lo que sigue

Lo que haría después, en orden: pruebas para library.rs; respaldo de la configuración cuando no se puede leer; un registro de movimientos en disco para que el deshacer sobreviva a un reinicio; y un workflow de GitHub Actions que compile los instaladores para Linux, Windows y macOS y los publique como releases, para que cualquier DJ lo pueda probar sin instalar Rust.

El proyecto es software libre bajo AGPL-3.0: si lo usas, lo mejoras o lo ofreces como servicio, el código sigue abierto.

Escritorio de DJ de noche con una laptop que muestra un reproductor oscuro con forma de onda coral, audífonos sobre discos externos y las teclas 1 y 2 iluminadas

Enlaces