TwitterAutoPost
Una piccola app containerizzata che pubblica ogni giorno una foto casuale, presa da una cartella sul NAS, su un account Twitter/X — tutto guidato da un file di configurazione YAML.
L’idea
Avevo una cartella di foto sul NAS e volevo che ne venisse pubblicata una a caso al giorno su un account Twitter/X, senza doverci pensare. Ne è nata una piccola app in un container Docker: la accendi una volta e va da sola.
Cosa fa
- Sceglie una foto a caso, senza ripetizioni: tiene un elenco di quelle già pubblicate e, quando le ha usate tutte, lo azzera e ricomincia un nuovo giro.
- Scandaglia le sottocartelle, con una lista di esclusioni, e filtra per estensione.
- Orario e fuso configurabili per la pubblicazione giornaliera.
- Didascalia opzionale (testo fisso e/o nome del file).
- Comodità da riga di comando:
--dry-run(sceglie e stampa senza pubblicare) e--once(pubblica subito una volta ed esce).
Come funziona
Il container esegue uno scheduler in-process: calcola la prossima occorrenza dell’orario
impostato nel fuso scelto, dorme fino a quel momento, sceglie un’immagine idonea e la
pubblica. L’upload usa l’endpoint media v1.1 di Twitter, mentre il tweet vero e
proprio passa dall’endpoint v2 (via tweepy). In caso di errore logga e aspetta il
giorno dopo, così il demone resta sempre in piedi; restart: unless-stopped lo riporta
su dopo un riavvio.
Scelte di progetto
- Tutto in YAML: estensioni, esclusioni, orario, fuso, didascalia. I segreti (le
chiavi API) stanno però nel file
.env, che ha la precedenza sulla configurazione — così non finiscono mai nel file YAML. - Poco stato, ma ce n’è: all’inizio la scelta era puramente casuale, ripetizioni
accettate. Dopo averne vista una ripetersi due volte in una settimana ho aggiunto un
piccolo file di storico (percorsi relativi, su una cartella montata dall’host) che si
aggiorna solo dopo una pubblicazione riuscita: il
--dry-runnon lo tocca. Lo storico è partito vuoto, quindi le foto pubblicate prima potevano ripresentarsi una volta. - Accesso al NAS: la share SMB è un volume CIFS montato da Docker stesso, in sola
lettura, con le credenziali dal
.env— il primo tentativo con un bind mount non funzionava (vedi sotto). - Rotazione dei log delegata al driver
json-filedi Docker (niente systemd o logrotate).
Note e trabocchetti
- L’API di X è a pagamento: pubblicare consuma crediti acquistati (un post semplice costa pochissimo, un post con link parecchio di più) — una cosa da tenere a mente prima di automatizzare.
- Per caricare un’immagine servono i token utente OAuth 1.0a (non OAuth 2.0), e tutte e quattro le chiavi devono provenire dalla stessa app, altrimenti si ottiene un errore 401.
- Con WSL2 conviene montare la share come volume CIFS: un semplice bind di un percorso UNC risulta silenziosamente vuoto, e il container vede zero file senza nessun errore. Docker oggi gira in una distribuzione Linux su WSL2 (non più con Docker Desktop), e un piccolo script permette di pubblicare subito una foto a mano.
Stack
Python · tweepy · Docker · API Twitter/X