Publier sa veille Flus sur Mastodon

Aujourd’hui, je vous explique comment publier automatiquement un flux RSS (ou Atom) sur Mastodon. Cet article pointe quelques particularités liées à Flus¹, mais la majorité des informations peuvent s’appliquer à n’importe quel flux.

Pour publier un flux sur Mastodon, vous avez besoin de 3 ingrédients :

1. un flux RSS (ici je vais prendre comme exemple le flux de mon profil Flus : https://app.flus.fr/p/1670839367044869607/feed) ;
2. un compte Mastodon (forcément) ;
3. et un outil qui va lire votre flux pour publier sur votre compte Mastodon : feediverse².

feediverse étant un outil en ligne de commande, vous devrez vous sentir suffisamment à l’aise avec cette dernière. Eh oui, cet article est un peu technique.

Installer feediverse

Pour installer feediverse, vous aurez besoin de Python et de la commande pip. Vérifiez que pip est bien installé avec la commande :

$ python -m pip --version

Si tout va bien, il vous affichera son numéro de version. En principe pip est disponible par défaut dans les dernières versions de Python. Si ce n’est pas le cas, vous pouvez suivre la documentation pour l’installer.

Une fois cela fait, installez feediverse :

$ python -m pip install feediverse

Puis configurez-le :

$ feediverse

Il va vous demander un certain nombre d’informations ; notamment votre instance / serveur Mastodon, de quoi générer un jeton d’authentification et… l’adresse de votre flux RSS.

Configurer le format des messages

Une fois cela fait, c’est presque terminé ! Vous aurez toutefois peut-être envie de configurer le format des messages postés sur Mastodon. Ouvrez le fichier de configuration ~/.feediverse dans un éditeur de texte et adaptez la propriété template à votre convenance. Par exemple :

feeds:
- template: "{title} {link} #veille"
  url: https://app.flus.fr/p/1670839367044869607/feed

Les liens (i.e. {link}) pointeront vers la page de vos commentaires Flus. Si vous préférez toutefois que les liens pointent directement vers les sites, vous pouvez modifier l’URL de votre flux en ajoutant le paramètre ?direct=true (exemple : https://app.flus.fr/p/1670839367044869607/feed?direct=true).

Exécuter feediverse

Il ne vous reste plus qu’à lancer feediverse pour qu’il poste sur Mastodon :

$ feediverse

Pour l’exécuter automatiquement à intervalle régulier, créez une tâche Cron (crontab -e) :

*/15 * * * * /home/USER/.local/bin/feediverse

Vous devrez probablement mettre le chemin absolu vers la commande (comme dans l’exemple ci-dessus). Vous le trouverez avec cette commande :

$ whereis feediverse
feediverse: /home/USER/.local/bin/feediverse

Bonus : Publier les liens Flus ET directs

Si vous voulez publier à la fois les liens vers vos commentaires Flus et vers les articles pointés, il existe une méthode. Mais attention, il va falloir se relever les manches du clavier et traficoter directement dans le code de feediverse³.

Commencez par trouver où il a été installé :

$ python -m pip show feediverse | grep Location
Location: /home/USER/.local/lib/python3.10/site-packages

Ouvrez ensuite le fichier /home/USER/.local/lib/python3.10/site-packages/feediverse.py dans un éditeur de texte.

Trouvez la ligne def get_entry(entry): (ligne 85 chez moi), puis, quelques lignes plus bas, le return { … }. Entre les accolades, ajoutez cette ligne :

return {
    # ...
    "links": entry.links,
}

Éditez maintenant le format de votre message (dans ~/.feediverse) :

feeds:
- template: "{title}\nLien : {links[1].href}\nCommentaires : {links[0].href}\n#veille"
  url: https://app.flus.fr/p/1670839367044869607/feed.atom.xml

Veillez à bien supprimer le paramètre ?direct=true de l’adresse du flux.

Normalement, les prochains messages postés par feediverse sur votre compte Mastodon devraient contenir un lien vers Flus et un lien vers les articles pointés.