Pubblicato un nuovo aggiornamento per WiiPy, lo strumento a riga di comando che sfrutta le funzionalità di libWiiPy per gestire i formati di file utilizzati sulla console Wii.

Oltre a servire come strumento pratico per l’uso di queste funzionalità, WiiPy funge anche da implementazione di riferimento per libWiiPy, progettata per sfruttare tutte le sue caratteristiche.

L’applicazione è multipiattaforma e compatibile con macOS, Windows e Linux, grazie alla sua implementazione in puro Python e alla possibilità di essere compilata per tutte e tre le piattaforme tramite Nuitka.

Per conoscere le funzionalità supportate, è consigliato consultare l’elenco delle caratteristiche offerte da libWiiPy. L’applicazione è stata testata su Python 3.11 e 3.12, e funziona correttamente in entrambi gli ambienti.

L’unica dipendenza di WiiPy è libWiiPy stessa, quindi qualsiasi versione compatibile con la libreria dovrebbe essere supportata senza problemi. Per installare libWiiPy e tutte le sue dipendenze, basta eseguire il comando pip install -r requirements.txt.

L’utilizzo di WiiPy è molto semplice: basta eseguire python3 wiipy.py <comando>. È possibile consultare l’elenco di tutti i comandi disponibili con --help oppure ottenere informazioni specifiche su un comando usando <comando> --help.

Questa sintassi si estende anche ai sottocomandi, che possono essere esplorati con <comando> <sottocomando> --help. Man mano che libWiiPy aggiunge nuove funzionalità, i comandi disponibili in WiiPy si espanderanno per includerle rapidamente.

Dato che WiiPy è progettato per seguire il ramo principale di sviluppo di libWiiPy, ogni aggiornamento della libreria verrà integrato in tempi brevi, evitando problemi di compatibilità dovuti a cambiamenti strutturali.

Per chi desidera compilare WiiPy in un formato più nativo, è possibile usare Nuitka. Su Linux e macOS, è disponibile un Makefile che permette di costruire e installare l’eseguibile.

Dopo aver eseguito make all, si otterrà un file eseguibile denominato “wiipy” nella directory principale del progetto. Se si vuole rendere disponibile WiiPy a livello di sistema, si può installarlo con il comando sudo make install, che lo copierà nella cartella /usr/bin/.

Su Windows, invece, è disponibile uno script PowerShell denominato Build.ps1, che produce un file eseguibile chiamato wiipy.exe nella root del progetto.

Nella repository di WiiPy è presente anche una directory chiamata “scripts”, che contiene vari script basati su libWiiPy.

Tuttavia, questi non fanno parte ufficialmente delle release di WiiPy e non vengono testati con la stessa attenzione dell’applicazione principale. Sono inclusi unicamente per chi potrebbe trovarli utili, senza garanzia di funzionamento o stabilità.

Changelog

Info

• Ora vengono accettati più file come TMD, Ticket o WAD validi. I file che seguono i pattern tmd.bin, tmd.*, ticket.bin e cetk saranno accettati, così come i file WAD con qualsiasi nome grazie alla lettura dell’header.
• Migliorata la formattazione degli ID titolo ASCII a 4 caratteri.
• Quando si visualizzano le informazioni di un WAD o TMD di boot2, la riga relativa all’IOS richiesto sarà ora nascosta e la versione del titolo includerà (boot2vX) dopo il numero di versione.
• Quando si visualizzano le informazioni di un intero WAD, verranno eseguiti controlli reali delle firme sui certificati, sul TMD e sul Ticket, e verranno mostrate le informazioni sulla firma.
  • Per i TMD e i Ticket, la riga Fakesigned: sarà sostituita da Signature: con i seguenti valori: Valid (Unmodified <TMD/Ticket>), Invalid (Modified <TMD/Ticket>) o Fakesigned.
  • Per il WAD nel suo insieme, la riga Fakesigned: sarà sostituita da Signing Status: con i seguenti valori: Legitimate (Unmodified TMD + Ticket), Illegitimate (Modified TMD + Ticket), Piratelegit (Unmodified TMD, Modified Ticket), Edited (Modified TMD, Unmodified Ticket) o Fakesigned.
  • Queste modifiche non influenzano i TMD o i Ticket singolarmente, e la riga Fakesigned: continuerà a essere utilizzata.
• I nomi dei canali verranno mostrati per i WAD che contengono canali.

EmuNAND

• Aggiunto il nuovo sottocomando emunand info, che fornisce un riepilogo degli IOS e dei titoli installati in un EmuNAND, oltre alla versione del System Menu e allo spazio di archiviazione utilizzato. Questo comando leggerà anche i TMD dei titoli installati e informerà l’utente di eventuali IOS richiesti da un titolo installato ma non presenti nel sistema.
• Aggiunto il nuovo sottocomando emunand install-missing, che rileverà automaticamente tutti gli IOS necessari per i titoli installati in un EmuNAND, scaricandoli e installandoli. Questo comando tenterà di determinare se viene utilizzato su un EmuNAND Wii o vWii in base al System Menu installato e, in caso di errore, assumerà che sia per Wii. L’opzione --vwii permetterà di ignorare questo comportamento e forzerà l’installazione degli IOS per vWii.

Modifica di WAD/TMD

• Ora è possibile utilizzare simboli come parte di un nuovo Title ID durante la modifica di WAD o TMD.
• Quando si modificano WAD contenenti canali, è ora possibile cambiare il nome del canale incluso.

NUS

• Ora è possibile specificare un URL personalizzato per l’endpoint NUS utilizzando l’argomento -e/--endpoint.
• Il comando è stato aggiornato per essere compatibile con le modifiche da libWiiPy v0.5.X a v0.6.0.

New Command: lz77

• Il nuovo comando lz77 permette di comprimere e decomprimere file utilizzando l’algoritmo di compressione LZ77, comunemente usato su Wii.
• Nota: mentre la decompressione è veloce, l’attuale implementazione della compressione in libWiiPy può essere molto lenta. libWiiPy supporta due livelli di compressione, ma dato che la compressione è già lenta, WiiPy al momento espone solo il livello di compressione inferiore.

Maggiori dettagli sui comandi specifici possono essere ottenuti utilizzando l’opzione --help per ciascuno di essi.

Queste build si basano sulla branch principale di libWiiPy al 28/03/2025 e utilizzano la versione di rilascio libWiiPy v0.6.0.

Download: WiiPy v1.5.0 (Linux)

Download: WiiPy v1.5.0 (MacOS ARM64) (MacOS x86_64)

Download: WiiPy v1.5.0 (Windows-bin) (Windows-onefile-bin)

Download: Source code WiiPy v1.5.0

Fonte: github.com

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