1-bit Bridge: Servidor Companion de Alta Fidelidad para el Reproductor 1-bit iOS

1-bit-bridge es una solución de infraestructura diseñada específicamente para optimizar la experiencia de usuario en el reproductor de música 1-bit en dispositivos iOS. A diferencia de los servidores multimedia convencionales, este proyecto actúa como una capa de abstracción técnica que sustituye el protocolo SMB (Server Message Block) —conocido por su latencia y alto consumo de recursos en redes móviles o locales— por una arquitectura robusta basada en HTTP/2 con autenticación por bearer-token.

¿Para quién es este proyecto?

Este software está orientado a entusiastas del audio de alta fidelidad (audiófilos) y usuarios avanzados que operan dentro del ecosistema 1-bit. Es la solución ideal para:

Usuarios con colecciones masivas: Personas que necesitan eliminar el tiempo de espera al escanear carpetas en redes locales o remotas.
Entusiastas del DSD: Usuarios que requieren una entrega bit-exact para evitar problemas de Device on Path (DoP) en hardware crítico como el Hugo 2.
Usuarios con acceso remoto: Quienes utilizan redes privadas o VPNs (como Tailscale) y necesitan una conexión estable y segura fuera del hogar.
Administradores de NAS: Usuarios que buscan un servidor ligero pero potente para gestionar metadatos complejos y letras en múltiples formatos.

Arquitectura Técnica y Diferenciadores Clave

La arquitectura de 1-bit-bridge no es genérica; está diseñada para emular casi perfectamente el comportamiento del sistema original, pero sobre una pila de protocolos más eficiente.

Sincronización mediante Manifest en SQLite

En lugar de realizar un escaneo recursivo de archivos cada vez que la aplicación se abre (proceso lento y propenso a fallos), 1-bit-bridge utiliza un manifest pre-construido. Este índice en una base de datos SQLite permite que el cliente iOS descargue todo el catálogo o solo los cambios detectados (deltas) en una única petición HTTP, garantizando una carga instantánea.

Implementación de Primitivas Core

El servidor implementa 5 primitivas fundamentales que mapean directamente con la API interna de SMBConnectionPool: list, stat, readRange, download y downloadStreaming. Esta paridad asegura que todas las funciones nativas de la aplicación funcionen sin fricciones.

Reproducción Bit-Exact y Transcodificación Controlada

Uno de los mayores retos en el audio digital es mantener la integridad del archivo original. 1-bit-bridge garantiza que los bytes entregados sean idénticos a los originales para archivos DSD, permitiendo que la caché pre-cargada se mantenga intacta. En casos donde sea necesaria la conversión a PCM, utiliza ffmpeg y sox con métricas de precisión controladas (DSD → PCM: −116.8 dBTP, alias diferencial +0.38 dB), asegurando una calidad de audio superior.

Funcionalidades Avanzadas

Soporte Multimedia Extenso: Extracción automática de letras desde etiquetas ID3 SYLT/USLT, archivos Vorbis, metadatos en MP4 y archivos externos (.lrc, .ttml, .txt).
Gestión de Portadas: Soporte para renderizadores DLNA a través del endpoint /dlna/artwork/{key}.
Seguridad Robusta: Implementa TLS Fingerprint Pinning y HSTS en modo público, protegiendo la integridad de la transmisión de datos.
Consola de Administración (v0.2.0+): Interfaz para gestión de archivos con carga chunked y resumible, eliminación mediante sistema de papelera, compresión de base de datos y límites de tasa por ruta.

Especificaciones Técnicas

Característica	Detalle Técnico
Lenguaje de Programación	Go (Golang) - Alta concurrencia y eficiencia.
Protocolo de Red	HTTP/2 con autenticación Bearer Token.
Integración Tailscale	Modos: `cli`, `tsnet` (in-process) y `disabled`.
Formatos Soportados	FLAC, DSD, WAV, MP3 (con metadatos enriquecidos).
Seguridad de Red	HSTS activo y TLS Fingerprint Pinning.

Instalación y Despliegue

El software se distribuye como binarios pre-construidos para macOS, Linux y Windows, eliminando la necesidad de instalar el toolchain de Go en el servidor final.

Despliegue Local: Ejecución directa del binario con configuración vía variables de entorno o archivo de configuración.
Integración Tailscale: El modo tsnet permite que el proceso integre un nodo tailnet directamente, ideal para servidores en redes aisladas sin necesidad de binarios externos adicionales.
Gestión de Recursos: En entornos de producción, se recomienda el uso del modo public con autenticación por contraseña y HSTS activado.

Ventajas vs. Alternativas (Plex, Navidrome)

A diferencia de soluciones genéricas como Plex o Navidrome, que están diseñadas para el consumo masivo de contenido multimedia, 1-bit-bridge es una capa de abstracción específica. No intenta ser un reproductor universal; su objetivo es emular perfectamente las capacidades del protocolo SMB sobre HTTP/2 para maximizar la compatibilidad y rendimiento con la aplicación 1-bit iOS, garantizando que el flujo de datos sea lo más limpio posible para los DACs de alta gama.

Preguntas Frecuentes (FAQ)

¿Es necesario un servidor dedicado?: No es obligatorio, pero se recomienda un entorno estable (como una Raspberry Pi o un NAS) para mantener el índice de SQLite actualizado y garantizar la disponibilidad del servicio.
¿Cómo maneja los archivos DSD?: El servidor entrega los bytes exactos del archivo original. La transcodificación a PCM solo ocurre si es estrictamente necesario, utilizando algoritmos de alta precisión para minimizar la distorsión.
¿Es seguro exponerlo a internet?
¿Soporta la carga de archivos?

1-bit Bridge | Companion Server for 1-bit iOS