PurpleTube

Un player desktop libero per PeerTube — sfoglia istanze, guarda video, gestisci abbonamenti e playlist, tutto senza browser.

---

Installazione rapida (AppImage)

Funziona su qualsiasi distribuzione Linux x86-64 — Ubuntu, Fedora, Arch, Mint, ecc.

1. Scarica l'AppImage dalla pagina Releases

2. Rendila eseguibile e avviala:

chmod +x PurpleTube-*-x86_64.AppImage
./PurpleTube-*-x86_64.AppImage

Dipendenza di sistema richiesta: libmpv

Distribuzione	Comando
Ubuntu / Debian / Mint	sudo apt install libmpv1
Fedora	sudo dnf install mpv-libs
Arch / Manjaro	sudo pacman -S mpv
openSUSE	sudo zypper install libmpv1

---

Funzionalità

• 🔍 Ricerca video su SepiaSearch e istanze PeerTube
• ▶️ Riproduzione video con controlli completi (velocità, seek, volume)
• 📋 Abbonamenti e feed RSS delle istanze
• 📚 Cronologia e preferiti
• 🎨 Interfaccia scura, nessun tracciamento

---

Build dal sorgente

Requisiti

• Python 3.10+
• libmpv installata nel sistema

Installazione dipendenze Python

pip install -r requirements.txt

Avvio diretto (sviluppo)

python3 main.py

Build AppImage

# Richiede PyInstaller (pip install pyinstaller) e linuxdeploy
./build.sh

L'AppImage viene generata nella cartella del progetto.

---

Struttura del progetto

purpletube/
├── config.py       — percorsi, costanti, database
├── api.py          — chiamate HTTP alle API PeerTube
├── models.py       — strutture dati
├── theme.py        — tema visivo
├── window.py       — finestra principale
├── workers.py      — thread per operazioni async
├── components/     — widget riutilizzabili
└── panels/         — schermate (Home, Ricerca, Player, …)
main.py             — entry point

---

Licenza

GPL-3.0 — vedi LICENSE

---

Segnalare un bug

Apri una issue con:

• Distribuzione e versione
• Output di ./PurpleTube-*.AppImage dal terminale
• Cosa hai fatto e cosa ti aspettavi