Mastodon Federation With PeerTube: Video Reply Workflow

You have a Mastodon account and you want to reply to a PeerTube video directly from your timeline. When you type a public reply to a boosted PeerTube video, your followers on Mastodon see the reply, but the original video creator on PeerTube may not get a notification. This happens because Mastodon and PeerTube use the same ActivityPub protocol but handle replies and notifications differently. This article explains how the federation link works between the two platforms and gives you a reliable step-by-step workflow to make sure your video replies reach the PeerTube creator.

How Mastodon and PeerTube Federation Works for Video Replies

Mastodon and PeerTube both implement the ActivityPub protocol, which allows them to exchange activities like notes, likes, and shares. When a PeerTube video is shared on Mastodon, the Mastodon server receives an activity from the PeerTube instance. The video appears in your timeline as a status with a link to the PeerTube video. If you reply to that status from your Mastodon account, your reply is sent to your followers on Mastodon and also to the PeerTube instance that originally sent the video activity.

The critical detail is that PeerTube treats replies differently than Mastodon. PeerTube expects the reply to be addressed to the channel’s ActivityPub inbox. If your Mastodon reply only addresses the boost account or the Mastodon user who boosted the video, the PeerTube instance may not deliver the reply to the video creator’s inbox. The creator then never sees your comment. To guarantee delivery, your reply must include the PeerTube channel’s ActivityPub handle.

Each PeerTube channel has a unique ActivityPub handle in the format @channel@instance.tube. For example, a channel named “TechReviews” on the PeerTube instance video.example.com has the handle @TechReviews@video.example.com. When you include this handle in your reply, Mastodon’s ActivityPub implementation addresses the message to that channel’s inbox. PeerTube then processes the reply and shows it under the video’s comments section.

Step-by-Step Workflow to Reply to a PeerTube Video From Mastodon

Method 1: Reply Using the Boosted Post With the Correct Mention

This method works when the PeerTube video appears in your Mastodon timeline as a boosted post from another user or from the video channel itself.

1. Locate the boosted PeerTube video in your timeline
   Find the status that contains the PeerTube video link. It usually shows a preview card with the video title and a thumbnail. The post may come from a Mastodon user who boosted it or directly from the PeerTube channel account.
2. Copy the PeerTube channel handle
   Open the video link in your browser. On the PeerTube video page, look for the channel name under the video title. Click the channel name to go to the channel page. The URL contains the channel handle, such as video.example.com/accounts/TechReviews. The handle in ActivityPub format is @TechReviews@video.example.com. Write this handle down or copy it to your clipboard.
3. Click the reply button on the boosted post
   In Mastodon, click the reply icon (the arrow pointing left) on the boosted status. This opens a new post field with the original poster’s handle already included.
4. Add the PeerTube channel handle to the reply
   In the reply field, add a space after the existing handle, then type the PeerTube channel handle you copied. Example: @originalUser @TechReviews@video.example.com Your reply text here.
5. Post the reply
   Click the publish button. Mastodon sends the reply to both the original poster and the PeerTube channel. The PeerTube instance processes the reply and adds it as a comment on the video page.

Method 2: Create a New Post With the Video Link and Channel Mention

Use this method when the boosted post does not allow replies or when you want to start a fresh thread.

1. Copy the PeerTube video URL
   Open the PeerTube video in your browser. Copy the full URL from the address bar, for example https://video.example.com/w/abc123.
2. Open Mastodon’s compose box
   Click the compose button in your Mastodon client.
3. Paste the video URL and add the channel handle
   Paste the PeerTube video URL into the compose field. Then type the PeerTube channel handle in the format @channel@instance.tube. Example: https://video.example.com/w/abc123 @TechReviews@video.example.com Great review, thanks for sharing!
4. Set the post visibility to Public
   Make sure the visibility setting is Public. PeerTube cannot process unlisted or followers-only replies as comments on the video.
5. Publish the post
   Click publish. Mastodon sends the activity to the PeerTube instance. The video creator receives a notification and the reply appears under the video’s comment section.

Common Federation Issues and How to Avoid Them

Reply Does Not Appear as a Comment on PeerTube

The most frequent cause is that the Mastodon reply did not include the PeerTube channel handle. Without the handle, Mastodon addresses the reply only to the boost account or to the instance that sent the video activity. PeerTube does not receive the reply in the channel’s inbox. To fix this, always include the full handle in the format @channel@instance.tube in every reply.

PeerTube Instance Blocks Your Mastodon Instance

Some PeerTube instances have domain blocks that prevent federation with certain Mastodon servers. If your reply never reaches the PeerTube instance, check the PeerTube instance’s moderation policy. You can ask the instance admin to allow your Mastodon server. Alternatively, post your reply directly on the PeerTube video page using a PeerTube account.

Reply Is Set to Unlisted or Followers-Only

PeerTube only processes public replies. If your Mastodon post visibility is set to Unlisted or Followers Only, the PeerTube instance ignores the activity. Always set the reply to Public when you want it to appear as a video comment.

Video Creator Uses a Different PeerTube Instance

If the video creator moved their channel to a different instance, the old handle may no longer work. Verify the current channel handle by visiting the video page and clicking the channel name. Use the handle that appears on the video page, not an older handle you may have saved.

Mastodon Reply vs Direct Comment on PeerTube: Comparison

Item	Mastodon Reply Workflow	Direct Comment on PeerTube
Requires account	Mastodon account only	PeerTube account on the same instance
Notification to creator	Delivered via ActivityPub if handle is included	Delivered via PeerTube’s internal notification system
Visibility of reply	Visible on both Mastodon and PeerTube	Visible only on PeerTube
Dependency on instance	Both instances must federate	Only PeerTube instance matters
Ease of use	Requires manual handle lookup	One click after login

The Mastodon reply workflow gives you the advantage of keeping the conversation on your home timeline while still contributing to the PeerTube video’s comment section. The direct comment method is simpler but requires a separate PeerTube account and does not appear on Mastodon.

Now you can reply to PeerTube videos from Mastodon and have your comments appear on the video page. Always include the full channel handle in your reply and set visibility to Public. For future replies, save the channel handles of your favorite creators so you do not have to look them up each time. If a reply still does not appear, verify that the PeerTube instance is not blocking your Mastodon server by checking the instance’s federation status page.