NAS Slideshow Viewer

Un visualizzatore di slideshow ottimizzato per NAS con supporto per immagini e video, progettato per prestazioni elevate e avvio istantaneo.

Funzionalità Principali

• Visualizzazione ottimizzata per NAS: Caricamento intelligente con preload minimo per non saturare la rete • Supporto multi-formato: Immagini (JPG, PNG, WebP) e video (MP4, AVI, MOV) • Griglia dinamica: Visualizza 1-6 immagini contemporaneamente • Modalità pausa con zoom: Zoom fino a 10x con pan per esplorare i dettagli • Filtri di contenuto: Solo immagini, solo video, o entrambi • Auto-avanzamento: Passa automaticamente alla cartella successiva • Interfaccia fullscreen: Esperienza immersiva senza bordi • Cache intelligente: Sistema di cache ottimizzato per ridurre i caricamenti • Controlli intuitivi: Mouse e tastiera per navigazione rapida

Requisiti

• Python 3.7+
• PyQt6 o PyQt5 (installazione automatica)
• QtMultimedia per supporto video (opzionale)

Installazione

# Clona il repository
git clone https://github.com/tuonome/nas_slideshow_viewer.git
cd nas_slideshow_viewer

# Esegui direttamente (le dipendenze vengono installate automaticamente)
python slider_filtri_NAS_LITE.py

Utilizzo

Avvio

python slider_filtri_NAS_LITE.py

Controlli Mouse

• Click Sinistro: Cambia cartella
• Click Destro: Cartella successiva (per mtime)
• Click Centrale: Pausa/riprendi su immagine
• Rotella: Cambia velocità slideshow / Zoom in pausa
• Trascina (in pausa con zoom): Sposta l'immagine

Controlli Tastiera

• 1-6: Imposta numero immagini nella griglia
• +/-: Velocità ±100ms
• I: Solo immagini
• V: Solo video
• T: Tutto (immagini + video)
• ←/→ (in pausa): Naviga tra immagini
• Home (in pausa): Reset zoom
• ESC: Esci

Modalità Pausa

Click centrale su un'immagine per entrare in modalità pausa:

• Usa la rotella per zoomare (1x-10x)
• Trascina per spostare l'immagine quando ingrandita
• Usa ←/→ per navigare tra le immagini
• Home per resettare zoom e posizione

Configurazione

Modifica le costanti all'inizio del file per personalizzare:

DEFAULT_START_DIR = r"Z:\OF"  # Cartella di avvio
MAX_DECODE_DIM = 2560         # Dimensione massima decodifica
PRELOAD_TARGET = 80           # Immagini da tenere in cache
MIN_VIDEO_DURATION_MS = 40000 # Durata minima video (40s)

Ottimizzazioni per NAS

Il software è specificamente ottimizzato per l'uso con NAS:

• Worker limitati: Solo 8 worker I/O per non saturare la connessione
• Preload intelligente: Cache di soli 80 elementi con caricamento progressivo
• Scansione rapida: Usa os.scandir() per velocità massima
• Caricamento on-demand: Mostra immediatamente, precarica in background
• Gestione memoria: Evict automatico delle immagini meno usate

Struttura del Progetto

nas_slideshow_viewer/
├── slider_filtri_NAS_LITE.py    # File principale
└── README.md                     # Documentazione

Componenti Principali

• ImageCacheLite: Cache ottimizzata per immagini
• SlideShowWidget: Widget principale per la visualizzazione
• VideoPlayerWidget: Player per contenuti video
• VideoDurationScanner: Scanner asincrono durata video
• ScaledImageCache: Cache per immagini scalate (modalità pausa)

Licenza

MIT License

Copyright (c) 2024

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWATE.