jelly-app

Jelly Music App (JMA)

Una interfaz de música ligera y elegante para Jellyfin. Diseñada para ser intuitiva y minimalista con gran atención al detalle, una aplicación web libre de desorden centrada en la reproducción de música. Usando la API de Jellyfin, proporciona acceso fluido a tu biblioteca musical personal. Demo

¿Buscas un reproductor de video? Echa un vistazo a Jelly Video App - la versión enfocada en video para tu biblioteca Jellyfin!

Capturas de pantalla adicionales

Búsqueda en el panel lateral

Busca pistas, artistas, álbumes, listas de reproducción, géneros

Resultados de búsqueda

Ver resultados adicionales en una ventana dedicada

Artistas

Incluye canciones más reproducidas, álbumes y otras colaboraciones

Listas de reproducción

Vista de lista de reproducción, con su propia lista de pistas numerada

Características

• Diseño Elegante y Simple: Una interfaz limpia y sin desorden que hace que la reproducción de música sea fácil y agradable. Construido con herramientas modernas como React para una experiencia rápida y fiable.
• Compatible con Dispositivos: Disfruta de una experiencia fluida, similar a una aplicación, tanto en móvil como en escritorio, instalable como PWA para acceso instantáneo.
• Acceso Sincronizado a la Biblioteca: Conéctate a tu servidor Jellyfin para explorar tu colección personal de música con facilidad.
• Descubre Tus Favoritos:
• Inicio: Vuelve rápidamente a las pistas reproducidas recientemente, tus favoritas más escuchadas y medios añadidos recientemente.
• Artistas: Explora las mejores canciones, álbumes y colaboraciones de cualquier artista en tu biblioteca.
• Listas de Reproducción: Visualiza listas con una lista clara y numerada de canciones para una navegación rápida.
• Búsqueda Rápida: Encuentra canciones, artistas, álbumes, listas o géneros sin esfuerzo con una búsqueda en la barra lateral o una página de resultados dedicada.
• Mezcla Instantánea: Disfruta listas de reproducción curadas directamente desde tu biblioteca musical en una página independiente.
• Cola: Gestiona y reordena canciones fácilmente con la funcionalidad mejorada y optimizada de la Cola.
• Fundido Cruzado: Transiciones suaves entre canciones para una experiencia de escucha continua e inmersiva.
• Precarga: Precarga inteligentemente la siguiente pista para asegurar una reproducción fluida y sin interrupciones ni retrasos por buffering.
• Letras Sincronizadas: Disfruta tus canciones favoritas de una forma nueva con una interfaz espectacular que muestra letras perfectamente sincronizadas línea por línea mientras escuchas.
• Obtención Inteligente: Almacena en caché tu música eficientemente para una reproducción instantánea y fluida.
• Sincronización Offline: Descarga canciones individuales, álbumes completos, listas de reproducción o artistas para reproducción sin conexión.
• Auto-Sincronización: Descarga automáticamente las canciones nuevas añadidas a cualquier lista, álbum o artista previamente guardado.
• Cola Persistente: Las descargas se gestionan con una cola local que se reanuda sin problemas entre sesiones.
• Transcodificación o Streams Directos: Soporta descargas tanto en calidad original como transcodificada según la tasa de bits seleccionada.
• Soporte Docker: Descarga y despliega la aplicación usando una imagen Docker preconstruida con una URL del servidor Jellyfin preconfigurada para una auto-hospedaje sin complicaciones.

Instalación

La aplicación Jelly Music puede instalarse como una aplicación de escritorio dedicada, disponible en nuestra página de lanzamientos de GitHub. También puedes obtener la última versión de producción desde allí y desplegarla en tu servidor web colocando el contenido de la carpeta archivada en un directorio accesible desde la web.
También está disponible como imagen docker para un despliegue sencillo, consulta los detalles de docker a continuación.

Yarn (npm i -g yarn) es necesario si deseas compilar el proyecto o ejecutar el servidor de desarrollo por ti mismo.

#### Compilar desde el Código Fuente

• Clona el repositorio:

    git clone https://github.com/Stannnnn/jelly-app.git
    ``
Instalar dependencias:
    `bash
    yarn
    `
Construya los archivos de producción:
    `bash
    yarn build
    `
Despliegue el contenido de la carpeta dist en un directorio accesible desde la web.
Alternativamente, puede ejecutar el servidor de desarrollo directamente: yarn dev o yarn dev:nocache
Si desea usar una ruta base para la aplicación distinta a la raíz (/), debe construirla manualmente estableciendo URL_BASE_PATH en la ruta base preferida.
Deje la configuración por defecto, o cambie config.json según sea necesario. Las configuraciones se explican en la Sección de Configuración de la Aplicación.
El archivo config.json puede modificarse directamente en la aplicación ya construida. No es necesario reconstruir si solo cambia una variable de configuración.
Docker
Puede alojar fácilmente Jelly Music App usando Docker con la imagen preconstruida de ghcr.io:
#### Descargar la imagen de docker

#### Ejecutar la imagen de Docker

La imagen de Docker también se puede ejecutar en segundo plano añadiendo la bandera -d docker run -d ...
#### Ejecutar la imagen de docker con variables de configuración

Ejemplo: ghcr.io/stannnnn/jelly-music-app:latest

#### Construcción del Contenedor Docker

También puedes construir Jelly Music App usando Docker.

• Construye la imagen de Docker:

`bash docker run --rm \ -e DEFAULT_JELLYFIN_URL=https://demo.jellyfin.org/stable \ -e LOCK_JELLYFIN_URL=false \ -p 80:80 jelly-music-app:latest `

#### Docker Compose

Para una gestión más sencilla de los contenedores, puedes usar Docker Compose. Se proporciona un archivo docker-compose.yaml en el repositorio con configuraciones predeterminadas adecuadas.

• Copia el archivo de entorno de ejemplo y personalízalo para tu configuración:

• Edite el archivo .env con la URL de su servidor Jellyfin y sus preferencias:

El archivo docker-compose.yaml utiliza variables de entorno con los siguientes valores predeterminados:

• JELLYAPP_PORT: Puerto externo a exponer (predeterminado: 80)
• JELLYAPP_DEFAULT_URL: URL predeterminada del servidor Jellyfin (predeterminado: https://demo.jellyfin.org/stable)
• JELLYAPP_LOCK_URL: Bloquea la entrada de la URL de Jellyfin (predeterminado: false)

Configuración de la Aplicación

La configuración de la aplicación puede modificarse editando el archivo config.json durante el proceso de compilación o en los archivos de la versión. Al usar Docker, las configuraciones pueden proporcionarse como variables de entorno. Las opciones de configuración disponibles son las siguientes:

• DEFAULT_JELLYFIN_URL: Establece la URL predeterminada del servidor Jellyfin que se carga en el primer acceso a la aplicación si no hay una URL almacenada en el Almacenamiento Local.
• LOCK_JELLYFIN_URL: Si se establece en true, elimina el campo de entrada de URL y aplica la URL predeterminada (DEFAULT_JELLYFIN_URL) para todas las conexiones, ideal para instancias autoalojadas vinculadas a un solo servidor.

Contribuciones

Estamos abiertos a solicitudes de extracción, por favor mándelas a la rama develop`. Si tienes alguna sugerencia o mejora, no dudes en abrir un issue o enviar una solicitud de extracción. ¡Tus contribuciones son bienvenidas y apreciadas!

--- Tranlated By Open Ai Tx | Last indexed: 2026-07-21 ---