Wszystkie poradniki

Podłącz Mastodona

Tworzysz aplikację na własnym serwerze Mastodona, kopiujesz jeden token, wklejasz go — jakieś dwie minuty i nic, o co trzeba by wnioskować.

Mastodon podłącza się najłatwiej ze wszystkich platform. Nie ma tu aplikacji deweloperskiej do zarejestrowania ani weryfikacji do przejścia: wszystko dzieje się na serwerze Mastodona, z którego i tak publikujesz, na stronie ustawień, do której większość ludzi nigdy nie zagląda. Te same kroki działają na każdym serwerze zgodnym z Mastodonem — na samym Mastodonie, ale też na Pleromie i GoToSocial.

To, co wklejasz, jest szyfrowane i zostaje na twoim Macu. A ponieważ aplikacja należy do ciebie i stoi na twoim serwerze, jej limity publikowania też są tylko twoje — nigdy nie dzielisz puli z innymi klientami Social Quack.

1. Otwórz na swoim serwerze stronę Development

Zaloguj się do swojego serwera Mastodona w przeglądarce. Twój serwer to część po drugim @ w twoim handlu — jeśli jesteś @[email protected], twoim serwerem jest mastodon.social.

Potem wejdź w Preferences → Development → New application (Ustawienia → Development → Nowa aplikacja).

2. Utwórz aplikację

Nadaj jej dowolną nazwę — to tylko etykieta, którą zobaczysz we własnych ustawieniach. „Social Quack” nada się doskonale.

Zaznacz te trzy zakresy uprawnień (zakres to po prostu pozwolenie, którego udzielasz):

Zakres Na co pozwala Social Quackowi
read Sprawdzić token i odczytać, do jakiego konta należy, żeby na kanale pokazały się właściwa nazwa, handle i awatar.
write:statuses Publikować twoje posty oraz odpowiedzi, z których składa się wątek.
write:media Wysyłać obrazy, które dołączasz do posta.

Zapisz aplikację.

3. Skopiuj token dostępu

Otwórz aplikację, którą przed chwilą utworzyłeś, i skopiuj wartość podpisaną Your access token.

Traktuj go jak hasło — kto go ma, ten może publikować jako ty. To jedyne, czego potrzebujesz; nie ma nic do wklejenia z powrotem w Mastodonie, żadnego adresu do zarejestrowania ani zgody, na którą trzeba by czekać.

4. Wklej go do Social Quack

W Social Quacku otwórz Channels („Kanały”), znajdź Mastodona w sekcji Add a channel („Dodaj kanał”) i kliknij Connect („Połącz”). Pojawią się dwa pola:

Pole Co w nie wpisać
Instance URL (adres serwera) Pełny adres twojego serwera razem z https:// — na przykład https://mastodon.social. Ukośnik na końcu nie przeszkadza, Social Quack sobie z nim poradzi.
Access token (token dostępu) Token, który przed chwilą skopiowałeś. W trakcie wpisywania jest maskowany, jak hasło.

Kliknij Connect. Social Quack od razu sprawdza token na twoim serwerze, a konto pojawia się na liście kanałów z nazwą wyświetlaną, awatarem i pełnym handlem @ty@twoj-serwer. To cała konfiguracja.

5. Czego się spodziewać przy publikowaniu

Długość 500 znaków na post.
Wątki Obsługiwane. Każda część wychodzi jako odpowiedź na poprzednią, więc czyta się to jak prawdziwy wątek.
Obrazy Do 4, dołączane do pierwszego posta wątku — dalsze części wychodzą jako sam tekst. Tekst alternatywny wpisany w Social Quacku idzie razem z obrazem.
Filmy i duże GIF-y Twój serwer przetwarza je, zanim da się je dołączyć, więc Social Quack czeka — do mniej więcej dwóch minut. Jeśli serwer wciąż nad plikiem pracuje, gdy ten czas minie, cały post nie udaje się i ląduje w Failed („Nieudane”) w Queue („Kolejce”), zamiast wyjść bez pliku — zaplanuj go ponownie albo dołącz krótszą lub mniejszą wersję.
Widoczność Posty wychodzą jako publiczne.

Social Quack oznacza post jako publishing, zanim go wyśle, więc harmonogram nigdy nie wypuści tego samego posta dwa razy.

Jeśli coś pójdzie nie tak

Co widzisz Co to znaczy Co zrobić
Token zostaje odrzucony po kliknięciu Connect Zwykle nie został zaznaczony zakres read albo token skopiował się tylko częściowo Utwórz nową aplikację w Preferences → Development, zaznacz wszystkie trzy zakresy i skopiuj Your access token jeszcze raz, w całości
Łączenie się nie udaje, a wpisałeś samo mastodon.social Pole Instance URL chce pełnego adresu Wpisz go jako https://mastodon.social — z https:// na początku
Posty się nie udają, choć konto podłączyło się bez problemu Aplikacji brakuje write:statuses Utwórz nową aplikację z zaznaczonymi wszystkimi trzema zakresami i wklej nowy token
Mastodon media upload failed: … Obrazu nie dało się wysłać — najczęściej nie został zaznaczony write:media albo twój serwer odrzucił plik Sprawdź najpierw zakresy; jeśli są w porządku, spróbuj z mniejszym albo ponownie wyeksportowanym obrazem
Mastodon media status check failed: … Twój serwer przerwał przetwarzanie pliku w połowie Spróbuj jeszcze raz albo dołącz mniejszą wersję filmu lub GIF-a
Post z filmem albo dużym GIF-em kończy się błędem 422 Twój serwer wciąż przetwarzał plik, kiedy minęły te dwie minuty Zaplanuj post ponownie albo dołącz krótszą lub mniejszą wersję
Mastodon did not return a status id Twój serwer przyjął post, ale nic nie odesłał Spróbuj opublikować ponownie; jeśli powtarza się to stale, twój serwer prawdopodobnie ma kłopoty — sprawdź jego stronę ze statusem
Pewnego dnia publikowanie przestaje działać Aplikacja została odebrana albo usunięta na twoim serwerze Utwórz nową, skopiuj nowy token i połącz się ponownie, podając ten sam adres serwera — to samo konto na tym samym serwerze zostanie zaktualizowane, a nie dodane drugi raz
Dołączyłeś więcej niż 4 obrazy Wysyłane są tylko pierwsze 4 Usuń nadmiarowe. Obrazy zawsze idą na pierwszą część wątku, nigdy na dalszą, więc żeby opublikować więcej zdjęć, zaplanuj drugi post

Nadal nie wychodzi? Napisz na [email protected].

Utknąłeś na którymś kroku? Napisz na [email protected] — odpowie ci człowiek.