FileSlider v1.0

FileSlider es una herramienta de presentación de diapositivas offline/online que lee automáticamente tus imágenes y archivos de música de carpetas y proporciona una presentación en el navegador. Escala las imágenes en múltiples resoluciones (incluyendo 4K y FullHD) y genera miniaturas y listas de reproducción para la música.

---

Descarga:

Descargar FileSlider v1.0

Instalación y Uso

1. Descargar el proyecto

Descarga el proyecto completo y descomprímelo en cualquier carpeta.
Nota: Si también deseas usarlo para la web, se recomienda un nombre de carpeta en minúsculas y sin espacios.

2. Añadir imágenes y música

• Coloca tus imágenes originales (JPG, PNG) en la carpeta images/.
• Coloca tus archivos de música (MP3, WAV) en la carpeta music/.

3. Crear presentación de diapositivas

• Windows: Haz doble clic en start.bat.
• macOS/Linux: Haz start.sh ejecutable (chmod +x start.sh), luego doble clic o inicia en el terminal:

./start.sh

• macOS (FileSlider.app): Si está disponible, basta con hacer doble clic en
  FileSlider.app. Es posible que debas permitir la ejecución una vez en la configuración de seguridad.

4. Procesar imágenes y música

• Se abrirá un terminal donde las imágenes se redimensionarán automáticamente (240px/1920px/3840px).
• También se generará un archivo imageList.js en public/ a partir de todas las imágenes; y un musicList.js para la música.
• Una vez que el script haya terminado, se abrirá index.html en el navegador predeterminado.
• La presentación de diapositivas también se puede iniciar manualmente en cualquier momento abriendo index.html.

5. Disfrutar de la presentación

• La presentación de diapositivas muestra todas las imágenes en el navegador sin sonido.
• Un clic en la página inicia la música (si está disponible) y cambia simultáneamente a pantalla completa. Por razones de seguridad, la mayoría de los navegadores requieren una acción para reproducir música.
• Las imágenes se ordenan alfabéticamente. Con nombres apropiados (por ejemplo, "001_, 002_...") puedes controlar el orden.

---

Funcionamiento

• Offline:
  La presentación de diapositivas funciona completamente offline (no se necesita servidor). Las listas generadas (imageList.js, musicList.js) son leídas directamente por el navegador.
• Online:
  Si la herramienta detecta que la página se carga a través de HTTP/HTTPS, se utilizan automáticamente las imágenes de 1920px para reducir los tiempos de carga. La siguiente imagen se carga en el caché, lo que permite un flujo fluido incluso con una conexión débil.
• Galería de imágenes:
  En slide_show.html hay una galería de resumen compacta (240px). Al hacer clic en una imagen, inicias la presentación de diapositivas exactamente en ese punto. Gracias a las imágenes pequeñas, también son posibles presentaciones muy grandes con más de 1000 imágenes.
• Nuevo contenido:
  Si añades nuevas imágenes o música, simplemente repite el paso 3 (ejecutar el script de inicio). Las miniaturas y listas existentes se actualizarán. Si deseas eliminar imágenes antiguas, bórralas de images/ y elimina las carpetas images-240, images-1920, images-3840 (si es necesario). Luego, inicia el script de nuevo.

---

Estructura de carpetas (Ejemplo)

FileSlider/
├─ start.bat             (Script de inicio de Windows)
├─ start.sh              (Script de inicio de macOS/Linux)
├─ FileSlider.app        (macOS: Opcional, para un inicio fácil)
├─ index.html            (Presentación principal)
├─ slide_show.html       (Galería de resumen)
├─ generateImageList.js  (Script Node.js para lista de imágenes/música)
├─ nodejs/               (Node.js portable, para que no sea necesaria la instalación)
├─ node_modules/         (Contiene dependencias como 'sharp')
├─ images/               (Imágenes originales)
├─ images-240/           (Miniaturas 240px)
├─ images-1920/          (Miniaturas 1920px)
├─ images-3840/          (Miniaturas 3840px)
├─ music/                (Archivos de música)
└─ public/
   ├─ imageList.js       (Lista de todas las imágenes)
   └─ musicList.js       (Lista de todos los archivos de música)

---

Notas y Consejos

• Textos de nombres de archivo:
  La presentación de diapositivas muestra automáticamente el nombre del archivo (sin extensión) como título/leyenda.
• Múltiples resoluciones:
  Se crean automáticamente versiones de 240px/1920px/3840px para diferentes dispositivos.
• Ventana del terminal:
  Dependiendo del sistema, el terminal permanece abierto para mostrar la salida de los registros. Pulsa cualquier tecla o escribe exit para cerrarlo.
• Cambios en tiempo, CSS y función:
  Toda la presentación se puede modificar en index.html. Allí encontrarás el CSS, así como los tiempos de visualización por imagen. En slide_show.html encontrarás todas las entradas de la página de resumen. Aquí podrías añadir tus propios enlaces, imágenes, etc., para, por ejemplo, comunicar una nota o un enlace a los visitantes.

---

Problemas conocidos

• Archivos no encontrados:
  Presta atención a las mayúsculas/minúsculas (especialmente en Linux).
• Configuración de seguridad de macOS:
  Al ejecutar FileSlider.app o start.sh por primera vez, es posible que se muestre una advertencia de seguridad. Permite la ejecución manualmente en "Configuración del Sistema → Seguridad y Privacidad".
• Los teléfonos móviles solo entran en modo de pantalla completa de mala gana, por lo que la herramienta se utiliza principalmente para presentaciones de fotos en pantallas y proyectores.
• og:image y og:url no son técnicamente posibles en un archivo HTML puro, pero pueden ser mantenidos por proyecto si se desea. La integración requeriría la conversión a PHP, lo que tendría desventajas significativas, ya que solo funcionaría con un servidor web.

---

Licencia y Créditos

• Software y scripts de FileSlider: © Johann Dirschl / DIRSCHL.com GmbH, 2025.
• Imágenes en la demo: Son propiedad de DIRSCHL.com GmbH y pueden ser licenciadas.
• Música a través de nuonu.com:
  Quienes necesiten música sin licencia también la encontrarán en nuestra página y en nuonu.com. Allí hay
  muchos cortos y también piezas instrumentales creadas con la ayuda de IA. Sin embargo, funciona cualquier archivo de música. En la web, debes mantener los archivos pequeños (MP3). Offline también puedes usar archivos WAV.
• Costos:
  Para nuestros clientes, el uso es gratuito. Otros pueden descargar y probar música, plugins y aplicaciones de forma gratuita. Si deseas utilizarlos comercialmente, puedes adquirir una licencia anual (sin caducidad) por 49 EUR en nuonu.com → Connect . Con gusto ampliaremos los productos según sea necesario.
• Node.js: © Joyent Inc. / OpenJS Foundation (Node.js portable incluido).
• Dependencias: (por ejemplo, Sharp) bajo sus respectivas licencias de código abierto.

¡Diviértete con FileSlider!