NX-ScreenUploader è un piccolo sysmodule per console Nintendo Switch che automatizza completamente l’invio di screenshot e video verso Telegram, Discord o ntfy.sh, eliminando la necessità di estrarre la scheda SD o usare applicazioni aggiuntive.

Funziona in background con Atmosphere, monitora la cartella Album e invia ogni nuova cattura in pochi secondi direttamente al dispositivo o al server scelto.

Rispetto alle soluzioni precedenti, è più leggero, stabile e non richiede dipendenze esterne. Consuma circa 1,3 MB di RAM, non va in conflitto con altri sysmodule e si configura in meno di un minuto tramite un semplice file .ini.

L’installazione è immediata: basta scaricare la release, impostare le credenziali per Telegram, Discord o ntfy.sh, installare l’NSP con uno dei tool compatibili e riavviare la console.

Una volta attivo, ogni screenshot apparirà nella destinazione configurata in circa due secondi, mentre i video arrivano in pochi istanti a seconda della rete. I file rimangono comunque archiviati nella console, così nulla viene rimosso.

Il sysmodule risulta nettamente più rapido e comodo rispetto ai metodi tradizionali come estrazione della SD, FTP o QR transfer.

Per gli utenti più esigenti sono possibili anche funzioni avanzate, come l’invio simultaneo verso più piattaforme, l’uso di canali Telegram privati, notifiche silenziose o la gestione di più console con lo stesso webhook.

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à

• Aggiunto il supporto per l’invio delle catture anche su Discord.

Miglioramenti

• Aggiornata l’integrazione con Discord per maggiore affidabilità e chiarezza.
• Aggiornata la documentazione README per includere Discord come destinazione di upload.

Refactor e ottimizzazioni

• Rimossa la funzione legacy sendFileToServer per rendere il codice più chiaro e leggibile.
• Aggiornata la configurazione CMake a C++23 e ottimizzati i flag del compilatore.

Varie

• Aggiornata la versione del progetto alla 0.1.7.

Download: NX-ScreenUploader v0.1.7

Download: Source code NX-ScreenUploader v0.1.7