Misskino

Un client desktop moderno, leggero e reattivo per Misskey (e software compatibili con la Misskey API come Sharkey e Firefish), sviluppato in Python, GTK 4 e Libadwaita.

Progettato per integrarsi perfettamente con i desktop Linux moderni (GNOME, Zorin OS, KDE Plasma, XFCE, Cinnamon).

---

Caratteristiche Principali

• Design Adwaita Moderno: Interfaccia pulita conforme alle linee guida GNOME / Libadwaita con supporto a tema chiaro/scuro di sistema.
• Autenticazione Sicura: Login tramite flusso nativo MiAuth nel browser web (nessuna credenziale memorizzata in chiaro).
• Modalità Ospite: Possibilità di esplorare la timeline Locale ed Esplora di qualsiasi istanza anche senza account.
• Timeline Multiple:
  • Home, Locale, Ibrida (Sociale), Globale, Esplora.
  • Sezione Notifiche con filtro lette/non lette e badge.
  • Sezione Preferiti.
  • Ricerca note e ricerca mirata per #hashtag.
• Feed Interattivo:
  • Scroll infinito automatico.
  • Visualizzazione allegati multimediali con mascheramento dei contenuti sensibili (CW / NSFW).
  • Gestione completa dei sondaggi con voto e percentuali in tempo reale.
  • Supporto per reazioni emoji Unicode ed emoji personalizzate dell'istanza.
  • Rinota (Renote), Citazione, Risposta e salvataggio tra i Preferiti.
  • Anteprima dei Link (OpenGraph): Generazione automatica di schede con titolo, descrizione e miniatura per i link web e video di YouTube.
• Thread e Profili:
  • Esplorazione completa delle conversazioni (note genitore e risposte collegate).
  • Visualizzazione dettagliata del profilo utente con avatar squadrati, campi personalizzati e pulsante Segui / Non seguire più.
• Composer Completo:
  • Scrittura note con supporto a visibilità (Pubblica, Home, Solo Follower, Solo Locale).
  • Avviso contenuto (CW) personalizzabile.
  • Creazione sondaggi a scelta singola o multipla.
  • Upload allegati multipli sul Drive di Misskey.
  • Autocompletamento intelligente: suggerimenti istantanei digitando @utente o #hashtag con navigazione tramite tastiera (Frecce, Tab, Invio).
• Integrazione Desktop & Minimizzazione:
  • Minimizzazione nella System Tray tramite il protocollo moderno DBus StatusNotifierItem (funziona nativamente su Zorin OS, KDE, Ubuntu e GNOME con estensione).
  • Menu contestuale della tray per Mostrare/Nascondere l'app, comporre una nota rapida o uscire.
  • Notifiche desktop per menzioni, risposte, reazioni e follow.

---

Requisiti e Dipendenze

Il software richiede Python >= 3.10, GTK 4 e Libadwaita >= 1.4.

Installazione dipendenze su Ubuntu / Zorin OS / Debian:

sudo apt update
sudo apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1 python3-requests

Installazione dipendenze su Fedora:

sudo dnf install python3-gobject gtk4 libadwaita python3-requests

Installazione dipendenze su Arch Linux:

sudo pacman -S python-gobject gtk4 libadwaita python-requests

(Nota per GNOME puro senza estensioni: assicurarsi di avere attiva l'estensione AppIndicator and KStatusNotifierItem Support per visualizzare la tray icon).

---

Installazione e Avvio

1. Salva lo script in una cartella a tua scelta (ad esempio misskey_gtk.py).
2. Rendi il file eseguibile:

   chmod +x main.py
   

3. Avvialo da terminale:

   ./main.py
   

All'avvio, l'applicazione genererà automaticamente un file desktop in ~/.local/share/applications/io.misskey.GtkClient.desktop per permetterti di cercarla e avviarla direttamente dal menu delle applicazioni di sistema.

---

Configurazione e Percorsi File

I dati di configurazione e le sessioni vengono memorizzati nella home dell'utente in:

• ~/.config/misskey-gtk/auth.json: Token di accesso crittografato e istanza collegata.
• ~/.config/misskey-gtk/settings.json: Impostazioni dell'applicazione (intervallo polling notifiche, esecuzione in background, ecc.).

Per ripristinare o scollegare un account, è possibile usare il pulsante Esci dall'account nel menu del proprio avatar in basso a sinistra, oppure eliminare la cartella ~/.config/misskey-gtk.

---

Riconoscimenti e Licenze

Questo progetto include icone fornite da Font Awesome:

• Icone: Font Awesome Free
• Licenza: Creative Commons Attribution 4.0 International (CC BY 4.0)
• Copyright: © Fonticons, Inc.

---

Licenza

Distribuito sotto licenza MIT. Libero per l'uso, la modifica e la ridistribuzione.