XTweet

Converts noisy toots to tiny tweets

Configurazione e deployment

Crea un file config.js con questa struttura

module.exports = {
  twitter_consumer_key: '...',
  twitter_consumer_secret: '...',

  mastodon_token: '...',
  mastodon_user: 'ekardnam',
  instance: 'mastodon.bida.im',

  key: 'key.pem',
  cert: 'cert.pem',
  passphrase: 'pass',
  bind_ip: '0.0.0.0',
  port: 8000,
  callback_url: 'https://localhost:8000',
  callback_path: '/oauth/callback'
}

In twitter_consumer_key e in twitter_consumer_secret ci vanno i token relativi all'app Twitter.

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)

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.

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.

Fatto questo si può buildare l'immagine Docker con docker build . -t xtweet e successivamente eseguirla con docker run -d xtweet