Setlist Admin (WiFi) — guía de uso

Read in English

Esta es una expansión (expansions/setlist-admin-wifi/) — ver el expansions/README.md en la raíz del repo para qué significa eso. Es la app web opcional para administrar el USB de biblioteca y el WiFi de la Pi desde el navegador de un teléfono o computador, en vez de SSH + nano + copiar archivos a mano. Diseño y razonamiento: SPECIFICATION.md. No se instala por defecto — ver “Instalación” abajo.

Estado (2026-10-03): en el roadmap, no planeada para desarrollo a corto plazo — una decisión deliberada. Implementada y con tests unitarios; su bloqueo de hardware original (un dongle USB de WiFi muerto) se encontró y resolvió a nivel de sistema operativo (2026-10-01, un dongle de repuesto funcional — ver la nota de estado en SPECIFICATION.md), pero esta expansión en sí todavía no se ha instalado ni probado en hardware real con él, y no hay más trabajo planeado sobre ella por ahora. Si solo quieres llegar a la app admin de setlist-admin-usb por tu WiFi de casa existente (sin la propia interfaz de configuración de hotspot de esta expansión), ver el USAGE.md de esa expansión en su lugar — “Llegar a la app por WiFi” cubre exactamente eso, de forma mucho más simple.

Solo pre/post-Set. Esto no está diseñado ni probado para editar la biblioteca con un Set en curso — la app muestra una advertencia si detecta que el pedal está reproduciendo activamente, pero no bloquea; trata esa advertencia como real, no como formalidad.

Instalación

Opcional, y separada de la instalación base del pedal (systemd/README.md). Requiere desactivar temporalmente el overlay de solo lectura primero, igual que cualquier otro paso de instalación que escriba en /etc/systemd/system (systemd/README.md sección 4):

sudo raspi-config nonint do_overlayfs 1
sudo reboot

Luego, desde cualquier parte dentro del checkout del repo en la Pi:

sh expansions/setlist-admin-wifi/scripts/install.sh <tu-usb-uuid>

<tu-usb-uuid> es el mismo UUID que ya usa --usb-uuid de pedal-core.service (systemd/README.md sección 3). Esto inicia setlist-network-watchdog.service, que decide por sí solo cuándo debe estar corriendo setlist-admin.service (ver “Cómo funciona el lado de red” abajo) — no arrancas el servidor de administración directamente.

Reactiva el overlay cuando termines:

sudo raspi-config nonint do_overlayfs 0

Luego edita /boot/firmware/cmdline.txt y vuelve a agregar :recurse=0 — ver systemd/README.md sección 4, el mismo paso requerido después de cualquier reactivación del overlay.

Primer uso

  1. Conecta tu teléfono al hotspot de la Pi (o tu computador a la misma red en la que está la Pi).
  2. Visita http://<hostname-o-ip-de-la-pi>:8080.
  3. Primera visita: define un PIN (mínimo 4 caracteres). Es autenticación compartida de un solo PIN (SPECIFICATION.md sección 2) — no cuentas por persona.
  4. De ahí en adelante, visitar la app pide ese PIN.

¿Olvidaste el PIN? No hay flujo de email/link de reseteo — esto es un appliance local sin sistema de cuentas. Recupéralo por SSH:

ssh pedal
sudo umount /media/usb && sudo mount -o rw /media/usb
rm /media/usb/.setlist-admin/pin.hash
sudo umount /media/usb && sudo mount -o ro /media/usb

La siguiente visita a la app lo trata como primera vez de nuevo y pide definir un PIN nuevo.

Usándola

Idioma: el menú desplegable EN/ES en la barra superior cambia cada etiqueta, botón, confirmación y notificación entre inglés y español, guardado solo en este teléfono/navegador (cada dispositivo recuerda su propia elección). Los nombres de canciones, pistas, Sets y Banks nunca se traducen ni se alteran, en ningún idioma — son tus datos, se muestran exactamente como los escribiste.

Pestaña Library: elige o crea un Set, crea/borra carpetas Bank, y para cada espacio de pista (A/B/C):

No hay un botón separado de “reordenar” — para cambiar qué canción está en qué posición, sube/renombra para que el archivo correcto quede bajo la letra correcta, o usa la acción de intercambio (reordenar arrastrando puede agregarse más adelante; hoy es letra por letra).

Cada subida se valida de códec (ffprobe) — un video que no sea H.264 recibe una advertencia, no un bloqueo, apuntando a la guía de codificación de LIBRARY.md. Igual se sube; puede que no se reproduzca hasta que lo re-codifiques, igual que si lo hubieras copiado a mano.

Exportar Set: el repertorio en letra grande para leer en el escenario

El botón “Export Set” (junto al selector de Set) abre una vista a pantalla completa, en letra grande, con todas las pistas asignadas en ese Set, en orden (Bank 1 A, B, C, luego Bank 2, y así sucesivamente) — cada línea muestra el nombre de archivo exacto y su extensión tal como están guardados, para que lo que veas acá siempre coincida con lo que realmente hay en el USB. Pensada para verse de un vistazo mientras tocas, no para leerse de cerca.

Se cierra con la ✕ en la esquina, la tecla Escape, o el gesto/botón de atrás de tu teléfono.

Share convierte la lista en una imagen PNG y la entrega al menú nativo de compartir de tu teléfono (WhatsApp, Mensajes, correo, guardar en Fotos — lo que tengas instalado); en un navegador de escritorio sin ese soporte, en cambio descarga el PNG directamente (el soporte desde un PC todavía se está verificando por separado).

Biblioteca de canciones: reutilizar canciones entre Sets

La sección “Song library” al inicio de la pestaña Library (toca para desplegarla) lista todas las canciones disponibles para reutilizar — es la carpeta _Songs/ en la raíz del USB (LIBRARY.md documenta la misma convención para editar el USB a mano, sin esta app). Está pensada para tener todas las canciones que tiene la banda, no solo las del Set que estás armando ahora, para que empezar el Set de la próxima presentación sea cuestión de elegir entre lo que ya existe, en vez de volver a subir todo.

Desde ahí puedes subir una canción nueva directo a la biblioteca (sin asignarla a ningún Bank todavía), renombrarla, o borrarla. Si subes un nombre que ya está ahí, la app pregunta “… already exists in the library. Replace it?” — confirma para reemplazarla en el mismo lugar, o cancela para dejar la existente sin tocar.

Si el video de una canción no está en el formato recomendado (H.264 — ver el aviso junto a la subida, o LIBRARY.md), igual se sube, pero aparece un botón “Optimize” junto a ella. Tócalo para re-codificar el archivo en el mismo lugar al formato recomendado, sin tener que hacerlo a mano. Primero verás una advertencia: no desconectes la Raspberry Pi mientras esté corriendo — la recodificación escribe al almacenamiento local de la propia Pi durante todo el proceso, y esto puede tardar un rato en este hardware (confirmado hasta unos 90 minutos, o varias horas para un video 4K grande) — mientras corre, el botón muestra un verde permanente que dice “Optimizando”, que se mantiene (junto a un botón “Cancel”) aunque desconectes el celular y vuelvas más tarde, así que puedes revisarlo cuando te quede cómodo. La app se refresca sola cada pocos segundos mientras un trabajo esté activo, así que no necesitas refrescar a mano para ver cuándo termina o se cancela. Si falla (un archivo dañado o ilegible), el botón pasa a “Optimize (retry)” con el motivo al mantener presionado.

¿Cambiaste de opinión, o necesitas la Pi para otra cosa ahora mismo? Toca “Cancel” — detiene la recodificación en pocos segundos y deja el archivo exactamente como estaba, sin optimizar. Es seguro tocar “Optimize” de nuevo más tarde para reintentar.

La optimización corre de forma independiente a esta app y a cualquier Set que esté sonando — una canción en la biblioteca no se carga a ningún Set en vivo ni al standby hasta que la asignes por separado, así que una optimización en curso nunca afecta lo que realmente se puede reproducir en este momento. Borrar una canción de la biblioteca no se recomienda — si tienes dudas, no la borres. LIBRARY.md recomienda tratarla como un registro permanente de todo lo que tiene la banda, incluso canciones que no se usan en ningún Set en este momento, para que la biblioteca sea siempre una respuesta honesta a “¿cuántas canciones tenemos realmente?”. Una vez borrada, la canción ya no se puede elegir al armar un Bank (no aparecerá en el selector para ningún Set futuro) — pero borrarla no la quita de ningún Bank donde ya esté asignada; esos siguen sonando normal, porque asignarla ya hizo una copia independiente. La confirmación de borrado de la app lo explica así también. Desinstalar cualquiera de las expansiones de setlist-admin tampoco borra _Songs/ por defecto — solo lo hace la bandera explícita --purge-library (ver “Desinstalar” abajo). Y en la otra dirección: asignar una canción a un Bank nunca la quita de la biblioteca — cada asignación es una copia, la biblioteca siempre conserva la suya.

Los cambios necesitan un reinicio para aplicarse. El pedal solo lee la estructura de la biblioteca cuando arranca (MASTER_SPECIFICATION.md) — esta app no cambia eso; edita todo lo que necesites, luego ssh pedal sudo reboot cuando termines (la interfaz de esta expansión no tiene un botón de reinicio integrado como sí tiene setlist-admin-usb).

Video de standby: qué se repite cuando no hay nada sonando

La sección “Standby video” muestra qué está en loop ahora mismo (tamaño del archivo y cuándo se cambió por última vez) y te permite reemplazarlo: elige cualquier video de la biblioteca de canciones de arriba y toca “Set as standby”. Para usar un video que todavía no está en la biblioteca, súbelo primero ahí y luego elígelo acá. Solo se pueden usar videos como standby (los archivos de solo audio no aparecen en el selector). Renombrarlo o borrarlo después funciona exactamente igual que cualquier otra canción de la biblioteca. Misma regla que todo lo demás acá: necesita un reinicio para aplicarse.

Pestaña WiFi: opcionalmente define el WiFi de casa de la Pi (SSID + contraseña). Si está definido y alcanzable, la Pi lo prefiere sobre el hotspot del celular; si no es alcanzable, cae al hotspot automáticamente. Ver “Cómo funciona el lado de red” abajo para qué hace esto exactamente por debajo.

Cómo funciona el lado de red

Se rastrean dos perfiles de WiFi: el hotspot del celular (el default/respaldo de este proyecto, configurado una vez durante la instalación) y una red de casa opcional (definida desde la pestaña WiFi, en cualquier momento). Ambos se guardan cifrados en el USB de biblioteca, atados a esta Pi específica + este USB específico — copiar el archivo a otro par lo vuelve indescifrable, a propósito (SPECIFICATION.md sección 5).

setlist-network-watchdog.service reaplica ambos perfiles a NetworkManager en cada arranque (no sobreviven bajo el overlay de solo lectura de la raíz de otra forma) y revisa la conectividad cada 30 segundos, arrancando setlist-admin.service solo mientras hay una IP utilizable — correrlo sin ninguna red alcanzable solo desperdiciaría RAM/CPU para nada.

Desinstalar / revertir

Si esto alguna vez necesita salir —un bug, o simplemente decidir no usarlo— pedal-core.service, el pedal en vivo realmente crítico, nunca se toca al instalar o quitar esto:

sh expansions/setlist-admin-wifi/scripts/rollback.sh

Agrega --purge para también borrar el PIN y las credenciales de WiFi guardadas del USB; omítelo para conservarlos así una futura reinstalación no necesita reconfigurarse desde cero. Agrega --purge-library (aparte) para también borrar _Songs/, la biblioteca compartida de canciones — no incluida en --purge porque borra archivos de canciones reales, un paso más grande que reiniciar un PIN; ver la recomendación de LIBRARY.md de tratar esa biblioteca como permanente antes de usar esto. Ver las secciones 11-12 de SPECIFICATION.md para exactamente qué toca cada bandera y qué no.