Il developer RigleGit ha da poco pubblicato un nuovo aggiornamento per 3DSlibris, il progetto nato con l’obiettivo di riportare su Nintendo 3DS l’esperienza di lettura già vista in passato con DSLibris.

L’app continua a evolversi come un lettore ebook semplice ma efficace, progettato per sfruttare al meglio l’hardware della console mantenendo un’interfaccia chiara e immediata.

Questa nuova versione introduce miglioramenti significativi sia nella resa dei file EPUB che nelle prestazioni generali. La lettura risulta più fluida grazie a una gestione più efficiente della memoria e a numerose ottimizzazioni interne che riducono il carico durante operazioni come la paginazione e il rendering del testo.

Anche l’interfaccia beneficia di alcune aggiunte utili, come l’indicatore della batteria direttamente nell’HUD del lettore e la possibilità di scegliere se utilizzare o meno la dimensione dei font definita dall’editore.

Parallelamente, sono stati risolti diversi problemi legati alla stabilità, tra cui un fix importante che dovrebbe prevenire i crash del menu HOME dopo la lettura, uno degli aspetti più critici delle versioni precedenti.

Migliorie tecniche meno visibili, ma fondamentali, riguardano la gestione delle connessioni interne tra thread e l’ottimizzazione del comportamento del sistema durante sospensione e ripresa.

Grande attenzione è stata dedicata anche alla compatibilità con gli standard EPUB e CSS. Il rendering dei contenuti ora rispetta meglio stili e formattazioni, con un supporto più completo per margini, allineamenti, interruzioni di pagina e gestione dello spazio bianco.

Elementi come immagini, liste nidificate e testi formattati vengono visualizzati in modo più fedele alle intenzioni degli autori, migliorando sensibilmente l’esperienza di lettura su schermo.

Non mancano miglioramenti alla navigazione interna: i link negli EPUB ora sono sempre visibili e facilmente distinguibili, mentre la modalità dedicata consente di spostarsi tra collegamenti anche attraversando più pagine.

Anche il sistema di gestione dei contenuti, inclusi capitoli e indice, è stato reso più affidabile, soprattutto per file che includono metadati avanzati come quelli dei fumetti in formato CBZ.

Sul fronte delle immagini, il comportamento è stato corretto per evitare problemi dopo il rebuild della cache e per garantire una resa più coerente, sia per le copertine che per gli elementi decorativi.

Allo stesso tempo, sono state introdotte ulteriori ottimizzazioni per evitare sprechi di risorse, mantenendo alte le prestazioni anche con file più complessi.

L’infrastruttura del progetto è stata aggiornata con strumenti di controllo qualità del codice e una pulizia generale delle componenti obsolete, mentre la community ora può contare su uno spazio dedicato su GitHub per discutere bug, idee e sviluppo futuro, rendendo il progetto ancora più aperto e collaborativo.

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 v2.6.2

Migliorato il rendering EPUB e le prestazioni, aggiunto un nuovo indicatore della batteria nell’HUD del lettore, un toggle opzionale per la dimensione del font del publisher e una correzione critica thread-safe per APT suspend (si spera) che previene i crash del menu HOME dopo la lettura.

Miglioramenti

• Aggiunto indicatore del livello batteria nell’HUD del lettore.
• Aggiunto toggle per la dimensione del font del publisher nelle impostazioni.
• #85: supporto allo stile base <hr/> per il reflow EPUB.
• Ridotte le allocazioni heap durante la paginazione.
• Riutilizzo dei buffer di analisi BiDi tra le paginazioni.
• Evitata una copia completa di buffer temporaneo durante l’estrazione della cover EPUB alla prima apertura.
• Avvio anticipato del warmup della cover visibile su New 3DS in modalità browser conservativa.
• Rimosso il caricamento completo dei dati OPF nella sola indicizzazione dei metadati EPUB.
• Evitato lavoro extra su testo LTR semplice durante lo shaping del testo EPUB.
• Riutilizzo degli advance dei glifi Latin-1 durante la paginazione per la misurazione del testo EPUB.
• Evitato l’uso del decoder Unicode pesante durante il layout per testo UTF-8 latino semplice.
• Batch del testo contenuto EPUB prima dello shaping.
• Consolidate le lookup delle classi CSS in un singolo passaggio per elemento.
• Semplificato il codice di disegno delle etichette dei pulsanti.
• Semplificata la funzione ContainsRTL nei tool BiDi.

Correzioni

• #87: Rendering di immagini EPUB grandi spostando il controllo del budget pixel dal metadata probe al momento del disegno.
• #84: Supporto a CSS margin-top e margin-bottom nel reflow EPUB.
• #68: Rimandate le modifiche dello stato dell’hook APT suspend al thread principale per correggere problemi di scrittura cross-thread, crash e freeze del menu HOME.
• Seguire l’ordine del documento manifest per l’ordinamento della spina EPUB quando il link NAV TOC è assente.
• #82: Accumulo corretto dell’indentazione delle liste annidate per livello di profondità.
• Applicazione della promozione CSS display:block alle proprietà di layout a livello blocco.
• Ripristino del percorso di apertura EPUB dopo una regressione del riutilizzo del parser.
• #83: Assicura che text-align dalle definizioni delle classi CSS si applichi correttamente agli elementi block.
• #76: Rispettato list-style-type: none su <ol> e <ul>.
• #35: Mantenuti i valori di lunghezza adiacenti nello shorthand CSS margin con valori auto.
• uso della base del documento invece della dimensione ereditata per il ripristino del font-size dei titoli.
• #81: Limitate le dimensioni CSS troppo piccole a un intervallo leggibile.
• Saltati i cambi inline di font-size senza effetto.
• Mantenuto il fast-path delle thumbnail sotto il controllo di sicurezza RGB per le cover EPUB PNG/JPEG grandi.

Infrastruttura

• Silenziate le build di debug rumorosi dopo il pass di profiling EPUB/cover.
• rimosse le utility obsolete del parser EPUB lasciate dalla consolidazione delle lookup CSS.

Changelog v2.6.1

Nuovo

• Indice capitoli CBZ tramite ComicInfo.xml: I file .cbz che includono un file ComicInfo.xml (come quelli generati da strumenti come ComicTagger) ora mostrano un indice dei contenuti. Le pagine con attributo Bookmark nella sezione <Pages> vengono visualizzate come capitoli con nome nel menu dell’indice. I file senza ComicInfo.xml o senza bookmark non vengono modificati. Vedere #67.

Community

• GitHub Discussions è ora aperto: Domande, analisi dei bug, idee e discussioni sullo sviluppo hanno uno spazio dedicato su github.com/RigleGit/3dslibris/discussions. La categoria bug triage include un modulo strutturato che raccoglie versione, modello della console, formato e passaggi per la riproduzione, per rendere il debug più semplice.

Correzioni e miglioramenti

• I link interni sono visibili durante la lettura: I link EPUB interni ora vengono renderizzati in blu in ogni momento, utilizzando un blu scuro nei temi chiari e un blu chiaro nei temi scuri. Vedere #69
• La modalità Link ora può muoversi tra le pagine: Tenere premuto per utilizzare la Link Mode, il D-Pad passa al prossimo link inline e il D-Pad al link precedente, continuando anche sulle pagine vicine quando necessario. Il D-Pad / mantiene invece la navigazione spaziale già esistente all’interno della pagina corrente. Vedere #69
• Le immagini raster EPUB non vengono più convertite in [illustration] dopo la ricostruzione della cache. Vedere #70
• Il testo centrato nei blocchi EPUB è nuovamente allineato correttamente: text-align sui contenitori block come body, div, section ed elementi display:block ora viene applicato al testo al loro interno ed ereditato da paragrafi e titoli figli, a meno che non lo sovrascrivano. Vedere #71.
• Le immagini ornamentali EPUB ora vengono renderizzate alla dimensione prevista: Le immagini inline con un attributo esplicito width="X%" oppure con uno stile CSS width: X% ora vengono limitate a quella frazione dell’area di testo invece di estendersi a tutta la larghezza. Elementi decorativi come separatori, stelle e barre, creati con una piccola percentuale della larghezza della riga, ora vengono mostrati a quella dimensione invece di occupare l’intero schermo. Vedere #74.
• CSS page-break-before: always ora viene rispettato: Gli elementi block con page-break-before: always (o l’equivalente CSS3 break-before: page) nei loro attributi inline style= o nelle classi del foglio di stile forzano il contenuto a iniziare su una nuova pagina, come previsto dagli autori EPUB. È supportato anche page-break-after: always. Vedere #72
• CSS page-break-inside: avoid ora viene rispettato: I blocchi contrassegnati con page-break-inside: avoid (o break-inside: avoid) vengono mantenuti insieme e non vengono spezzati su due pagine.
• Più proprietà CSS sono ora applicate dai fogli di stile: Gli stylesheet EPUB ora possono controllare text-decoration: none (rimuovere la sottolineatura da un elemento), font-weight: normal/lighter/100–500 (reimpostare il grassetto ereditato), font-style: normal (reimpostare il corsivo ereditato), font-size con unità pt e keyword assolute (da xx-small a xx-large), e margin-top/margin-bottom con unità em, rem e pt. Sia gli attributi inline style= che le regole di classe vengono riconosciuti.
• I margini orizzontali CSS ora vengono applicati: margin-left e margin-right sugli elementi block degli EPUB influenzano sia la larghezza del testo che l’inizio delle righe visibili, includendo classi dei fogli di stile, percentuali, shorthand e valori negativi.
• text-indent e text-transform CSS ora sono applicati: text-indent controlla l’indentazione della prima riga del paragrafo; un valore CSS sovrascrive l’indentazione predefinita e un valore negativo o pari a zero la disattiva completamente. text-transform: uppercase, lowercase e capitalize trasformano il testo durante la fase di parsing, e gli elementi inline trasformati vengono misurati prima del wrapping delle righe, evitando così overflow o tagli. Vedere #73
• CSS text-align: start e text-align: end ora sono supportati.
• Le modalità white-space CSS ora sono rispettate: pre, pre-wrap, pre-line e nowrap controllano la gestione degli spazi e la preservazione delle interruzioni di riga nei contenuti EPUB, permettendo a blocchi di codice e testi preformattati di essere visualizzati come previsto dall’autore. Sulla schermata del 3DS, nowrap viene comunque adattato quando necessario dopo la compressione degli spazi, così le righe lunghe restano leggibili.
• CSS float e clear ora vengono applicati alle immagini: float: left fissa un’immagine al margine sinistro e float: right la fissa al margine destro. clear: both, clear: left e clear: right forzano un’interruzione di riga prima dell’elemento di clearing. Il testo che avvolge le immagini flottanti non è ancora supportato; l’immagine occupa una propria sezione e il contenuto successivo inizia sotto di essa. Parser e renderer ora condividono lo stesso override di layout per le immagini flottanti, quindi le piccole immagini decorative flottanti non vengono più renderizzate inline dopo che la paginazione le ha trattate come blocchi separati.
• Le liste EPUB nidificate ora sono visivamente indentate: Le liste ordinate o non ordinate di secondo e terzo livello spostano verso l’interno i propri marker e le righe a capo, rendendo distinguibili a schermo i sotto-livelli con bullet, lettere e numeri romani.
• font-size inline e i tag <small>/<big> ora vengono renderizzati: Qualsiasi elemento con una proprietà CSS font-size, tramite inline style= o tramite una classe del foglio di stile, mostra il testo alla dimensione specificata. Il tag <small> applica un fattore di scala più piccolo (~83% della dimensione corrente) mentre <big> applica un fattore più grande (~120%). Sono supportate tutte le unità: px, em, rem, pt, %, smaller, larger e le keyword assolute da xx-small a xx-large. La dimensione viene ripristinata correttamente alla chiusura dell’elemento e vengono gestiti anche i page break all’interno dell’elemento. Vedere #75
• Il menu HOME non si blocca più dopo il ritorno alla libreria (si spera): Premere HOME o spegnere la console dopo aver chiuso un libro non causa più il crash del processo del menu HOME. Sono stati risolti tre problemi. Vedere #68
  • Le preferenze venivano scritte sulla scheda SD all’interno di una callback APT hook, bloccando la finestra di conferma del menu HOME.
  • I worker di rendering in background per PDF e CBZ potevano liberare memoria ancora in uso da un thread di rendering (use-after-free).
  • Il passaggio da un libro PDF/CBZ alla libreria ora annulla qualsiasi rendering in background in corso prima che il browser avvii nuovi processi di lavoro.

Download: 3dslibris v2.6.2 (debug 3dsx) (debug cia)

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

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

Download: Source code 3dslibris v2.6.2

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