Un PinePhone.
Tutta la tua
musica.

Questa edizione riguarda il PinePhone originale con processore Allwinner A64. La prova del progetto è stata fatta sul modello da 3 GB di RAM e 32 GB di eMMC. Il modello da 2 GB richiede un collaudo separato.

Salva ciò che vuoi conservare

Copia sul computer i file della scheda di prova: la scrittura del sistema la cancellerà. La memoria interna del telefono viene toccata solo nella tappa 08, dopo un backup completo. Tieni gli originali della musica su un secondo supporto.

Hardware: scheda ufficiale PinePhone. Accesso a batteria e schede: manuale PINE64.

Il riferimento di questa guida è postmarketOS v25.12, Sxmo/Sway 1.18.0, kernel 6.17.5, build del 3 agosto 2026. postmarketOS oggi si chiama Nura: negli archivi puoi incontrare entrambi i nomi.

Verifica il file scaricato

Apri il terminale del computer nella cartella dove hai salvato l’immagine. Il risultato deve iniziare con l’hash riportato sotto, per intero.

shasum -a 256 20260803-0755-postmarketOS-v25.12-sxmo-de-sway-1.18.0-pine64-pinephone.img.xz

sha256sum 20260803-0755-postmarketOS-v25.12-sxmo-de-sway-1.18.0-pine64-pinephone.img.xz

e82b065f342207b9bc3753137b6c6a936f21f1c1d30bc1365de882d6f29afc67

Download dal server ufficiale delle immagini; hash confrontato con l’archivio usato nel progetto. Il collegamento al file è stato verificato l’8 ottobre 2026. La versione corrente della distribuzione può essere diversa: pagina ufficiale di installazione Nura.

Per la prima prova puoi usare balenaEtcher. Si occupa di scrivere l’immagine e rileggerla per la verifica.

1. Inserisci la microSD cancellabile nel lettore. Scollega gli altri dischi esterni che non servono.
2. In Etcher scegli Flash from file e apri l’immagine .img.xz della tappa 02.
3. In Select target confronta nome e capacità con la scheda inserita. La destinazione deve essere la scheda di prova.
4. Avvia Flash!, autorizza la scrittura sul computer e attendi anche la verifica finale.
5. Espelli la scheda. A PinePhone spento, rimuovi la batteria, inserisci la microSD, rimetti la batteria e chiudi il coperchio.
6. Accendi il telefono. Al primo avvio attendi il completamento della preparazione del sistema.

Se macOS propone di inizializzare una partizione Linux dopo la scrittura, scegli Ignora. Per aprirla e modificarla useremo il PinePhone.

Il PinePhone originale può avviarsi dalla microSD prima della eMMC: ordine di avvio PINE64.

L’immagine di riferimento usa l’account user. Per il primo accesso le immagini di prova pubblicano la password iniziale 147147: cambiala sul telefono con passwd e usa da quel momento la tua.

1. In Sxmo premi Power tre volte rapidamente per aprire un terminale. In alternativa apri il menu, scegli Apps o Binaries, poi foot.
2. Se manca la tastiera, prova una pressione di Volume −. Se vedi un simbolo rosso barrato e i tocchi non rispondono, una breve pressione di Power può sbloccare gli input.
3. Collega il PinePhone al computer con il cavo USB dati. Avvia l’accesso temporaneo dal terminale del telefono:

sudo systemctl start sshd

Inserisci la password sul telefono. Il ritorno al simbolo $ senza messaggi indica che il comando è terminato. Sul computer apri una sessione:

ssh user@172.16.42.1

Al primo collegamento controlla che sia il telefono appena preparato e conferma la chiave del dispositivo. Se non viene creata la rete USB, consulta la guida alla rete USB della distribuzione. Non disattivare il controllo delle chiavi per nascondere un avviso.

Internet serve per installare i pacchetti

Per questa fase lascia lo switch 2 su ON e usa Sxmo → Networks per collegarti al Wi-Fi. In alternativa configura la condivisione Internet via USB. Il lettore, una volta preparato, riproduce i file locali anche senza rete.

uname -r
findmnt /
cat /etc/os-release

Il kernel atteso è 6.17.5. Annota la sorgente di /: ti servirà per distinguere il sistema avviato dalla scheda da quello sulla memoria interna.

Credenziali iniziali e accesso: Nura, dopo l’installazione. Menu e servizi: manuale Sxmo. I gesti possono cambiare con la versione.

Il kit contiene l’interfaccia BiaPod, il logo, i comandi della ghiera e i file per una sessione dedicata. I pacchetti Linux si scaricano dai repository configurati sull’immagine.

1. Sul computer scarica il kit, apri il terminale nella cartella del download e copialo al telefono:

scp -O biapod-kit-0.1.tar.gz user@172.16.42.1:~/

Nel terminale del PinePhone (anche nella sessione SSH dal computer), installa le dipendenze. Leggi il riepilogo di APK: deve aggiungere i pacchetti alla base v25.12; se propone un cambio di distribuzione o kernel, interrompi e controlla i repository.

sudo apk add mpd py3-gobject3 py3-cairo gtk+3.0
cd "$HOME"
tar -xzf biapod-kit-0.1.tar.gz
cd biapod-kit
sha256sum -c SHA256SUMS
python3 setup.py --check

Quando il controllo risponde BASE_COMPATIBILE, prepara i file come utente normale:

python3 setup.py --install

Vengono creati ~/pinepod, la configurazione MPD e una copia dei file utente sostituiti in ~/.local/state/pimpmyphone-backup. La musica resta in ~/Music. La sessione grafica verrà attivata alla tappa 07.

Dipendenze: MPD, PyGObject. Il kit include il codice della configurazione audio con la relativa intestazione di licenza; non include Linux, musica o copertine commerciali.

Per la prova iniziale copia due album nella cartella Music del sistema. Con il sistema ancora sulla microSD di prova, la scheda musicale finale non è inserita nel telefono.

Music/
└── Nome artista/
    └── Titolo album/
        ├── cover.jpg
        ├── 01 - Primo brano.mp3
        └── 02 - Secondo brano.mp3

Sul computer entra nella cartella che contiene gli artisti. Sostituisci Nome artista con una cartella reale, mantenendo le virgolette per gli spazi:

scp -Or "Nome artista" user@172.16.42.1:~/Music/

Copertine e metadati

Metti una cover.jpg nella cartella dell’album; sono riconosciuti anche i nomi folder, front e album, nei formati JPG, PNG o WebP. Una copertina intorno a 600 × 600 pixel è sufficiente come preparazione pratica.

Completa i tag titolo, artista, album e numero di traccia: BiaPod ricava la griglia dalle cartelle e legge i titoli dei brani attraverso MPD. Numerare i file aiuta quando i tag non sono presenti.

La sessione dedicata avvia PulseAudio e MPD, poi mostra BiaPod in Sway a 720 × 1440. I servizi telefonici e i servizi audio alternativi vengono disattivati per questo uso musicale.

sudo python3 system_setup.py activate "$USER"
sudo reboot

L’attivazione salva la sessione precedente e lo stato dei servizi. SSH non viene abilitato all’avvio. Il terminale manuale di BiaPod si richiama con tre pressioni rapide di Power; questa scorciatoia del nuovo kit richiede una prova sul dispositivo.

Imposta gli switch per un lettore offline

Dopo avere installato i pacchetti, spegni il PinePhone e scollega il cavo prima di aprire il coperchio. Lo switch 6 deve restare su ON per usare le cuffie. Gli altri possono essere spenti se non ti servono.

Il lato ON è verso la scritta ON e la parte alta del telefono. Cambiare gli switch mentre è acceso può danneggiare il firmware del modem: segui le istruzioni PINE64 per gli interruttori. La tabella riguarda la configurazione offline; il kit non prepara Bluetooth audio.

Ora premi play

Apri Album → Aggiorna, attendi l’indicizzazione, scegli un album e una traccia. Parti con il volume MPD intorno al 10%. Il kit inizializza la riproduzione a volume basso e in pausa.

Per l’assetto finale installa Linux e BiaPod nella eMMC, la memoria interna. La microSD più capiente conterrà soltanto la musica. La procedura pubblica qui proposta è una nuova installazione della stessa base; i nostri script di clonazione del singolo prototipo non sono inclusi.

1. Per prima cosa salva le playlist da ~/.local/share/mpd/playlists sul computer, usando una sessione SSH temporanea. Conserva anche il kit e l’immagine verificata della tappa 02.
2. Scarica JumpDrive per PinePhone originale. Scrivilo con Etcher su un’altra microSD cancellabile, per conservare la scheda BiaPod di recupero.
3. Spegni il PinePhone, inserisci la scheda JumpDrive e avvia. Collega il cavo dati: JumpDrive espone la memoria interna come disco sul computer.
4. Identifica la eMMC dalla capacità e dal dispositivo. Non usare il numero di disco di un’altra guida: cambia a ogni collegamento. Salvala per intero come immagine e verifica la lettura prima di scrivere.
5. Espelli le partizioni esposte e scrivi con Etcher la stessa immagine Linux della tappa 02 sulla eMMC verificata. Attendi anche la convalida.
6. Spegni, rimuovi JumpDrive e avvia senza microSD. Ripeti le tappe 04, 05 e 07 sulla memoria interna: stessi pacchetti, stesso kit, stessa sessione.
7. Verifica con findmnt / che la radice sia sulla eMMC. Poi passa alla scheda dati nella tappa 09.

diskutil unmountDisk /dev/diskN
sudo dd if=/dev/rdiskN of="$HOME/Desktop/pinephone-emmc-backup.img" bs=4m
shasum -a 256 "$HOME/Desktop/pinephone-emmc-backup.img"
sudo dd if=/dev/rdiskN bs=4m | shasum -a 256

Procedura e limiti di JumpDrive: installazione eMMC PINE64 e repository JumpDrive. Con Tow-Boot già installato il percorso può cambiare: consulta le istruzioni ufficiali del bootloader prima di procedere.

Prepara sul computer una microSD dati exFAT con una cartella Music alla radice, ordinata come nella tappa 06. La formattazione va fatta soltanto dopo avere salvato i file presenti. Una scheda che conteneva un sistema può conservare un bootloader: consulta la procedura PINE64 per riutilizzarla.

1. Spegni il telefono, inserisci la scheda musicale e riavvia dalla eMMC.
2. Apri la manutenzione temporanea della tappa 04. Leggi l’identificatore della partizione sul PinePhone:

lsblk -o NAME,SIZE,FSTYPE,LABEL,MOUNTPOINTS
sudo blkid

Il kit include un comando che monta la scheda in sola lettura, controlla la cartella Music e prepara il collegamento persistente. Sostituisci UUID_DELLA_TUA_SCHEDA con il valore appena letto. Il comando rifiuta il dispositivo che contiene il sistema attualmente avviato.

cd "$HOME/biapod-kit"
sudo python3 music_setup.py "UUID_DELLA_TUA_SCHEDA" "$USER"

La scheda resta in sola lettura sul telefono; playlist e preferiti si salvano nella memoria interna. La cartella Music locale di prova viene conservata con un altro nome. Al termine riavvia, poi apri Album → Aggiorna.

Aggiungere altri album

Spegni regolarmente il PinePhone e sposta la scheda nel computer. Copia i nuovi album in Music/Artista/Album, espelli la scheda e reinseriscila a telefono spento. Riaccendi e premi Aggiorna. Non serve reinstallare BiaPod.

Ripristinare le playlist

Copia i file .m3u o .m3u8 salvati nella cartella ~/.local/share/mpd/playlists del telefono. Usa percorsi relativi alla cartella Music, ad esempio Artista/Album/01 - Brano.mp3; i percorsi assoluti del vecchio lettore vanno adattati.

Un primo brano riuscito è l’inizio del collaudo. Aggiungi la raccolta completa dopo la prova con pochi album e ripeti l’ascolto sia collegato sia a batteria.

Cosa offre questa edizione