Connecter Mastodon
Créez une application sur votre propre serveur Mastodon, copiez un jeton, collez-le — environ deux minutes, sans rien à demander à personne.
Mastodon est la plateforme la plus simple à connecter. Aucune application développeur à déclarer, aucune validation à passer : tout se passe dans le serveur Mastodon depuis lequel vous publiez déjà, sur une page de réglages que la plupart des gens n'ouvrent jamais. Les mêmes étapes valent pour tout serveur compatible Mastodon — Mastodon lui-même, mais aussi Pleroma et GoToSocial.
Ce que vous collez est chiffré et ne quitte pas votre Mac. Et comme l'application vous appartient, sur votre propre serveur, ses limites de publication n'appartiennent qu'à vous — vous ne partagez jamais de quota avec les autres clients de Social Quack.
1. Ouvrir la page Development de votre serveur
Connectez-vous à votre serveur Mastodon dans un navigateur. Votre serveur, c'est ce qui suit le second @ de votre identifiant — si vous êtes @[email protected], votre serveur est mastodon.social.
Rendez-vous ensuite dans Preferences → Development → New application.
2. Créer l'application
Donnez-lui le nom que vous voulez — ce n'est qu'une étiquette que vous serez seul à voir dans vos propres réglages. « Social Quack » fera très bien l'affaire.
Cochez ces trois scopes (un scope n'est rien d'autre qu'une autorisation que vous accordez) :
| Scope | Ce qu'il permet à Social Quack |
|---|---|
read |
Vérifier le jeton et lire à quel compte il appartient, pour que le bon nom, le bon identifiant et le bon avatar s'affichent sur le canal. |
write:statuses |
Publier vos publications, ainsi que les réponses qui composent un fil. |
write:media |
Envoyer les images que vous joignez à une publication. |
Enregistrez l'application.
3. Copier le jeton d'accès
Ouvrez l'application que vous venez de créer et copiez la valeur intitulée Your access token.
Traitez-le comme un mot de passe : quiconque le détient peut publier en votre nom. C'est la seule chose dont vous ayez besoin ; rien à recoller dans Mastodon, aucune adresse à déclarer, aucune approbation à attendre.
4. Le coller dans Social Quack
Dans Social Quack, ouvrez Channels (canaux), repérez Mastodon sous Add a channel (ajouter un canal) et cliquez sur Connect (connecter). Deux champs apparaissent :
| Champ | Ce qu'il faut y mettre |
|---|---|
| Instance URL | L'adresse web complète de votre serveur, https:// compris — par exemple https://mastodon.social. Une barre oblique finale ne pose aucun problème, Social Quack fait le ménage. |
| Access token | Le jeton que vous venez de copier. Il est masqué à la saisie, comme un mot de passe. |
Cliquez sur Connect. Social Quack vérifie le jeton auprès de votre serveur dans la foulée, et le compte apparaît dans votre liste de canaux avec son nom affiché, son avatar et son identifiant complet @you@your-server. L'installation s'arrête là.
5. À quoi vous attendre quand vous publiez
| Longueur | 500 caractères par publication. |
| Fils | Pris en charge. Chaque partie est publiée en réponse à la précédente : cela se lit comme un vrai fil. |
| Images | Jusqu'à 4, attachées à la première publication d'un fil — les parties suivantes partent en texte. Le texte alternatif que vous saisissez dans Social Quack accompagne l'image. |
| Vidéos et GIF volumineux | Votre serveur doit les traiter avant qu'ils puissent être joints : Social Quack patiente donc — jusqu'à deux minutes environ. Si votre serveur travaille encore sur le fichier une fois ce délai écoulé, la publication échoue entièrement et atterrit dans Failed (échecs), dans la Queue (file d'attente), plutôt que de partir sans lui — reprogrammez-la, ou joignez une version plus courte ou plus légère. |
| Visibilité | Les publications partent en public. |
Social Quack marque une publication comme publishing (en cours de publication) avant de l'envoyer : le planificateur ne peut donc jamais la publier deux fois.
Si quelque chose cloche
| Ce que vous voyez | Ce que ça veut dire | Quoi faire |
|---|---|---|
| Le jeton est refusé quand vous cliquez sur Connect | Le plus souvent, le scope read n'a pas été coché, ou le jeton n'a été copié qu'en partie |
Créez une nouvelle application dans Preferences → Development, cochez les trois scopes, et recopiez Your access token d'un seul tenant |
La connexion échoue et vous aviez saisi seulement mastodon.social |
Instance URL réclame l'adresse complète | Saisissez-la sous la forme https://mastodon.social — avec https:// devant |
| Les publications échouent, alors que le compte s'est connecté sans problème | Il manque write:statuses à l'application |
Créez une nouvelle application avec les trois scopes cochés et collez le nouveau jeton |
Mastodon media upload failed: … |
L'image n'a pas pu être envoyée — le plus souvent write:media n'était pas coché, ou votre serveur a refusé le fichier |
Vérifiez d'abord les scopes ; s'ils sont bons, essayez une image plus légère ou réexportée |
Mastodon media status check failed: … |
Votre serveur a interrompu le traitement du fichier en cours de route | Réessayez, ou joignez une version plus légère de la vidéo ou du GIF |
Une publication avec une vidéo ou un GIF volumineux échoue avec un 422 |
Votre serveur traitait encore le fichier à l'expiration des deux minutes d'attente | Reprogrammez la publication, ou joignez une version plus courte ou plus légère |
Mastodon did not return a status id |
Votre serveur a accepté la publication mais n'a rien renvoyé | Relancez la publication ; si cela se reproduit, votre serveur a sans doute des ennuis — consultez sa page d'état |
| Les publications cessent de fonctionner du jour au lendemain | L'application a été révoquée ou supprimée sur votre serveur | Créez-en une nouvelle, copiez le nouveau jeton, et reconnectez-vous avec la même adresse de serveur — le même compte sur le même serveur est mis à jour, pas ajouté en double |
| Vous avez joint plus de 4 images | Seules les 4 premières sont envoyées | Retirez les autres. Les images vont toujours sur la première partie d'un fil, jamais sur une suivante : pour publier plus de photos, programmez une seconde publication |
Toujours bloqué ? Écrivez à [email protected].