NX-ScreenUploader riceve un nuovo aggiornamento che introduce diverse migliorie pensate per rendere ancora più semplice e affidabile la condivisione automatica di screenshot e video catturati su Nintendo Switch.

Il sysmodule, molto apprezzato nella scena homebrew della console, continua così a evolversi aggiungendo nuove integrazioni e correggendo alcuni problemi emersi nelle versioni precedenti.

La novità più importante di questo update riguarda il supporto a Immich, la popolare piattaforma self-hosted dedicata alla gestione di foto e video.

Grazie a questa integrazione, gli utenti possono ora inviare automaticamente screenshot e clip registrate dalla console direttamente verso un server Immich personale utilizzando le API ufficiali del servizio.

Per configurare la funzione basta inserire i parametri server_url e api_key all’interno della nuova sezione [immich] del file config.ini. Il contributo è stato realizzato da @hax4dazy, che ha collaborato anche ad altre ottimizzazioni interne del progetto.

Sul fronte delle correzioni, l’aggiornamento risolve un fastidioso problema relativo all’invio dei video su Telegram. In precedenza alcuni file potevano essere visualizzati in maniera non corretta all’interno della chat a causa dell’assenza dei parametri relativi alla risoluzione video.

Con questa release vengono ora specificate automaticamente le dimensioni 1280×720, garantendo una compatibilità migliore con il sistema di anteprima di Telegram e una visualizzazione più pulita dei contenuti condivisi.

Gli sviluppatori hanno inoltre sistemato una perdita di memoria che poteva causare crash del sysmodule durante il processo di upload verso Immich. Il problema era legato alla gestione delle risorse cURL MIME, che ora vengono liberate correttamente dopo l’utilizzo.

Questa modifica migliora sensibilmente la stabilità generale del modulo, soprattutto durante trasferimenti multipli o sessioni prolungate.

Non mancano anche alcune migliorie dedicate alla manutenzione del codice e agli strumenti di debug. Il sistema di logging è stato aggiornato introducendo timestamp locali completi, nel formato [2026-05-09 16:19:14], rendendo molto più semplice individuare eventuali errori o analizzare il comportamento del sysmodule durante il funzionamento.

Gli strumenti interni dedicati al profiling sono stati rinominati per risultare più chiari e coerenti. La vecchia flag ENABLE_TIME_FUNCTIONS lascia spazio alla nuova ENABLE_PROFILING, mentre lo script build-with-time.sh viene sostituito da build-with-profiling.sh.

Si tratta di cambiamenti principalmente orientati agli sviluppatori, ma che contribuiscono a mantenere il progetto più ordinato e leggibile.

Questa release include anche una pulizia generale del codice, con la rimozione di vecchie implementazioni non più utilizzate, tra cui alcune funzioni legacy legate a fopen e CURLOPT_READFUNCTION presenti nella nuova integrazione Immich.

Oltre a questo sono stati applicati interventi di formattazione generale per uniformare il codice sorgente e migliorarne la manutenzione futura.

Infine è stata aggiornata anche la documentazione ufficiale, sia nella versione inglese che in quella cinese del file README.md, aggiungendo tutte le istruzioni necessarie per configurare correttamente il nuovo sistema di upload verso Immich.

Caratteristiche

• Carica automaticamente gli screenshot e le registrazioni dello schermo catturati su Nintendo Switch.
• Supporta più destinazioni di upload: Telegram, Discord e ntfy.sh.
• Supporta URL personalizzati per la Telegram Bot API (utile per reverse proxy).
• Supporta un intervallo personalizzato per il controllo delle nuove catture.
• Utilizza meno memoria rispetto al progetto originale (da ~1,852 MB a ~1,339 MB).
• Nessun crash fatale aprendo nxmenu in modalità applet insieme ad altri sysmodule.

Preparazione delle destinazioni

Telegram

Per utilizzare Telegram è necessario creare un bot dedicato, che invierà automaticamente le catture dello schermo all’account selezionato.

1. Creare un nuovo bot su Telegram scegliendo nome e username a piacere, quindi annotare l’API Token fornito.
2. Inviare un qualsiasi messaggio al bot dal proprio account Telegram, così da generare un aggiornamento.
3. Aprire nel browser l’indirizzo: https://api.telegram.org/bot<bot-token>/getUpdates. Verrà mostrato il messaggio inviato in precedenza. Annotare il chat ID, visibile nel campo .result[0].message.chat.id.

ntfy.sh

ntfy.sh è un servizio di notifiche basato su HTTP, utilizzabile tramite l’istanza pubblica oppure tramite un’installazione privata.

I topic sono pubblici per impostazione predefinita: chiunque conosca il nome può inviare o ricevere notifiche. Per motivi di sicurezza è consigliato scegliere un nome difficile da indovinare o proteggerlo tramite un access token.

1. Scegliere un nome univoco e non immediato per il topic (ad esempio: my-switch-captures-abcdefg).
2. (Opzionale) Creare un access token tramite la pagina ntfy.sh/account.
3. Iscriversi al topic tramite l’app mobile di ntfy o l’interfaccia web, ad esempio: https://ntfy.sh/my-switch-captures-abcdefg.

Discord

Per utilizzare Discord è necessario creare un’applicazione e un bot dedicato. Il bot si occuperà di inviare le catture direttamente in un canale del server.

La procedura richiede qualche passaggio in più rispetto alle altre piattaforme.

1. Seguire la guida “Creating a Bot Account” per ottenere il Bot Token e invitare il bot nel proprio server, assicurandosi di assegnargli almeno il permesso “Inviare messaggi”.
2. Recuperare il Channel ID del canale in cui verranno inviate le catture: abilitare la Modalità Sviluppatore nelle impostazioni di Discord, fare clic con il tasto destro sul canale desiderato e selezionare “Copia ID canale”.

Installazione

Dopo aver configurato almeno una destinazione di upload, è possibile procedere con l’installazione del sysmodule sulla Nintendo Switch.

1. Scaricare l’ultima release e estrarne il contenuto.
2. Copiare il file config/NX-ScreenUploader/config.ini.template in config/NX-ScreenUploader/config.ini.
3. Modificare il file config.ini in base alle destinazioni scelte:
   • Telegram: Impostare telegram = true nella sezione [general], quindi inserire bot_token e chat_id nella sezione [telegram].
   • ntfy.sh: Impostare ntfy = true nella sezione [general], quindi configurare topic e, se necessario, token nella sezione [ntfy].
   • Discord: Impostare discord = true nella sezione [general], quindi definire bot_token e channel_id nella sezione [discord].
     • È possibile abilitare più destinazioni contemporaneamente.
4. Copiare tutti i file della release nella root della scheda SD della Nintendo Switch.

Changelog

Nuove funzionalità

• Integrazione Immich: Aggiunto il supporto per il caricamento di screenshot e video verso istanze self-hosted di Immich tramite API. Ora è possibile configurare server_url e api_key nella nuova sezione [immich] del file config.ini. (Contributo di @hax4dazy)

Correzioni di bug

• Upload video su Telegram: Aggiunti i parametri mancanti relativi alle dimensioni video (1280×720) per Telegram, così da garantire una corretta formattazione e visualizzazione dei video all’interno della chat.
• Stabilità del sistema: Corretta una perdita di memoria e un potenziale crash del sysmodule durante il flusso di upload verso Immich, liberando correttamente le risorse cURL MIME. (Contributo di @hax4dazy)

Miglioramenti e manutenzione

• Logging migliorato: Il logger è stato aggiornato includendo timestamp locali (ad esempio [2026-05-09 16:19:14]) per migliorare la leggibilità e semplificare il debug.
• Supporto profiling: Rinominati i flag e gli script interni dedicati alla misurazione dei tempi per una maggiore chiarezza (ENABLE_TIME_FUNCTIONS diventa ENABLE_PROFILING, mentre build-with-time.sh viene rinominato in build-with-profiling.sh).
• Pulizia del codice: Rimossi vecchi frammenti di codice legacy inutilizzati (fopen e CURLOPT_READFUNCTION) dalla nuova implementazione Immich, oltre a una generale formattazione del codice dell’intero progetto.
• Documentazione: Aggiornati i file README.md in inglese e cinese con nuove istruzioni per configurare la destinazione di upload Immich.

Download: NX-ScreenUploader v0.2.0

Download: Source code NX-ScreenUploader v0.2.0

Alcune parti di questo articolo sono state generate con l’aiuto dell’intelligenza artificiale.

Ultimo aggiornamento 2026-06-11 / Link di affiliazione / Immagini da Amazon Product Advertising API