Pubblicato un nuovo aggiornamento per 3DSlibris, il programma nato dal desiderio di riportare in vita lo storico DSLibris, uno dei lettori di ebook più apprezzati ai tempi del Nintendo DS.

Sviluppato da RigleGit, questo homebrew rappresenta un salto di qualità significativo rispetto alle versioni precedenti, offrendo un’esperienza di lettura più stabile e fluida.

L’aggiornamento 2.0.3 si concentra principalmente sulla robustezza dell’avvio, sulla corretta gestione dei file runtime inclusi e sulla chiarezza dei messaggi di errore quando non sono presenti libri, risolvendo i problemi di crash della build installabile .cia su hardware reale e su emulatori come Azahar.

Ora il pacchetto .cia include correttamente tutti i font e le risorse UI, eliminando la necessità di copie manuali su SD, e il sistema di fallback degli asset garantisce che le risorse vengano caricate correttamente sia da SD sia da RomFS.

Questa versione mantiene tutte le funzionalità della linea 2.0.x, tra cui il supporto PDF, CBZ e XPS basato su MuPDF, il rendering progressivo dei layout fissi, l’apertura asincrona dei file MOBI sul New 3DS, la generazione automatica delle miniature delle copertine e la presenza di asset runtime inclusi per le installazioni .cia.

Migliorata inoltre la gestione dei messaggi di primo avvio e delle schermate di errore, che ora risultano stabili e chiare anche in assenza di libri.

Gli aggiornamenti precedenti, dalla versione 2.0.0 in poi, hanno introdotto importanti miglioramenti per la lettura dei PDF e dei CBZ, inclusi lo zoom dettagliato, anteprima sul touch screen inferiore, navigazione tramite outline e caricamento progressivo delle pagine.

Il rendering asincrono sul secondo core del New 3DS mantiene l’interfaccia fluida anche con file pesanti, mentre la gestione avanzata di Unicode, immagini e tabelle dei contenuti ottimizza l’esperienza di lettura.

L’apertura dei libri è molto più veloce e l’installazione tramite file .cia è semplificata, con font e risorse già inclusi.

Formati supportati

Supporto eccellente

• EPUB (EPUB2 + EPUB3 con parsing NAV/NCX e sistemi di fallback robusti).

Buon supporto (formati orientati al testo)

• FB2
• TXT
• RTF
• ODT

Sperimentale / miglior sforzo possibile

• MOBI
  • La prima apertura può risultare lenta con libri di grandi dimensioni (decompressione, parsing e paginazione).
  • Le aperture successive sono più rapide grazie alla cache persistente delle pagine.
  • La qualità dell’indice (TOC) è spesso basata su metodi euristici e può risultare approssimativa.
  • È disponibile un’opzione facoltativa di correzione del line wrap per singolo libro, utile per file convertiti male che interrompono il testo riga per riga.
  • I libri vuoti o corrotti vengono segnalati con un messaggio di errore leggibile invece di un codice numerico grezzo.

Limitazioni note

• Alcuni file EPUB contengono ancore malformate; i salti nell’indice possono risultare approssimativi quando i metadati sono danneggiati.
• L’estrazione dell’indice nei file MOBI dipende dalla struttura del file e può omettere o unire alcune voci in certi libri.
• Alcuni file MOBI malformati possono contenere errori di codifica o artefatti OCR che non possono essere corretti in modo affidabile dal lettore.
• Dopo aver cambiato dimensione del font, spaziatura dei paragrafi, orientamento, font di lettura o l’opzione di correzione del line wrap MOBI, è necessario riaprire il libro corrente per applicare il nuovo layout.
• La posizione di lettura e i segnalibri esistenti vengono riallineati in modo approssimativo dopo la riapertura e potrebbero spostarsi di alcune pagine.
• Nessun supporto per ebook con DRM.

Installazione

Metodo consigliato

• Scaricare il file 3dslibris-sdmc.zip.
• Estrarre l’archivio nella root della scheda SD, in modo che venga creato il percorso sdmc:/.
• Inserire gli ebook nella cartella sdmc:/3ds/3dslibris/book/.
• Avviare sdmc:/3ds/3dslibris/3dslibris.3dsx tramite Homebrew Launcher.

Metodo alternativo

• Installare il file 3dslibris.cia.
• Mantenere le stesse cartelle di runtime sulla SD, incluse sdmc:/3ds/3dslibris/font/ e sdmc:/3ds/3dslibris/resources/.
• Inserire i libri nella cartella sdmc:/3ds/3dslibris/book/.

Importante

• Le cartelle font/ e resources/ devono rimanere esattamente dentro sdmc:/3ds/3dslibris/.
• Se i file di runtime mancano, 3dslibris interromperà l’avvio e chiederà di reinstallare 3dslibris-sdmc.zip.
• 3dslibris-debug.3dsx usa la stessa struttura SD e salva log dettagliati in sdmc:/3ds/3dslibris/3dslibris.log.
• La build .cia utilizza il sistema di packaging stile Universal-Updater, ma la struttura dei file sulla SD rimane identica alla versione .3dsx.

Controlli (predefiniti)

• / / / → gira pagina.
• / → salta tra i segnalibri.
• → attiva/disattiva segnalibro.
• → cambia colore dello sfondo.
• → impostazioni.
• → ritorna alla libreria.
• Interfaccia touch per libreria, impostazioni, indice, segnalibri e menu dei font.

Changelog v1.1.0

Questa versione amplia il recente lavoro svolto per migliorare i lettori, offrendo un aggiornamento più completo incentrato sulle immagini incorporate, sulla reattività dei file EPUB e sulla navigazione quotidiana su una vera console 3DS.

Punti salienti

• Navigazione della libreria: ora puoi spostarti tra i libri nella griglia utilizzando il D-Pad e premere per aprirli.
• Le immagini nei libri EPUB e MOBI vengono ora visualizzate correttamente: icone piccole, separatori larghi e immagini a piena pagina non occupano più tutto lo schermo né scompaiono.
• I libri EPUB ricchi di immagini si aprono molto più velocemente grazie a ottimizzazioni interne nel caricamento delle immagini dall’archivio.
• Le miniature delle copertine dei libri MOBI nella libreria vengono generate più rapidamente nelle visite successive, poiché i dati della copertina vengono memorizzati tra una sessione e l’altra.
• Non è più necessario configurare manualmente la scheda SD per le installazioni .cia: il file .cia include già tutti i font e le risorse dell’interfaccia, quindi è sufficiente una semplice installazione dal menu Homebrew.
• Rendering del testo migliorato su tutti i formati: gestione più precisa delle interruzioni di riga, migliore supporto ai caratteri speciali e dimensioni dei font limitate per evitare problemi di impaginazione.
• I blocchi di codice e le sezioni <pre> negli EPUB ora vanno automaticamente a capo invece di uscire dai bordi dello schermo.
• I libri MOBI beneficiano di diversi miglioramenti: indice più accurato, migliore gestione del testo semplice per una lettura più naturale e supporto ai file compressi HUFF/CDIC.

Dettagli estesi

Layout immagini e cache

• Corretto un problema di mancata corrispondenza tra impaginazione e rendering che poteva far scomparire il testo subito dopo immagini inline in alcuni libri.
• I blocchi di icone all’inizio dei paragrafi negli EPUB ora restano associati in modo più affidabile al testo esplicativo.
• Le immagini SVG non risolvibili all’interno dell’archivio EPUB vengono ora segnalate correttamente invece di passare XML grezzo al decoder delle immagini.
• Il controllo dei limiti per immagini di grandi dimensioni è ora applicato in modo uniforme sia durante l’analisi dei metadati sia nel rendering delle pagine, evitando allocazioni di memoria incontrollate con immagini danneggiate o troppo grandi.
• L’estrazione delle copertine MOBI ora memorizza nella cache i metadati tra una sessione e l’altra, evitando scansioni complete ripetute per libri già analizzati.
• I libri MOBI di grandi dimensioni limitano ora le scansioni iniziali e di fallback dei record immagine usati per individuare la copertina, riducendo il lavoro inutile.
• Un raro errore nella decodifica delle immagini inline MOBI viene ora ritentato in modalità RGB, risolvendo i casi in cui un JPEG valido occupava spazio ma non veniva renderizzato.

Miglioramenti MOBI

• Il logging del parsing MOBI è ora bufferizzato durante le fasi di debug più intense, riducendo il rumore dell’I/O senza perdere informazioni utili.
• La paginazione con “keep-with-next” protegge ora le intestazioni semantiche MOBI generate durante l’estrazione del markup, evitando l’uso di euristiche troppo ampie basate sulle righe che potevano spostare frasi normali.
• Le immagini inline MOBI ora vengono caricate e gestite correttamente dal sistema avanzato di layout immagini, inclusi i libri che utilizzano riferimenti recindex con valori con padding di zeri.

Testo e layout

• I limiti della dimensione del testo sono ora fissati in un intervallo sicuro tra 8 e 20, prevenendo crash e problemi di impaginazione causati da valori estremi.
• Le scritture nel buffer delle pagine sono state rese più sicure contro overflow, e i contenuti troppo grandi attivano ora una gestione più sicura dell’interruzione di pagina invece di corrompere il contenuto.

Changelog v2.0.0

Questa versione racchiude l’intera evoluzione del lettore a partire dalla serie 1.1.0, ampliandola con un importante aggiornamento sia per i contenuti a layout fisso che per quelli reflowable.

La novità principale è che 3DSlibris non è più soltanto un lettore per ebook a layout adattivo: ora integra anche un sistema per documenti a layout fisso basato su MuPDF per file come i PDF, migliorando al tempo stesso in modo significativo il supporto a MOBI, EPUB e FB2, oltre alla gestione del packaging e alla stabilità generale in fase di esecuzione.

Punti salienti

• Lettura di PDF, CBZ e XPS: è possibile aprire documenti PDF, fumetti (CBZ) e file XPS con zoom, anteprima della pagina completa sullo schermo inferiore e navigazione tramite indice quando disponibile.
• Caricamento progressivo delle pagine: viene mostrata subito un’anteprima della pagina, che viene poi migliorata in background fino alla qualità completa, senza dover attendere il rendering totale prima di interagire.
• Prestazioni migliorate su New 3DS: il rendering delle pagine per PDF e CBZ viene eseguito su un core separato, mantenendo l’interfaccia fluida; Old 3DS resta supportato con fallback automatico.
• Apertura asincrona dei libri MOBI su New 3DS: i libri si aprono senza bloccare l’interfaccia, permettendo di iniziare a leggere mentre il resto del contenuto viene caricato in background.
• Copertine della libreria per tutti i formati: EPUB, FB2, MOBI, PDF e CBZ mostrano ora vere miniature delle pagine invece di immagini segnaposto.
• Inclusi tutti i miglioramenti della serie 1.1.x: immagini inline in MOBI ed EPUB, apertura più veloce dei libri ricchi di immagini, rendering del testo migliorato e indice MOBI più accurato.
• Nessuna configurazione manuale della scheda SD per installazioni .cia: font e risorse dell’interfaccia sono già inclusi.
• Avvio più stabile: i file MOBI problematici non causano più crash e l’app mostra una schermata di errore chiara invece di lampeggiare tra stati diversi in caso di problemi.

Dettagli estesi

Motore layout fisso (PDF / CBZ / XPS)

• Aggiunto il supporto alla lettura PDF basato su MuPDF, con visualizzazione zoomata sullo schermo superiore, anteprima della pagina completa su quello inferiore, navigazione tramite indice quando disponibile e movimento del viewport tramite touch.
• Esteso lo stesso sistema di layout fisso anche a CBZ e XPS, riutilizzando lo stesso motore di rendering e flusso del lettore invece di mantenere implementazioni separate.
• Introdotta una pipeline di rendering progressivo per i layout fissi: prima una preview, poi una cache interattiva e infine il perfezionamento completo della pagina in background, evitando blocchi durante il rendering.
• Aggiunto il rendering progressivo a strisce per le pagine zoomate, con le varie sezioni che vengono composte sullo schermo man mano che sono pronte.
• Utilizzo di un thread dedicato per il layout fisso sul core aggiuntivo del New Nintendo 3DS quando disponibile, mantenendo un fallback sincrono automatico per Old 3DS.
• Migliorata la gestione della cache per i layout fissi, con aggiornamenti più stabili del viewport di anteprima, riutilizzo più rapido della cache e operazioni di prefetch pesanti rinviate ai cambi pagina o ai momenti di inattività.
• I controlli del lettore per layout fisso sono ora documentati in modo uniforme per PDF, CBZ e XPS: / per lo zoom, /per cambiare pagina, / per navigare nell’indice quando disponibile, touch per muovere il viewport e / per tornare alla libreria o aprire le impostazioni.
• Migliorata la documentazione e le note di licenza per le build basate su MuPDF, inclusa la gestione delle sorgenti corrispondenti per la distribuzione pubblica.

MOBI e apertura differita

• L’apertura dei file MOBI su New 3DS utilizza ora il reflow asincrono, eliminando i lunghi tempi di attesa nell’interfaccia, mentre Old 3DS mantiene un fallback sincrono.
• I libri MOBI di grandi dimensioni completano molto più rapidamente la generazione differita dell’indice (TOC), riutilizzando dati già strutturati ed evitando ricostruzioni inutili dei metadati.
• Il parsing MOBI e il reflow differito sono stati rielaborati per ridurre i tempi di apertura dei libri più grandi, con tempistiche più dettagliate disponibili nelle build di debug.
• Il percorso di apertura differita è ora più pulito su hardware reale: la scrittura della cache delle pagine EPUB è stata rimossa dal percorso critico, il logging bufferizzato evita overhead dovuti alla riapertura dei file e il completamento differito dei MOBI non sovraccarica più l’output di debug durante la paginazione in background.

Copertine libreria e browser

• La generazione delle copertine è ora una funzionalità centrale: le miniature delle pagine visibili vengono memorizzate in cache e riutilizzate, e il libro selezionato riceve priorità di caricamento dopo brevi periodi di inattività. Le copertine funzionano ora per EPUB, FB2, MOBI, PDF e CBZ.
• Le miniature di PDF e CBZ vengono ora generate dalla prima pagina, rendendo i formati a layout fisso più integrati con il resto della libreria.
• Il browser e il rendering dei layout fissi tracciano con maggiore precisione le aree modificate e riutilizzano i framebuffer fisici in cache, riducendo i costi di ridisegno e risolvendo un problema per cui le copertine generate correttamente non venivano mostrate.

Testo e layout

• EPUB e FB2 condividono ora strumenti migliori per l’analisi del layout del testo e un sistema unificato per la gestione di interruzioni e misurazioni, migliorando la precisione nel rendering reale dei libri.
• I miglioramenti al motore di testo introdotti con la serie 1.1.0 restano presenti: migliore gestione Unicode, interruzioni di riga più accurate, limiti più sicuri per la dimensione del testo e gestione più robusta dei buffer delle pagine.
• Il supporto MOBI mantiene anche i miglioramenti della serie 1.1.x, tra cui immagini inline più affidabili, estrazione delle copertine più sicura, decodifica dei record più corretta e una gestione del testo semplice più naturale per la lettura.

Changelog v2.0.1

Questa versione ripubblica lo stato reale del ramo successivo alla 2.0.0 come un tag pubblico pulito. I miglioramenti funzionali del lettore introdotti nella serie 2.0.0 restano invariati, ma la 2.0.1 è il primo rilascio che riflette completamente il codice dopo le operazioni di pulizia, centralizzazione dei percorsi, refactoring dei test e riorganizzazione del repository.

Punti salienti

• Allineamento completo del ramo: la versione 2.0.1 include i commit mancanti completati dopo il rilascio originale della 2.0.0, rendendo la versione pubblica coerente con il ramo principale mantenuto.
• Percorsi runtime centralizzati: i percorsi per SD, cache e filesystem correlati sono ora gestiti in un livello condiviso invece di essere duplicati tra i vari sottosistemi.
• Struttura del repository più pulita: gli strumenti condivisi sono stati riorganizzati, i file duplicati legacy rimossi e le librerie expat incluse sono state spostate nella directory third_party/.
• Codice della cache MOBI separato: la serializzazione e invalidazione della cache delle pagine sono ora gestite in un modulo dedicato, invece di essere integrate nel sistema generale di I/O dei libri.
• Miglioramenti ai test nativi: i test per layout del testo e Unicode utilizzano ora un sistema condiviso di build, evitando compilazioni ripetute delle stesse dipendenze.
• Documentazione tecnica ampliata: il repository include ora note architetturali e riferimenti hardware per NDS/3DS derivati da GBATek, utili per la manutenzione futura.

Funzionalità del lettore incluse

• Supporto a PDF, CBZ e XPS basato su MuPDF.
• Rendering progressivo per layout fisso con anteprima immediata.
• Apertura asincrona/differita dei file MOBI su New 3DS.
• Generazione automatica delle miniature delle copertine per EPUB, FB2, MOBI, PDF e CBZ.
• Asset runtime inclusi per le installazioni in formato .cia.

Changelog v2.0.2

Questa versione corregge la build installabile in formato .cia, permettendone nuovamente l’avvio corretto sia su hardware reale sia su Azahar.

Punti salienti

• Risolto l’avvio dei file CIA su hardware e Azahar: il codice NCCH ora viene generato senza compressione, evitando il crash presente nelle precedenti build 2.0.1.
• Nessuna modifica alle funzionalità del lettore: si tratta di un aggiornamento focalizzato esclusivamente sul packaging per ripristinare una build installabile funzionante.
• Percorso di build CIA pulito: la build locale include anche una piccola correzione alla dichiarazione in book_io.cpp, necessaria per una ricompilazione corretta.

Changelog v2.0.3

Questa versione risolve i rimanenti problemi di runtime e packaging delle build .cia, permettendo all’installabile di comportarsi correttamente sia su hardware reale sia su Azahar.

L’aggiornamento si concentra sulla robustezza all’avvio, sui dati runtime inclusi e su una gestione chiara dello schermo di errore quando non sono presenti libri.

Punti salienti

• RomFS incluso per le build .cia: la build installabile ora contiene effettivamente i font e le risorse UI incluse, invece di prepararli localmente ma ometterli dal pacchetto finale.
• Risolto il crash all’avvio specifico delle CIA: una voce di cache nulla nel percorso di teardown di testo/font poteva causare un ARM11 data abort; l’inizializzazione dei font e la pulizia della cache sono ora più sicure.
• Migliore fallback degli asset runtime: font e risorse inclusi vengono ora risolti in sicurezza tra SD e RomFS, quindi le installazioni .cia non dipendono più da una copia manuale di font/risorse per l’avvio.
• Schermi di avvio critici stabili: le schermate di errore all’avvio e in assenza di libri non lampeggiano più tra vecchi e nuovi frame in attesa del tasto START.
• Comportamento più chiaro al primo avvio: se non ci sono libri, l’app mostra un messaggio stabile che indica di copiare i file EPUB, FB2, TXT, RTF o ODT in sdmc:/3ds/3dslibris/book.
• Validazione della build CIA aggiunta alla CI: GitHub Actions ora costruisce e verifica anche il percorso .cia, controllando che il RomFS contenga i file runtime inclusi.

Funzionalità del lettore incluse

• Supporto PDF, CBZ e XPS basato su MuPDF.
• Rendering progressivo per layout fisso.
• Apertura asincrona/differita dei file MOBI su New 3DS.
• Generazione automatica delle miniature delle copertine nella libreria.
• Asset runtime inclusi per le installazioni in formato .cia.

Download: 3dslibris v2.0.3 (debug 3dsx)

Download: 3dslibris v2.0.3 (sdmc zip) (smdh)

Download: 3dslibris v2.0.3 (3dsx) (cia) (elf)

Download: Source code 3dslibris v2.0.3

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

Ultimo aggiornamento 2026-05-13 / Link di affiliazione / Immagini da Amazon Product Advertising API