|
|
@@ -1,7 +1,7 @@
|
|
|
# XTweet
|
|
|
Converts noisy toots to tiny tweets
|
|
|
|
|
|
-## Configurazione
|
|
|
+## Configurazione e deployment
|
|
|
Crea un file `config.js` con questa struttura
|
|
|
```
|
|
|
module.exports = {
|
|
|
@@ -23,15 +23,23 @@ module.exports = {
|
|
|
```
|
|
|
|
|
|
In `twitter_consumer_key` e in `twitter_consumer_secret` ci vanno i token relativi all'app Twitter.
|
|
|
-Per Mastodon basta andare nel menù Sviluppo > Nuova applicazione e dare il permesso `read:statuses`.
|
|
|
+
|
|
|
+### Collegare Mastodon
|
|
|
+Per Mastodon basta andare nel menù Impostazioni > Sviluppo > Nuova applicazione e dare il permesso `read:statuses`.
|
|
|
+
|
|
|
+### Collegare Twitter
|
|
|
+Twitter è po' più complicato. Bisgona eseguire l'app in locale alla prima esecuzione siccome non trovarà un file `storage.json` con i token di Twitter l'app avvierà un webserver per l'autorizzazione di Twitter.
|
|
|
|
|
|
I certificati che sono nella repo sono di test e sono configurati già nel config d'esempio. Siccome vengono negoziati i token di Twitter è bene cambiarli. Si generano con
|
|
|
```
|
|
|
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365
|
|
|
```
|
|
|
+`bind_ip` e `port` sono dove si binda il server HTTPS per l'autorizzazione, mentre `callback_url` e `callback_path` concatenati danno il callback dell'OAuth (che deve essere settato nell'app Twitter)
|
|
|
|
|
|
-`bind_ip` e `port` sono dove si binda il server HTTPS per l'OAuth mentre `callback_url` e `callback_path` concatenati danno il callback dell'OAuth (che deve essere settato nell'app Twitter)
|
|
|
+Avviato il webserver lo si visita (a https://localhost:8000 con la configurazione di default) e verrà chiesto di autenticarsi su Twitter e di autorizzare l'app.
|
|
|
|
|
|
-Al primo avvio si avvia un webserver. Visitandolo ci si logga su twitter mentre la connessione con mastodon è fatta solo mettendo il token nel config
|
|
|
+### Deployment del bot
|
|
|
+Dopo aver seguito i passi precedenti si può finalmente eseguire il bot. Se lo si vuole ospitare su un server a questo punto sono necessarie alcune accortezze.
|
|
|
+Dopo aver clonato la repo sul server è necessario copiare nella directory sul server i file `config.js` e `storage.json` che contengono i token relativi a Mastodon e Twitter.
|
|
|
|
|
|
-Per eseguirlo `npm install` per installare le deps e poi `node app.js`
|
|
|
+Fatto questo si può buildare l'immagine Docker con `docker build . -t xtweet` e successivamente eseguirla con `docker run -d xtweet`
|
