Mastodon 연결하기
평소 쓰시는 Mastodon 서버에서 애플리케이션을 하나 만들고, 토큰 하나를 복사해 붙여 넣으면 끝 — 2분 남짓이면 되고, 신청할 것도 없습니다.
Mastodon은 가장 쉽게 연결되는 플랫폼입니다. 등록할 개발자 앱도, 통과해야 할 심사도 없습니다. 모든 일이 이미 글을 올리고 계신 그 Mastodon 서버 안에서, 대부분의 사람이 한 번도 열어 보지 않는 설정 페이지에서 일어납니다. Mastodon 호환 서버라면 어디서든 같은 단계가 통합니다 — Mastodon은 물론 Pleroma와 GoToSocial도 마찬가지입니다.
붙여 넣으신 값은 암호화되어 내 Mac에만 남습니다. 그리고 애플리케이션이 내 서버의 내 것이므로 게시 한도도 온전히 내 것입니다 — 다른 Social Quack 사용자와 할당량을 나눠 쓰는 일은 결코 없습니다.
1. 내 서버에서 Development 페이지 열기
브라우저에서 내 Mastodon 서버에 로그인하세요. 서버는 핸들의 두 번째 @ 뒤에 오는 부분입니다 — @[email protected]이시라면 서버는 mastodon.social입니다.
그런 다음 Preferences → Development → New application(환경 설정 → 개발 → 새 애플리케이션)으로 가세요.
2. 애플리케이션 만들기
이름은 마음에 드는 것으로 정하세요 — 내 설정 화면에서만 보이는 이름표일 뿐입니다. "Social Quack"도 좋은 선택입니다.
다음 세 가지 스코프를 체크하세요(스코프란 그저 내가 부여하는 권한을 말합니다).
| 스코프 | Social Quack이 무엇을 할 수 있게 되나 |
|---|---|
read |
토큰을 확인하고 그것이 어느 계정의 것인지 읽어, 채널에 올바른 이름과 핸들과 프로필 사진이 나오게 합니다. |
write:statuses |
게시물과, 스레드를 이루는 답글을 올립니다. |
write:media |
게시물에 첨부한 이미지를 업로드합니다. |
애플리케이션을 저장하세요.
3. 액세스 토큰 복사하기
방금 만든 애플리케이션을 열고 Your access token이라고 표시된 값을 복사하세요.
비밀번호처럼 다루세요 — 그것을 가진 사람은 누구나 내 이름으로 글을 올릴 수 있습니다. 필요한 것은 이것 하나뿐입니다. Mastodon 쪽에 되돌려 붙여 넣을 것도, 등록할 주소도, 기다려야 할 승인도 없습니다.
4. Social Quack에 붙여 넣기
Social Quack에서 Channels(채널)를 열고 Add a channel(채널 추가) 아래에서 Mastodon을 찾아 Connect(연결)를 클릭하세요. 입력란이 두 개 나타납니다.
| 입력란 | 무엇을 넣나 |
|---|---|
| Instance URL | https://를 포함한 내 서버의 전체 웹 주소 — 예를 들어 https://mastodon.social. 끝에 슬래시가 붙어 있어도 괜찮습니다. Social Quack이 알아서 정리합니다. |
| Access token | 방금 복사한 토큰. 비밀번호처럼 입력하는 동안 가려집니다. |
Connect를 클릭하세요. Social Quack이 곧바로 내 서버에 토큰을 확인하고, 계정이 표시 이름과 프로필 사진, 그리고 @you@내-서버 형태의 전체 핸들과 함께 채널 목록에 나타납니다. 설정은 이것으로 전부입니다.
5. 게시할 때 무엇을 기대할 수 있나
| 길이 | 게시물당 500자. |
| 스레드 | 지원됩니다. 각 부분이 바로 앞 글의 답글로 올라가므로 진짜 스레드처럼 읽힙니다. |
| 이미지 | 최대 4장, 스레드의 첫 게시물에 붙습니다 — 뒤따르는 부분은 글만 나갑니다. Social Quack에 입력한 대체 텍스트도 이미지와 함께 전달됩니다. |
| 동영상과 큰 GIF | 첨부되기 전에 내 서버가 이 파일들을 처리해야 하므로 Social Quack이 기다립니다 — 최대 2분 정도. 그 시간이 다 지나도 서버가 아직 파일을 붙들고 있으면, 파일 없이 나가는 대신 게시물 전체가 실패해 Queue(예약 목록)의 Failed(실패)에 남습니다 — 다시 예약하시거나, 더 짧거나 작은 버전을 첨부하세요. |
| 공개 범위 | 게시물은 전체 공개로 나갑니다. |
Social Quack은 게시물을 보내기 전에 publishing 상태로 표시하므로, 스케줄러가 같은 게시물을 두 번 내보내는 일은 생기지 않습니다.
문제가 생겼을 때
| 이런 증상 | 무슨 뜻인가 | 어떻게 하나 |
|---|---|---|
| Connect를 클릭했는데 토큰이 거부됩니다 | 대개 read 스코프를 체크하지 않았거나, 토큰이 일부만 복사됐습니다 |
Preferences → Development에서 새 애플리케이션을 만들고, 세 스코프를 모두 체크한 뒤 Your access token을 한 번에 통째로 다시 복사하세요 |
연결이 실패하는데 mastodon.social만 입력하셨습니다 |
Instance URL에는 전체 주소가 필요합니다 | https://mastodon.social처럼 — 앞에 https://를 붙여 입력하세요 |
| 계정 연결은 잘됐는데 게시가 실패합니다 | 애플리케이션에 write:statuses가 빠져 있습니다 |
세 스코프를 모두 체크해 새 애플리케이션을 만들고 새 토큰을 붙여 넣으세요 |
Mastodon media upload failed: … |
이미지를 업로드하지 못했습니다 — write:media를 체크하지 않았거나 서버가 파일을 거부한 경우가 대부분입니다 |
먼저 스코프를 확인하시고, 이상이 없다면 더 작거나 다시 내보낸 이미지로 시도해 보세요 |
Mastodon media status check failed: … |
내 서버가 파일 처리를 중간에 멈췄습니다 | 다시 시도하시거나, 동영상이나 GIF의 더 작은 버전을 첨부하세요 |
동영상이나 큰 GIF가 든 게시물이 422로 실패합니다 |
2분의 대기 시간이 끝날 때까지 서버가 파일을 처리하고 있었습니다 | 게시물을 다시 예약하시거나, 더 짧거나 작은 버전을 첨부하세요 |
Mastodon did not return a status id |
서버가 게시물을 받아들였지만 아무것도 돌려주지 않았습니다 | 게시물을 다시 시도해 보세요. 계속 그런다면 서버에 문제가 있을 가능성이 큽니다 — 서버 상태 페이지를 확인하세요 |
| 어느 날 갑자기 게시가 되지 않습니다 | 서버에서 애플리케이션이 회수되었거나 삭제됐습니다 | 새로 하나 만들고 새 토큰을 복사한 뒤 같은 서버 주소로 다시 연결하세요 — 같은 서버의 같은 계정이므로 두 번 추가되지 않고 기존 채널이 갱신됩니다 |
| 이미지를 4장보다 많이 첨부하셨습니다 | 앞의 4장만 전송됩니다 | 나머지는 빼세요. 이미지는 언제나 스레드의 첫 부분에 붙고 뒷부분에는 붙지 않으므로, 사진을 더 올리시려면 두 번째 게시물을 예약하세요 |
그래도 막히셨나요? [email protected]으로 알려 주세요.