❌

Normal view

How to use emojis on Mastodon

15 February 2026 at 22:00

You can add emojis to your posts in Mastodon, but the way you add them depends on whether you’re using the website interface or an app.

Using emojis on the Mastodon website interface

  1. Start writing your post
  2. Click the 🙂 picker icon
  3. Find the emoji you want either by searching for keywords or by scrolling through the available emojis
  4. Click the emoji and it will appear in your post (you can cut and paste it if it’s in the wrong place)

Using emojis on Mastodon apps

  1. Start writing your post
  2. If you want to use a normal emoji use the picker on your phone or tablet’s keyboard
  3. If you want to use a custom emoji use the picker within the Mastodon app, usually indicated by a 🙂 icon below the box where you write your post

They’re in two different places on apps because the on-screen keyboards on mobile devices don’t allow custom emoji to be displayed, so they have to be in a separate section in the app itself.

Typing emojis with a keyboard

If you’re using the web interface through a keyboard, you can also type emoji directly without using the picker.

What are custom emoji?

Custom emoji are additional emoji added by your server admin. People on other servers can see them, but only people on your server can use them. More info in the custom emoji guide.

How to set skin tone in emojis on the Mastodon web interface

Mastodon’s web interface includes an emoji picker, and you can set it to default to a particular skin tone:

  1. Click the emoji picker icon 🙂
  2. Click the ✊ icon next to the search box in the picker
  3. Choose the skin tone

The picker should now default to using that tone on emoji that support it.

I tried using the emoji typing shortcut but it defaulted to yellow. How do I get it to use the skin tone I chose?

There’s a known bug in the typing shortcut for emoji, where it ignores skin tone settings and just uses the default yellow non-tone emoji set. If you’re comfortable using Microsoft Github you can vote for this to be fixed by giving a thumbs up in the issue ⧉.

↩ Back to the front page

How to discover hashtags to follow on Mastodon and the wider Fediverse

28 January 2026 at 13:27

One of the best features on Mastodon and other Fedi platforms is that you can follow hashtags. This makes posts using that hashtag appear in your main timeline even if you aren’t following the person who made it, helping you discover interesting and relevant stuff.

Most tags are obvious and you don’t need help to discover them

You can find out how to follow hashtags in the guide, and most hashtags people use are just straightforward topic names such as #Gardening or #Cooking or #BoardGames etc. Basically, for any topic just stick # at the beginning of the word or phrase and capitalise the first letters of each word.

Some widely-used tags are non-obvious, so here is a list to help you discover them

However, there are also widely-used hashtags which you may not be aware of as they use unusual portmanteau words or phrases. Here is an attempt to list some of them:

#3GoodThingsPeople listing three good things that happened to them that day, or which they appreciate that day.
#A11yAbbreviation of accessibility
#AcademicChatterAcademics discussing academia
#ActuallyAutistic & #AutisticPosterDiscussion by and for Autistic people
#AfroIndigenousDiscussion by and for Afro-Indigenous or Indigenous-Black peoples in North America
#ArtForSaleArt for sale from independent artists
#AskFediGeneral queries on any topic, asking for advice or help
#AsstodonDonkeys
#AstrodonSpace and astronomy topics
#BandcampFridayIndependent musicians on days when musicians selling via Bandcamp get to keep all the money from their sales
#BikeTooterCycling and bicycles
#BIPOCNorth American acronym “Black Indigenous People of Colour”
#BlackMastodon & #BlackFediDiscussion by and for Black people
#BleptemberAnimals sticking their tongues out in September
#BloomscrollingFlowers
#BookstodonBooks
#BreadpostingBaking and breadmaking
#BugstodonInsects and arthropods
#CarryShitOlympicsUsing cargo bikes to carry more stuff than one might expect
#CatstodonCats
#CaturdayCats on Saturdays
#ClamFactsClam trivia
#DefaidodonSheep
#DogsOfMastodonDogs
#DOScemberMS-DOS computers, games and software during December
#FairTradeMusicFridayIndependent musicians using alternatives to Bandcamp including Faircamp and Mirlo
#FediAdminRunning a Fediverse server
#FediArtPosting art that you’ve made
#FediBlockRecommending blocks of servers doing bad things, usually blocks by admins
#FediBlockMetaDiscussing the general topic of blocking on the Fediverse without actually suggesting blocks
#FediDogsDogs
#FediGiftShopArt for sale from independent artists
#FediTipsTips on using Mastodon and the wider Fediverse
#FensterFreitagViews from windows or views of windows on Fridays
#FernFridayFerns on Fridays
#FlorespondenceFlowers
#FollowFridayRecommending accounts to follow on Fridays
#FootpathFridayHiking and walking trails on Fridays
#FossilFridayFossils on Fridays
#FridayThrillerClubWatching a thriller together on Fridays
#FungiFridayFungi on Fridays
#GetFediHired & #FediHirePeople looking for work, people offering work
#HashtagGamesHumorous posts based on wordplay challenges
#HawkPantsHawks that look like they’re wearing trousers
#HistodonsHistory
#IndigenousCreativesArt and crafts by Indigenous people
#InktoberDrawing with ink during October
#InsectSaturdayInsects on Saturdays
#IntroductionBrief introduction post about yourself
#JMusicFridayJapanese music on Fridays, sometimes with a specific theme each week
#JoinInEveryday life of people looking for conversation, especially at Christmas
#JukeboxFridayNightMusic on Fridays, often with a specific theme each week
#KPopMondayK-Pop music on Mondays
#LandBackReturn of land to Indigenous peoples
#LazySundayRelaxing stuff on Sundays
#LichenSubscribeLichens
#MacroMondayMacro photography on Mondays
#MagicInTheMundaneBeauty in everyday objects or situations
#MakanApaTodaySouth-East Asian food
#MarchintoshOld Macintosh computers during March
#MarshMadnessPhotos of marshes
#MastoAdminRunning a Mastodon server
#MastoArtPosting art that you’ve made
#Mastodaoine & #MastodonIEIreland and Irish people
#MeerMittwochSea views on Wednesdays
#MMIP & #MMIW & #MMIWG2SDiscussions of missing or murdered Indigenous people, acronyms standing for “Missing Murdered Indigenous People”, “Missing Murdered Indigenous Women”, “Missing Murdered Indigenous Women/Girls/Two Spirits”
#MondayActionMovieWatching an action movie together on Mondays
#MondayMotivationHelping people keep going on Mondays
#MonDogDogs on Mondays
#MonochromeMondayBlack and white photography on Mondays
#MonsterdonWatching monster movies together
#MosaicMondayPhotos of mosaics on Mondays
#MosstodonMoss
#MountainMondayPhotos of mountains on Mondays
#MovemberGrowing moustaches during November to raise awareness of men’s health issues
#MovieClubWatching films together, new film every two weeks
#MushtodonMushrooms and fungi
#MusicWomenWednesdayMusical women on Wednesdays
#NowPlaying & #NPMusic
#NowReadingBooks
#PhDLife & #PhDoneDiscussion by PhD students and recent ex-students
#SaturdaySceneryLandscape photography on Saturdays
#SepTandyTandy computers during September
#ShrimpSundayShrimps and prawns on Sundays
#SilentSundayCalm photos on Sundays
#SolarpunkSundaySolarpunk topics on Sundays
#SporespondenceMushrooms and fungi
#SportsballSport
#StandingStoneSundayPhotos and drawings of ancient megaliths on Sundays
#TeXLaTeXDiscussion of LaTeX typesetting system, hashtag used to avoid confusion with posts about Latex clothing
#TextureTuesdayPhotography emphasising texture on Tuesdays
#ThickTrunkTuesdayTrees on Tuesdays
#ThrowbackThursdayPhotos and/or memories from the past on Thursdays
#ThursdayFiveListLists of five songs on Thursdays, with a specific theme each week
#TilingTuesdayTiling in art, crafts and maths on Tuesdays
#TimelineCleanseAnything that brings pure innocent joy
#TinyBalancingSheepPhotos of sheep where they look like they’re balancing on fences and posts
#TongueOutTuesdayAnimals sticking their tongues out on Tuesdays
#TOTPDiscussion of UK music programme “Top of the Pops”, also used by totally unrelated discussions of computer security feature “Time-based One Time Password”
#TrainTrackTuesdayPhotographs of railway tracks on Tuesdays
#TransJoyPositive experiences by Trans people
#TuneTuesdaySongs on Tuesdays, with a specific theme each week
#TurtleIslandIndigenous term for the world or North America, Indigenous topics often discussed with this tag
#TwoSpirit & #2Spirit & #2SNorth American Indigenous term for third gender or gender variant people
#VendrediLectureFrench-language books on Fridays
#VintageAdsRetro advertisements
#WaterfallWednesdayWaterfalls on Wednesdays
#WeevilWednesdayWeevils on Wednesdays
#WhiskersWednesdayCats on Wednesdays
#WildlifeWednesdayWildlife photography on Wednesdays
#WrensdayWrens on Wednesdays

If you see irrelevant, offensive or spam posts on these or any other hashtags, you can report it by clicking ⋯ on the post and then Report.

↩ Back to the front page

How to fill your PeerTube server with federated videos

12 November 2025 at 17:31

If you run your own PeerTube server, when you first load it up it’s totally empty. You can upload your own videos of course, and if you’re running a public server your members can upload videos too. However, it may still seem a bit bare compared to centralised video sites like YouTube etc.

That’s where federation comes in! 🥳

If you run your own PeerTube server, as well as uploading your own videos and your members’ videos, you can federate videos from other servers by following them using your server’s federation tools. You can curate who you federate with to produce a unique video catalogue on your site, sort of like creating a mixtape ⧉.

If you want you can allow other servers to follow your server as well, but this is optional and you don’t have to allow it if you don’t want to. See the section marked “How do I control who federates my server’s videos?” for more details.

Why would I want to federate videos on PeerTube?

When you use your server’s federation tools, the videos from the servers or accounts being followed will appear on your server’s website too and be searchable from your site. The videos won’t actually be hosted on your server so they won’t take up any of your server space, federation just means that people will be able to watch, browse and search videos from other servers on your server’s website.

Federation is a way of helping people discover videos on a wider range of servers, and for this reason you may want to federate your server’s videos to other servers too. By the way, federation only happens with the permission of the other servers and/or video creators. The other servers and/or creators have to set their PeerTube to allow it, and they can optionally do it with an approval system to check who is requesting federation.

Do federated videos take up space or bandwidth on my server?

No, the federated videos are hosted on the server where they were uploaded. Federating doesn’t take up any of your server’s storage space or bandwidth.

How to federate another PeerTube server’s videos to yours

There are two approaches to federating videos from other PeerTube servers:

  • Following an entire other server, which is quickest and displays the most videos, but it may include accounts you would rather not federate.
  • Following specific accounts or channels, which is slowest and most labour intensive, but it means you’re customising your server’s federated feed to be exactly what you want it to be.

You can federate a mixture of servers and specific accounts in whatever combination you want. To actually do the federation:

  1. Log onto your PeerTube server’s website with your admin account.
  2. Click on Settings (you may need to click ☰ and then Settings if you’re using a phone)
  3. Click the Federation tab
  4. Click Follow
  5. In the new window, type or paste the domain names of the servers you want to federate to your server, and/or the accounts and/or the channels you want to federate to your server. You can type several as long as there’s a new line for each one.
  6. Click the Follow button of the window

After you’ve done this, follow requests will be sent to the servers and/or accounts and/or channels, and when the federation has been accepted you’ll see an Accepted label next to their names on the federation list.

If you change your mind, you can remove a server or account or channel by clicking Delete next to its name.

If you’ve forgotten who you federated with, you can browse the list or search it using the Filter box above it.

Which servers, accounts and channels should I federate with?

If you want suggestions for specific creators, there are some good PeerTube accounts and channels listed over on Fedi.Directory ⧉.

If you want suggestions for of nice servers to federate, here are some good ones:

(DISCLAIMER: I have not watched every video from every channel on these servers, there are far too many. I’ve tried my best but cannot guarantee the nature of their content. Please view a server yourself before you decide to federate with it.)

  • all.electric.kitchen – Experimental electronic music videos
  • archive.reclaim.tv – American community television station promoting FOSS in education
  • communitymedia.video – General server covering many topics, offering low cost video hosting to community channels
  • conf.tube – Technology conference video archive
  • dudelike.wtf – Personal server for a chilled-out dude posting on life, cooking, meditation etc.
  • fedi.video – Creative commons and public domain feature films, documentaries and curiosities, also silent films with modern soundtracks added, run by the creator of fedi.tips 🙂
  • flipboard.video – Official server for Flipboard, the news aggregation and curation platform
  • makertube.net – Server for creative people who create, build, design or fix things
  • media.fsfe.org – Official server of the Free Software Foundation Europe (NOTE: not affiliated in any way with the Free Software Foundation in the USA)
  • media.privacyinternational.org – Official server of Privacy International, an NGO campaigning for privacy as a human right
  • peer.tube – General server covering many topics, mainly in French, run by the creators of PeerTube’s server software
  • peertube.art3mis.de – Educational and video game videos, mainly in German and English
  • peertube.dair-institute.org – Institute set up by experts that are sceptical of the AI industry
  • peertube.kaleidos.net – Official server of Penpot, FOSS UI prototyping software
  • peertube.openrightsgroup.org – Official server of Open Rights Group, a UK NGO campaigning for civil liberties online
  • peertube.tv – General server covering many topics, run by the creators of the mstdn.social Mastodon server
  • peertube-us.howlround.com – Occasional livestreams from American theatre project
  • puppet.zone – Artist’s server creating lovely muppets-style puppets
  • solarsystem.video – Space and planetary science videos, including short documentaries, long-form academic lectures etc, run by the Planetary Research Cooperative
  • spectra.video – General server covering many topics, run by creator of WeDistribute social network news site
  • tilvids.com – Educational and entertainment videos, informative in some way
  • tinkerbetter.tube – Official server of the popular Veronica Explains series about FOSS, Linux, retro technology etc.
  • toobnix.org – General server covering many topics, run by the SDF Public Access UNIX system
  • trentontube.trentonhoshiko.com – Film-making, cinematography and photography videos by low-budget film-maker
  • tube.fediverse.games – Gaming video server, covering all forms of gaming
  • tube.kockatoo.org – KDE software development community videos
  • tube.tchncs.de – General server covering many topics, mainly in English and German
  • tubefree.org – General server covering many topics, run by the non-profit BT Free
  • tv.dilstories.com – Film-making and short films, run by award-winning Ugandan director
  • urbanists.video – City planning, public transport and cycling enthusiasts
  • v.basspistol.org – Music videos from independent and underground artists of many genres
  • video.blender.org – Official server of Blender, the free open source 3D animation suite
  • video.canadiancivil.com – City planning, public transport and cycling videos, covers world but often features Canada
  • video.fedihost.co – Tutorials, tips and podcasts about hosting your own Fediverse servers including Mastodon, Peertube, GoToSocial etc.
  • video.firesidefedi.live – Interviews with familiar faces from around the Fediverse, also gaming and programming videos by the server’s maintainer
  • video.franzgraf.de – Hiking and cycling videos, in English but from the mountains of Germany
  • video.gamerstavern.online – Video game videos from a friendly non-toxic gaming community
  • video.hardlimit.com – Video game and technology videos in English and Spanish
  • video.infosec.exchange – General server covering many topics, run by the admins of the infosec.exchange Mastodon server
  • video.katehildenbrand.com – Gardener and marine biologist posting on nature, gardening, biology, food etc.
  • video.stevesworld.co – Music videos by singer-songwriter
  • video.thepolarbear.co.uk – Personal server for a fun livestreamer and his friends, often features pop culture and technology
  • videos.elenarossini.com – Documentaries by Italian film-maker and Fediverse fan
  • vod.newellijay.tv – Community television station based in the USA, hosting all kinds of programmes including music, theatre, sport, archive public domain films etc.

If you think I’m missing something, or if you think I shouldn’t be listing one of these, please contact me.

Can I find any other lists of servers or accounts/channels to follow?

Yes, if you go to any PeerTube server’s website you can view its network:

  1. Go to a PeerTube server’s website
  2. Click More Info (or ☰ and More Info if you’re on a phone)
  3. Click the Network tab
  4. The Subscriptions section shows the servers and accounts/channels that the server is following, the Followers section shows other servers that are following that server.

You can use these network pages of other servers to get suggestions for which other servers and accounts/channels to follow. The network page will be different on each server.

Which videos from a server get federated to my server? Is it just the server’s own videos, or all the videos that it federates with too?

It’s just the server’s own videos.

For example if you follow fedi.video the only videos it would federate to your server would be those hosted on fedi.video, it would not include videos that are visible on fedi.video but hosted on other servers.

How do I see just the videos on a particular server, and hide the videos it has federated from other servers?

To just see a server’s own videos and hide all the videos it has federated from elsewhere:

  1. Go to the server’s website
  2. Click the Browse Videos tab
  3. Click the More Filters link just below the “Videos on…” heading
  4. In the Displayed Videos dropdown menu, select “Only videos from this platform”

These are the videos that would be federated to your server if you follow them.

Which videos get federated?

By default all of the videos get federated. PeerTube uses “backfilling” so that when you federate with a particular server, account or channel it checks to see all the videos it has ever uploaded.

How do I screen out sensitive or “NSFW” videos?

Some servers may contain sensitive content such as adult content, or distressing images such as from a war etc. Most servers which allow such content require the uploader to mark it as sensitive, which means other servers can easily take appropriate action about this content.

If you want to hide or blur sensitive videos viewed via your server, do the following:

  1. Log onto your PeerTube server with your admin account
  2. Click on Settings (you may need to click ☰ and then Settings if you’re using a phone)
  3. Click the Information tab
  4. Scroll down to the section marked Moderation & NSFW
  5. From the dropdown menu marked Policy on videos containing sensitive content, select “Hide” to hide them completely or “Blur” to show them but with a blurred thumbnail
  6. Scroll down to the bottom of the page and click the Update Configuration button

This applies to all sensitive videos, including from your server and from other servers you federate with.

If you encounter a sensitive video that has not been marked as sensitive, you might want to stop following the server it came from and contact the owner of the server to let them know about it.

How do I control who federates my server’s videos? How can I switch federation on or off? How can I screen who federates my server?

Here’s how to adjust who can federate your server’s videos:

  1. Log onto your PeerTube server with your admin account
  2. Click on Settings (you may need to click ☰ and then Settings if you’re using a phone)
  3. Click the Basic tab
  4. Scroll down to the section marked Federation
  5. If you want other servers to be able to federate your server’s videos, tick the box marked “Other instances can follow yours”.
  6. If you are allowing federation but you want to manually approve each server that federates yours, tick the box marked “Manually approve new instance followers”.
  7. Scroll down to the bottom of the page and click the Update Configuration button

If you’ve set your server to allow federation but with manual approval, you will get a notification to your admin account that there is a server wanting to federate your server’s videos. You can click on the notification or go to Settings > Federation > Followers to approve or deny the federation request.

I tried to federate an account to my server but not all of its videos are showing up. What’s going wrong?

In theory if you federate a PeerTube account to your server it should show all the videos from all of the account’s channels. However in practice it sometimes doesn’t do this reliably. This can be solved by also following all the channels that belong to that account, which makes all the account’s videos show up properly.

I just want to show one channel from an account but not the whole account, can I do this?

Yes. If you just follow the particular channel you want and don’t follow the overall account, only that channel’s videos will show up on your server.

If I federate an account or a server, does it show older videos uploaded a while ago?

Yes, it shows all the videos ever uploaded by that account or server. PeerTube uses “backfilling” to show everything a PeerTube account has ever posted.

(Obviously though, sensitive videos would be hidden if you have set your server to do so.)

↩ Back to the front page

How to promote your PeerTube videos, account and channels

9 November 2025 at 20:24

Do you publish videos on PeerTube? Would you like more people to follow you on PeerTube and watch your PeerTube videos?

This is a guide to how to make your PeerTube account, channels and videos more discoverable. You don’t have to do everything in this guide, but the more you do here the more discoverable your videos become.

Read tips on how to publish on PeerTube

If you want more info on how to actually publish videos, see the step-by-step guide to publishing on PeerTube. If you’re a serious video maker you might want to read the section on starting your own server, it’s a lot cheaper and easier than people realise (you don’t need to be rich or a techy person).

Check that your videos are searchable in Sepia Search

PeerTube has an official search engine at SepiaSearch.org ⧉. Check that your published videos are searchable there by searching.

If your videos aren’t searchable, give it some time for the search index to update. If it’s already been a while since your videos were published, add your server’s websites address on the official instances list ⧉.

Suggest your PeerTube account and channels to Fedi.Video

The author of this guide also runs a site at Fedi.Video ⧉ which features a human-curated selection of good PeerTube accounts. If you run a nice PeerTube account, get in touch with the Mastodon account @fedivideo@social.growyourown.services ⧉ to suggest your account be listed.

(For moderation reasons, Fedi.Video generally only includes English-language videos or videos with English-language subtitles.)

Add descriptions to your PeerTube account and channels

It’s really quick, easy and important to describe your PeerTube account and channels. These descriptions are crucial because people use them to decide whether or not to follow you or watch your videos. These descriptions are also used by other Fediverse platforms such as Mastodon for showing your profile and displaying it in search results.

To add an account description:

  1. Log into PeerTube on your server’s website
  2. Go to your profile page
  3. Click Manage Account
  4. Write your account description in the Description box
  5. Click the Save Profile button

To add a channel description:

  1. Log into PeerTube on your server’s website
  2. Click Channels
  3. On the channel you want to add a description for, click Update
  4. Write your channel description in the Description box
  5. Click the Update Channel button

Add descriptions to all your channels if you can.

Add tags to your videos

If you want to make them discoverable, it’s really important to add tags to your videos. These make people a lot more likely to discover them as a lot of people on the Fediverse follow hashtags, which means your video may automatically appear in the main timelines of people following that tag. Many people also search for hashtags, so including tags on a video it will be in the search results for those tags.

It’s best to add tags to a video before you publish it, you can find out how to add tags in section 7 of the PeerTube publishing guide.

Upload your videos gradually, don’t upload all your videos at once

A lot of people with an back catalogue of existing videos are tempted to just upload all of them at once onto PeerTube, then wait for people to discover them. This generally doesn’t work due to the way Fediverse servers discover and display content.

Most of the Fediverse deliberately doesn’t use algorithms. Instead, people see all the posts from all the accounts they follow displayed chronologically in their main feed. If you upload 500 videos all at once, most people following you will see 500 posts swamping their timeline all at once, and then they won’t see anything else from you until you upload new stuff.

Also, due to the way Fediverse servers “notice” content, uploading after you have gained followers will make your videos a lot more visible to a lot more people on a lot more servers. If you upload before you have any followers at all, the uploaded videos may not be visible at all to most servers.

Most of your potential followers and viewers are on Mastodon!

PeerTube is part of a much larger social network called the Fediverse. Most of your potential followers and viewers aren’t on PeerTube itself but on other Fediverse platforms such as Mastodon etc. Because the Fediverse uses common open technical standards, people on Mastodon etc can follow and interact with you on PeerTube, and it is from these other Fediverse platforms where most of your followers and viewers will come from.

For this reason, you might want to focus promoting your PeerTube on other Fediverse platforms such as Mastodon etc.

Create an account on Mastodon etc. to promote your PeerTube

You might want to create an account on Mastodon to complement your PeerTube. The most successful PeerTube accounts all have Mastodon etc accounts too, which allows them to join in with discussion threads rather than just publishing videos. For example a PeerTube account about gardening might set up a Mastodon account so they can join in with general discussions about gardening.

Share your PeerTube address with people on the Fediverse

You can encourage people on the Fediverse to follow your PeerTube account by telling them your PeerTube fediverse address, which will look something like this:

@(username)@(server)

All accounts on the Fediverse have a unique address in this form, which allows anyone on any Fedi platform to search for an account’s profile. The user can then just click on the profile and click its “Follow” button to follow it, even if they’re on a non-PeerTube platform such as Mastodon etc.

If you’re using Mastodon or another similar Fediverse platform, you can paste a Fediverse address into a post and it will appear as a clickable link that people can click on to see the account’s profile.

When viewed from Mastodon, a PeerTube account profile will contain the PeerTube profile image and text description and clicking follow will follow the PeerTube account itself. Videos published by that PeerTube account after the moment of following will start appearing in the follower’s Mastodon timeline.

You can usually find a PeerTube account’s or channel’s Fediverse address on PeerTube by clicking the ⧉ button next to a username on your PeerTube server’s website, but you may need to add @ to the start so that they work fully on Mastodon etc. (For some reason PeerTube seems to leave off the leading @ on this copy button.)

Use quality control

If you upload lots of videos regardless of how useful or interesting they may be to others, it will make it much harder for people to notice your good videos.

People will be a lot more likely to follow your PeerTube if you only upload videos that you know people will enjoy watching. The PeerTube accounts with the largest follower numbers are ones that only upload high quality edited videos, or at least video clips they have chosen carefully.

Nicely edited videos are wonderful of course, but you don’t have to be an expert video editor to exert quality control. For example some popular channels just show unedited clips of wildlife, but they only show clips they consider interesting or entertaining.

Engage with your viewers

If someone has commented on your video you will see a notification about this when you’re logged into PeerTube. Reply to their comment, engage with them, answer their questions or thank them for their feedback. People will be a lot more likely to follow you and watch your videos if they know there is a friendly human being behind them.

Think about time zones when publishing videos

Most people on the Fediverse browse non-algorithmic chronlogical timelines, so they see every post from every account they follow at the moment it is published.

If you have a video aimed at people in a particular time zone, publish it when people from that time zone are most likely to be browsing their timelines. If you’re trying to reach multiple timezones, try to find a sweet spot when most people are awake in those time zones (for example the evening in Europe is the morning in the Americas).

Use nice thumbnails on your videos

By default videos will just show a still from the video as their thumbnail. However, it’s usually a good idea to upload a custom thumbnail so that people get a good idea of what your video is about. To add a thumbnail:

  1. Log onto your PeerTube server’s website
  2. Click Videos
  3. On the video you want to add a thumbnail to, click Update
  4. Click the Advanced Settings tab
  5. In the Video Thumbnail section click Select From Your Device and select the thumbnail image file
  6. When the thumbnail has finished uploading, click the Update button at the bottom of the screen

You can monetise PeerTube by having sponsors and patrons

There is no advertising system on PeerTube so there are no adverts inserted into videos. However, PeerTube accounts can receive an income through sponsors and patrons, and you may see sponsors’ messages and/or there may be a list of patrons being thanked.

PeerTube has an option to upload videos to unlisted URLs and/or password-protected URLs. These can be used to give patrons early access to your videos.

You can also include a “support” link on your videos which people can click to find out how to donate to you. To add a support link in PeerTube:

  1. Log onto your PeerTube server’s website
  2. Click Channels
  3. On the channel you want to add a support link for, click Update Channel
  4. In the Support box add some explanatory text and links to your donation platforms (Ko-fi, Liberapay, Patreon etc)
  5. Click Update Channel

If you’re uploading VODs of livestreams, either edit out the leadup or have a countdown timer

It can be very frustrating for people watching VODs (videos on demand) of livestreams to see it begin with a “starting soon” placeholder that goes on for many minutes without any clue as to when it actually starts. A lot of people will simply bail out and won’t even skip ahead.

People are much more likely to watch your VODs if the intro is either edited out or if there is a countdown timer visible so that people can skip forward easily.

People can also follow your PeerTube channels from podcast apps such as Apple Podcasts, or RSS-compatible news feed readers

As well as follows from PeerTube and other Fediverse platforms like Mastodon etc, PeerTube channels can also be followed by people totally outside the Fediverse who may not even have social media accounts.

All PeerTube channels have an RSS feed which is podcast-compatible, which means people can follow any PeerTube channel from any podcasting app that supports adding podcast addresses (such as Apple Podcasts) or any RSS news feed reader app. See the guide to following PeerTube from podcast apps for more details.

If people follow you from podcast apps or RSS apps, they won’t show up in your PeerTube follower numbers but they will show up in your PeerTube viewing figures.

Update your videos if you want to

PeerTube lets people upload new versions of their videos without breaking any links or losing any comments. To update a video:

  1. Log onto your PeerTube server’s website
  2. Click Videos
  3. On the video you want to update, click Update
  4. Click the Advanced Settings tab
  5. In the Replace Video File section click Select the file to upload and select the video file from your device
  6. The new video file will now start uploading, indicated by a progress bar at the top. Wait for it to finish uploading.
  7. After the new version of the video has uploaded, click the Update button at the bottom of the screen.

If you can’t see an option for replacing video files, ask your PeerTube admin to activate this option in Administration > Settings > Configuration > Basic > Videos > Allow users to upload a new version of their video

You can optionally allow people to download your videos directly

If you want to spread your PeerTube videos as far and wide as possible, for example if you’re running a public service account or distributing Creative Commons and public domain content, you might want to optionally let people download your videos so they can watch it offline, share it with others or upload them elsewhere.

To activate the download option for a particular video:

  1. Log onto your PeerTube server’s website
  2. Click Videos
  3. On the video you want to allow downloads for, click Update
  4. Click the Advanced Settings tab
  5. Tick the box marked Enable Download
  6. Click the Update button at the bottom of the screen

After you’ve done this, people viewing that video on PeerTube will be able to download it as a DRM-free file by clicking ⋯ and Download.

This option has to be activated video by video, there is no way to activate it for all your videos at once.

↩ Back to the front page

How to use the Fediverse on your Ghost-powered site

15 October 2025 at 18:16

Websites powered by the Ghost blogging platform ⧉ are now compatible with the Fediverse, so they can be followed and interacted with from Mastodon etc.

(As well as my unofficial guide below, you might also want to check out the official ghost.org guide to using the Fediverse via Ghost ⧉. They call it “the social web” but they mean the Fediverse.)

How do I activate the Fediverse on my Ghost-powered site?

  1. Log into your Ghost site with your Owner or Admin account
  2. Go to your Settings page (the ⚙ cog icon at the bottom left of the page)
  3. On the left of the Settings page, scroll down to the section marked Growth and click on Network
  4. Make sure the Network toggle switch is activated
  5. Close the Settings page by clicking X in the top right corner
  6. On the main admin page (NOT on the settings page) click on Network on the left of the page
  7. On the right of the screen click on Profile
  8. Click Edit Profile
  9. Set your display name, handle and bio text for your Fediverse profile. NOTE: It’s really important to choose a handle that is distinctive and suits your blog, for example a good handle for “The Widget Blog” would be WidgetBlog. Do not put any spaces or special characters in the handle, just use letters. Do not use generic handles like “me” or “blog”.
  10. Click Save

Congratulations, you now have a Ghost account that is part of the Fediverse!

Why would I want to do this?

Activating Fediverse features lets the millions of people on the Fediverse more easily discover and follow your Ghost site.

It also lets you follow and interact with the Fediverse including people on Mastodon, other Ghost sites, WordPress sites and lots more.

If people follow my Ghost account from Mastodon etc, do they see my Ghost blog’s posts?

There are now three ways of posting on Ghost:

  • Newsletters, these work just like before.
  • Blog/web posts, these work just like before, but people who follow you on Mastodon etc will be notified when a new blog post is published. They won’t see the blog post itself, just a link to the blog post on your Ghost website.
  • There’s now a third option, Notes, which are short-form 500 character posts only shown to people who follow you from Mastodon etc.

There are also two timelines added to the “Network” section of your Ghost site’s admin page:

  • Reader Timeline: Long-form blog posts from Ghost and WordPress accounts you follow.
  • Notes Timeline: Short-form posts from Mastodon etc accounts you follow.

How do I get people to follow my Ghost account from Mastodon etc?

If you go to your Fediverse profile in Ghost, you’ll see your Fediverse address just below your display name (it looks something like “@MyBlog@example.com”). There’s also a button next to it, click the button to copy the address.

Share this address with anyone who wants to follow you from Mastodon or other Fediverse platforms. People on the Fediverse can paste this address into their search box (in Mastodon etc) and your Ghost account’s profile will appear, they can then just click on your profile’s “Follow” button.

This might seem fiddly but it’s mainly there to get you started. After enough people have followed you from Mastodon etc, your Ghost account will also start gradually showing up in search results, mentions and shared posts across the Fediverse. The more people who follow you, the more widely your account will start showing up in searches etc. People discovering your account by these other methods will be able to click on your account profile directly and won’t need to bother with the copy-paste thing.

Do my followers on the Fediverse see my blog posts on Ghost?

When you publish a blog post on Ghost, your followers on Mastodon etc will see a Fediverse post in their timelines linking to your Ghost blog post. The Fediverse post doesn’t show the actual text of your blog post, but it shows the blog post title, a link to the blog post and a preview below the link.

How do I follow people on the Fediverse from Ghost?

If you know an account’s Fediverse address, paste it into the Search box and then click “Follow”. You can discover lots of interesting Fediverse accounts and their addresses at Fedi.Directory ⧉.

What Fediverse platforms can I follow from Ghost?

At the moment Ghost is confirmed to work well with following Mastodon accounts, other Ghost accounts, WordPress accounts that have ActivityPub activated and others.

There is a current compatibility list on ghost.org ⧉ but it doesn’t mention most Fediverse platforms one way or the other, so it might be easier to simply try following an account and see what happens.

How do I interact with people on the Fediverse from Ghost?

On Ghost’s main Admin page, click on Network to see your Fediverse features available on the right of the screen:

  • 🔍 SEARCH: You can use this to follow Fediverse accounts, paste their Fediverse address into the search box to bring up their profile and then click their Follow button. You can discover addresses for lots of interesting Fediverse accounts at Fedi.Directory ⧉.
  • 📖 READER: If you’re following long-form blogging accounts from Ghost etc, their posts will show up in Reader. You can interact with long-form posts by hovering the mouse over their preview image to see that post’s interaction icons (heart to like, speech bubble to reply, arrows to share, dots for more options).
  • 💬 NOTES: If you’re following short-form microblogging accounts from platforms like Mastodon etc, their posts will show up in Notes. You can reply/like/share their posts here, and you can also create your own short-form 500 character posts by clicking “What’s new?” at the top of the page. This is totally separate from your main blog posts, and only shows up for your Fediverse followers.
  • 🔔 NOTIFICATIONS: If people follow or mention you on the Fediverse, this will show up in Notifications. You can reply to a mention by clicking the speech bubble, like it by clicking the heart or share it with your followers by clicking the arrows.
  • 🌐 EXPLORE: Suggests Fediverse accounts to follow, but at the moment it only seems to suggest Ghost accounts. You can discover Fediverse accounts from many different platforms at Fedi.Directory ⧉.
  • 👤 PROFILE: Lets you edit your Fediverse profile and view its details.
  • 🎚 PREFERENCES: Various bits of info and settings related to the Fediverse. Click Moderation within here to see a list of all the accounts and domains you’ve blocked.
  • 📝 NEW NOTE: Lets you create a short-form post up to 500 characters which goes out to your Fediverse followers only. It is totally separate from your usual Ghost blog posts. This is identical to the option at the top of the Notes section.

How do I block specific Fediverse accounts within Ghost?

Click on the name of the Fediverse account you want to block, which will take you to its profile page. Then click ⋯ in the top right of the profile and select “Block user”.

How do I see which Fediverse accounts I’m following and being followed by?

Go to Profile, then click Following for accounts you follow and Followers for accounts that follow you.

Does this work by linking my Ghost account to a Mastodon account?

No, Ghost works totally independently. Each Ghost site is a Fediverse server in its own right.

Does this work on self-hosted Ghost sites?

Yes, you can use the Fediverse either on sites hosted by ghost.org or on self-hosted Ghost-powered sites.

However, if it’s self-hosted you will need to use an ActivityPub service that can handle all the stuff you do on the Fediverse. There are two options for this at the moment:

↩ Back to the front page

Ghost: Blogs and newsletters on the Fediverse

29 September 2025 at 18:36

Ghost ⧉ is a very popular free open source platform for creating websites, blogs and newsletters. It includes a paid subscription option, and is intended as a more ethical alternative to Nazi-hosting Substack ⧉.

You can now follow Ghost-powered sites from Mastodon etc as Ghost’s software has added Fediverse compatibility.

What’s the problem with Substack?

Perhaps the biggest problem is that it hosts and makes money from openly Nazi accounts featuring swastikas and which promote racist conspiracy theories ⧉.

Substack’s co-founder said in a post on his own blog in 2023 that they prefer to host Nazi accounts rather than remove them. When a backlash happened, Substack removed five such accounts but an investigative report from 2026 found lots more Nazi Substack accounts that continue to this day ⧉.

I currently use Substack but am interested in Ghost. What are the advantages of Ghost over Substack? How do I migrate my Substack account to Ghost?

There’s an excellent article by the tech journalist @molly0xfff@hachyderm.io ⧉ about the multiple benefits of migrating from Substack to Ghost, and also details of how she did it: Migrating from Substack to self-hosted Ghost: the details ⧉.

The article is about self-hosting Ghost but if you want an even easier option you can use paid options including managed hosting from Cloud68 ⧉ or the Ghost developers’ own hosting service Ghost.org ⧉.

I have a Ghost-powered site. How do I activate and use its Fediverse features?

See the guide to how to use the Fediverse on your Ghost-powered site.

How to follow Ghost-powered sites from Mastodon etc.

  1. Go to explore.ghost.org ⧉ (if you already know which Ghost site you want, skip to step 4 below)
  2. Click the category tab you want (swipe the tabs right to see more categories)
  3. Click the Ghost site you want to follow to find out more about it. If the Ghost site has its Fediverse account activated, you will see a section marked “On the social web” in its listing.
  4. Click the “Copy” button in the “On the social web” section, this will copy the Ghost site’s Fediverse address.
  5. In Mastodon etc, paste the address into the search box and the Ghost site’s profile will appear. Click on “Follow” to follow it and its posts will start gradually showing up in your timeline.

If there is no “On the social web” in a listing, it means the Ghost-powered site hasn’t switched on its Fediverse compatiblity.

Is there a list of good Fediverse-compatible Ghost sites anywhere?

Yes, you can browse a human-curated list of good Ghost sites with their Fediverse addresses ready for you to copy-paste into Mastodon etc over on Fedi.Directory’s Ghost section ⧉.

Will Ghost-powered sites appear in search results in Mastodon etc?

Yes. As more people follow Ghost sites, they will gradually start showing up in search results on Mastodon etc alongside all the other kinds of Fediverse accounts. If you see a Ghost site in search results, you can just click on it and don’t need to copy-paste anything.

↩ Back to the front page

How to search PeerTube, how to discover PeerTube videos to watch and PeerTube accounts to follow

27 September 2025 at 18:01

There are several different ways of searching and browsing videos and accounts on PeerTube, each with its own advantages and disadvantages listed in their sections below.

However, before getting onto the methods, just want to make clear you can follow and interact with PeerTube from entirely within Mastodon if you want to, the videos will show up in your main timeline like any other post and your replies in Mastodon will automatically become comments in PeerTube.

  • To follow a PeerTube account from within Mastodon, copy-paste the PeerTube account’s Fediverse address into the search box in Mastodon. Its profile page will appear in the search results in Mastodon, where you can click “follow”. You can find a PeerTube account’s address at the top of its profile on PeerTube, just below its name.
  • To interact with a PeerTube video within Mastodon, copy-paste the video’s web address into the search box in Mastodon. It will appear as a post that you can reply to or favourite or share.

Okay, now onto all the ways you can discover PeerTube videos and accounts!

Search on Sepia Search

Sepia Search ⧉ is the official PeerTube search engine run by the developers of the PeerTube server software. It tries to index all public videos from as many PeerTube servers as possible, but will remove problematic servers when noticed or reported.

Sepia Search has the widest range of search results, but also the greatest risk of seeing unsuitable or problematic content. You can use it at SepiaSearch.org ⧉ or see a list of the servers it indexes at instances.JoinPeerTube.org ⧉.

⚠ If you see anything unsuitable in the Sepia Search index, report it to the PeerTube server where you saw it via the server’s website (click on “More info” and then “Contact us”). If that doesn’t work or if the entire server is problematic, you can ask Sepia Search directly to remove that server from their index by going to instances.JoinPeerTube.org ⧉ and emailing the address at the Report an instance link in the top right corner of the page.

(For any techy people reading this, Sepia Search runs on free open source software ⧉ and people with the required technical knowledge are free to create their own alternative index using their own list of servers ⧉.)

Visit the Fedi.Video website

Fedi.Video ⧉ is an unofficial site trying to create a safer higher-quality human-curated way to search and browse the best accounts on PeerTube. Every account listed on Fedi.Video has been manually checked before it is included in the index.

You can search and browse Fedi.Video on its website ⧉. You can search using the search box at the top, you can browse lots of human-curated playlists on particular topics below the search box, or browse the latest videos and trending videos below the playlists.

Fedi.Video has a much narrower range of search results compared to Sepia Search, but because it’s human-curated it’s also a lot safer and higher quality. If you do see anything unsuitable, you can report it on the Fedi.Video website by clicking “More Info” and then “Contact Us”.

Follow the Fedi.Video account on Mastodon

There is a companion account to the Fedi.Video website on Mastodon which posts handpicked human-curated videos from a wide range of PeerTube accounts. Just paste this into the search box on Mastodon and click follow:

@FediVideo@social.growyourown.services

After you follow this account, PeerTube videos handpicked by the account will start gradually appearing in your timeline on Mastodon. If you see a video you like and want to see more, click on the video’s account name and follow the account that made the video.

Browse the PeerTube recommended account list on Fedi.Directory

The Fedi.Directory website lists interesting accounts from across the Fediverse, and has a section listing good PeerTube accounts ⧉ which you may want to browse.

When you find an account you want to follow on this list, copy its Fediverse address and paste this into the search box in your own server on Mastodon or PeerTube (or many other Fediverse platforms). This will bring up its profile which you can click follow on.

Note that the list on Fedi.Directory randomises each time the page is loaded in order to give accounts equal visibility. If you intend to gradually go through the list, leave it open in a tab while you do so and don’t reload it.

Use the search box on PeerTube servers

Each PeerTube server has a search box at the top, but these are not all the same. Each server’s admin decides what kind of results show up for searches

Some admins opt to just search channels that the server federates. Others have connected it to Sepia Search to give a wider range of results. Meanwhile some servers just show results for videos on that server.

If you’re unsure about what an admin has chosen for their server, you can contact them via that server’s “More Info” page on its website.

Use the search box on Mastodon servers

Because PeerTube is part of the Fediverse, its accounts and videos will often show up in searches on Mastodon etc servers. For example if you search for “Blender” on your Mastodon server you may well see the official Blender PeerTube account in the results. Mastodon search boxes show all the results for all the accounts and posts that that Mastodon server has noticed.

However, there is no way to split Mastodon search results by server type, so there’s no way to split the PeerTube results from the Mastodon etc results. You will see PeerTube accounts and videos mixed in with Mastodon etc accounts and posts and they’re not labelled differently in any way. PeerTube videos look like Mastodon posts when viewed within Mastodon.

Making your own PeerTube search engine (if you are techy)

All of the software used in Sepia Search is free and and open source. If you are a very techy person who likes to host their own online services, you can make your own alternative to Sepia Search using your own list of servers.

The source code for the search engine is here ⧉ and the source code for the server list is here ⧉.

↩ Back to the front page

How Mastodon admins can set their server website’s default language

18 August 2025 at 20:30

By default, Mastodon server websites automatically display themselves in the language of the browser viewing the site. For example, if someone has set their browser language to French they would automatically see most Mastodon server websites in French, even if they haven’t logged in and even if the server’s own default language isn’t French.

This automated behaviour is fine if a server is open to speakers of all languages, but it may cause problems on servers that are intended for a specific language. People may accidentally sign up on a server where no one speaks their language.

In order to solve this problem, admins can optionally set their server website to always display in a particular language for everyone.

I am a non-techy person running my server on managed hosting. How do I set my server to display in a particular language?

Contact your managed hosting provider and explain you want to make your server website appear in a specific language for everyone who isn’t logged in.

If they need more info, the official documentation for this option is here ⧉.

If they ask you which language code you want to set, you can see a complete list of Mastodon language codes here.

I am a techy person running my own server manually. How do I set my server to display in a particular language?

You need to set your DEFAULT_LOCALE to your preferred language code, and also set FORCE_DEFAULT_LOCALE=true

The documentation for this is here ⧉.

Will this affect the language displayed for server members who have logged in?

No. It will only affect your server website’s language for people who haven’t logged in. If they are logged in, it will use whatever interface language they want to set it to.

When did this website language behaviour begin? I’m sure it never did this before?

The current website default language behaviour began on Mastodon v4.4.0. Before this, the website visitor’s browser language was ignored.

↩ Back to the front page

How to give people early access or exclusive access to your PeerTube videos

26 July 2025 at 21:39

When you publish a video on PeerTube, the upload screen includes a dropdown menu which lists many different types of visibilities.

If you would like to give specific people early or exclusive access to a video, choose the visibilities “unlisted” or “password protected”. You can then share the unlisted link or the link and password with whoever you want to give access to.

This is especially useful for giving your patrons early access, or for getting feedback on a video before you fully publish it. It can also be used for any other purpose where you want to restrict the audience of a video.

↩ Back to the front page

Closing your Mastodon server gracefully

22 July 2025 at 13:23

No one likes to think about it, but there are lots of different reasons why a server on a network might close down. If you are a Fediverse server admin and want to close down your server, it is important that you do the closure gracefully.

Gracefully on the Fediverse means giving plenty of warning to the server’s members, so that they have enough time to find another server and to move their accounts elsewhere. It also means trying to make sure all your members are aware of the closure long before it happens. See the example plan at the bottom of this guide for more details.

How much warning should I give my server’s members about closing down?

The standard closure warning time on the Fediverse is three months.

Three months is enough time for your members to find another server, become familiar with the transfer process, do the transfer and potentially re-run the transfer if necessary. It also gives admins enough time to try to warn every active member, as some may be more difficult to reach than others.

When should I start planning for closing down my server?

Make a plan for closing down gracefully before you first open your server to the public. Having a graceful closure plan from the very beginning means people can have confidence in joining your server, because they know you won’t suddenly switch it off without warning.

Committing to three months warning is also required for listing on some server directories such as fedi.garden ⧉ and joinmastodon.org ⧉. Planning for graceful closure can actually help your server grow by making it eligible to be listed.

What if I run out of money? How do I keep my server going three months?

As part of setting up the server you should put money aside for three months of running costs, so that no matter what happens there will be three months to close down. The amount put aside may need to be increased if the running costs go up.

How do I close my server down gracefully? What order should I do things in?

It’s up to you how you close your server, but here is a typical plan:

  1. Make sure you are absolutely certain about closing your server. Once you announce it people will start leaving, so it’s best to be sure before you announce it. Decide on a specific date when the closure will actually happen.
  2. Decide on a public closure date that is at least a couple of days earlier than the actual closure date. This public closure date will be what you tell your members. The difference in dates is to allow wiggle room for members in different time zones, who may see different dates on their interface. It also covers you in case of last minute technical hitches in the closure.
  3. When you’ve decided to close, first of all switch off sign-ups. No one wants to sign up on a server that is closing. You can do this in Preferences > Administration > Server Settings > Registrations > Who Can Sign Up, choose Nobody Can Sign Up, then click Save Changes.
  4. Deactivate existing invitation links in Preferences > Moderation > Invites > Deactivate All. After that, switch off the members’ invitation option completely in Preferences > Administration > Roles > Default Permissions, then UN-tick the box marked Invite Users, then click Save Changes.
  5. Post about the closure on your admin account, give the public closure date, and tell your members they need to move their account to another server. The date is really important in motivating people to transfer their accounts in time. You might want to provide a link to the Fedi.Tips account transfer guide so that people know how to move their accounts elsewhere, links to the fedi.garden ⧉ and joinmastodon.org ⧉ server directories so they can pick somewhere reliable to move to, and a link to the Fedi.Tips archive download guide so they can download their post archives. Also remind them that account transfers can sometimes take days to complete, and it’s safest if they do the transfer as soon as possible.
  6. Post a similar announcement on your Mastodon server’s announcement system. You can optionally also send these server announcement to members directly by email. You may want to use this email feature to make sure members realise the server is closing down.
  7. Edit your server’s text descriptions so that it makes clear the server is closing down and when it is closing down. This is yet another way that members may see the closure announcement, as they see the server description when logging into the server website. Servers have two text descriptions so you should edit both, the shorter one at Preferences > Administration > Server Settings > Branding > Server Description and the longer one at Preferences > Administration > Server Settings > About > Extended Description.
  8. Repeat the announcements two months before closure, one month before closure, three weeks before closure, two weeks before closure, then every day in the final week before the public closure date. If you see members continuing to post in the final few weeks, you might want to reply to them directly to remind them about the closure date and that they need to transfer their account as soon as possible.
  9. Do the actual closure at least a couple of days after the announced closure date. This is to make sure members in different time zones don’t get caught out, as the date on their interface may be different to yours.

How do I do the closure gracefully at a technical level?

At a technical level, there are two ways of closing a Mastodon server:

  • Just deleting the server from its hosting
  • Running Mastodon’s “self-destruct” command, giving it time to work, and then deleting the server from its hosting

There are pros and cons to both methods, which are explained in an excellent guide by the managed hosting provider masto.host ⧉. Which one you use depends on your plans for the server, its posts and its domain name or subdomains.

If you’re running your Mastodon server manually you can find out more about the self-destruct command in the official documentation ⧉.

If you’re running your Mastodon server through managed hosting, you cannot run self-destruct directly but your managed hosting provider should be able to. Ask your managed hosting provider for more info about the option of running self-destruct before closure.

↩ Back to the front page

How Mastodon admins can communicate with their server’s members

20 July 2025 at 13:49

If you are a Mastodon admin and you need to communicate directly with your server’s members, there are several ways you can get in touch. Different methods are appropriate for different situations, so you might want to keep all of them in mind as options.

How to message all your server’s members directly

There’s a built-in admin tool which lets you add an announcement to the top of all your members’ timelines, and also optionally email the same announcement to all of them too.

⚠ It’s worth being careful about the email option, as generally people prefer not to receive unsolicited emails except in extreme situations (such as servers shutting down etc). If you email members over non-urgent things, they may see it as spam.

  1. Log into your admin account on the server website
  2. Select ⋯ More
  3. Select Administration
  4. Select Announcements
  5. Click New Announcement
  6. Fill in the announcement text
  7. If you want to, optionally add start or end dates/times, or a posting date/time. If you don’t fill these in, the announcement will be posted immediately and remain there until you deactivate it.
  8. When you’re happy, click Create Announcement. The announcement will be posted according to the settings in the previous step. When it’s published, it will appear as a megaphone icon at the top of members’ Home timelines that they can click open.
  9. If you want to, you can optionally also send this announcement by email to all your users. In the Announcements section click on ✉ Notify Users, check the email looks correct and then click Send X Emails (where X is the number of users). Only use this option in extreme cases though.

Providing non-urgent server news for those who want it

If you want to provide regular updates about your server that aren’t urgent, you could have a dedicated public “server news” account which members can follow and/or check. Many people use the server’s main admin account for this. Whatever account you use, you can set it to be automatically recommend to new members.

Server news accounts typically post updates about things like scheduled maintenance, software updates, how to use server features etc. They can also be used to gather feedback from members about how the server is run.

Sending official warnings to members who are doing bad stuff

If there’s a member of your server who has done something bad but you don’t yet want to restrict their account, you can send them an official private warning about it.

  1. Log into your server website with your admin account
  2. Click on ⋯ More
  3. Click on Moderation
  4. Click on Accounts (NOTE: this means “Accounts” in the “Moderation” section, it is not to be confused with your own personal “Account” option)
  5. Click on the username of the member you want to send a warning to
  6. Click on Warn
  7. Tick or un-tick the box for also sending the warning by email
  8. For the text of the warning itself, you can either use an existing pre-written warning preset, or write a new one-off custom warning. Custom warnings can be written in the Custom Warning box, warning presets can be selected from the Use A Warning Preset dropdown menu. (If there aren’t any preset warnings, click on the Add Warning Presets link above the custom warning box to create one.)
  9. When you’ve finished writing or selecting a warning, click Perform Action to send the warning

If the member fails to take notice of the warning, you can escalate the moderation to restrict or suspend the account instead. These further options are shown on the same page used for sending warnings.

Contacting a specific member about something that isn’t related to moderation

If you need to discuss something with a specific member on your server but it’s not a moderation issue, you can DM them just like you would any other account.

If a member is not responding to DMs, if the matter is urgent you can find the member’s email address on their moderation accounts page. Note that this is only to be used in urgent cases related to the member’s account on your server. You should not email members in non-urgent cases.

↩ Back to the front page

Activating Referrers: How server admins can (optionally) help spread the word about Mastodon

10 July 2025 at 14:48

Web browsers can send information to websites about clicks on links to them using “Referrers”. This can help websites identify where their traffic is coming from, but it can also bring privacy risks for the people doing the clicking.

By default, Mastodon asks web browsers not to send any information at all in Referrers.

On servers running Mastodon version 4.4.0 or newer, server admins are given the option to allow referrers to send the domain of the site where the click happened (such as example.com). If an admin activates this it would show sites being clicked on that their clicks came from that server, but would not by itself give any other kind of info.

The option for referrers is off by default, it will only be active if the admin switches it on. Each server admin has to decide for themselves if they activate it.

How can a Mastodon server admin activate referrers?

  1. Log in with your admin account on your Mastodon server website
  2. Click ⋯ More (if you’re on the mobile web click ☰ first)
  3. Click Administration
  4. Click Server Settings
  5. Click Discovery tab at the top
  6. Scroll down to Privacy section and tick the box marked Allow external sites to see your Mastodon server as a traffic source
  7. Click Save Changes button at the bottom of the screen

What’s the case for switching on referrers?

By switching on link referrers, the admin will make all of their server’s clicks show up as coming from their server, and help give Mastodon visibility in click stats that it didn’t have before.

The optional referrer used by Mastodon just says the domain name of the server, it doesn’t by itself give any other information. It does not say who clicked a link, it doesn’t even say whether the person was a member of the server or a non-member who was just randomly browsing the server’s website.

What’s the case against switching on referrers?

By themselves domain referrers don’t give much information. The most significant problems come from sites that use cookies and other methods to track people across the internet. These kinds of data-hungry privacy-busting sites usually cross-reference their many different data sources to try to build up a picture of individuals they track.

If a link being clicked on belongs to a website that tracks people like this, identifying the domain in the referrer may tell the clicked site that a particular person has clicked on a link on that server’s website. They may then add this to their data on that individual.

Is there any way for individuals who don’t own servers to make their own decisions about this?

Yes. You can set your web browser not to send info through referrers at all, and this will override whatever websites or social networks tell them to do. Usually this is in the privacy settings of the browser and called something like “Strict protection” or similar.

What information does a referrer send about a click on Mastodon?

In the case of Mastodon, by default it asks browsers not to send any information in referrers.

The optional referrer setting available to admins would tell the browser to include the domain name of the server but nothing else. This is off by default.

Does one server’s decision about referrers affect clicks taking place on other servers?

No. As far as referrers go, federated posts are treated the same way as local posts, they’re all just links on the server’s website.

Why are Mastodon’s developers forcing domain referrers onto us?

They’re not, the domain referrer option is switched off by default. It’s your server admin who decides whether to activate domain referrers or not.

What about UTM codes in links? Don’t those show referrals from Mastodon? Why not just use those?

UTM codes are optional bits at the end of links that can be used to show where a click came from. However, they are relatively rare for Mastodon as they require the source of the link to include them. Also, quite often people either use another platform’s UTM code when sharing links or strip out all UTM codes completely.

HTTP referrers are more consistent in providing information about the actual source of clicks.

↩ Back to the front page

Wanderer: Recording your trails and journeys on the Fediverse

7 July 2025 at 19:12

Wanderer is a free open source Strava-style platform which lets you store records of your walks and trails online and share them with others. You can record trails directly using GPS data, or you can import existing data from Strava and Komoot.

There is more information on the official website at Wanderer.to ⧉ and there is a list of public servers you can join ⧉ on the same site. If you just want to give it a quick try there is a demo server ⧉ which automatically deletes data after people have tried it.

If you’re a techy person, you can self-host your own Wanderer server using the installation instructions here ⧉.

↩ Back to the front page

Manyfold: Organise and Share 3D Printing Files on the Fediverse

27 June 2025 at 21:23

Manyfold is a free open source Fediverse server type for 3D printing enthusiasts, which lets you upload and share 3D models for prints. It’s intended as a Fediverse alternative to Printables, Makerworld and Thingiverse. Manyfold accounts can be followed from accounts on other Manyfold servers and from Mastodon etc accounts too.

There’s an official demo server at try.manyfold.app ⧉ if you just want to test it, and there’s a full public server you can join at 3dprint.social ⧉ if you want to start a proper account.

If you’re a techy person and want to install your own server, there are instructions for self-hosting on the official website ⧉.

↩ Back to the front page

Tips for organisations joining Mastodon and the Fediverse

6 June 2025 at 20:08

If you run an organisation of any kind (non-profits, businesses, clubs etc), this guide is aimed at helping you get the most out of being on Mastodon and the Fediverse. The Fedi works a bit differently to social networks you may be used to, and has some unique advantages as well as unique challenges.

Why would my organisation want to join Mastodon? Why would I join the Fediverse?

Over the last few years, it’s no secret that centralised social networks have been degrading. Users’ privacy is being invaded, their timelines are being manipulated by opaque algorithms, and advertisements are becoming ever more pervasive.

Organisations also suffer on centralised social networks, with hidden charges just for reaching your own followers, nasty surprises from opaque algorithms, and the impossibility of getting help if there’s a technical problem. Centralised social networks sometimes delete organisations’ accounts without any explanation or right of appeal.

Mastodon and the Fediverse address all these problems both for users and organisations:

  • There are no advertisements
  • There is no algorithm
  • The network is spread across thousands of totally independent servers that talk to each other, so users can interact but the network cannot be bought out or go bankrupt
  • Each server is run by humans who are easy to reach, you will be able to discuss any problems directly with the owner
  • If you don’t like how your server is run, you can move your account to a different server without losing your followers
  • You can even set up your own server if you want total control over how your social media presence is run, it costs a few euros a month and doesn’t require technical skills

By setting up a presence on the Fediverse, you are not only helping your organisation but also helping your followers by giving them a nicer way to follow you.

What is the Fediverse anyway? How does it relate to Mastodon?

Mastodon is a type of social network that is part of a wider network called the Fediverse. If you want a really brief and easy-to-understand intro, watch this video ⧉. If you would like a bit more depth, have a look at Mastodon’s official intro video ⧉.

The Fediverse is a collection of social networks that use a common standard to talk to each other. If you’re on the Twitter-style network Mastodon you can seamlessly follow and interact with accounts from the YouTube-style network PeerTube, the Instagram-style network Pixelfed, the Goodreads-style network BookWyrm etc. Your timeline may contain posts from many different social networks, and the collective term for all of these compatible networks is “The Fediverse”.

You may find the “What is the Fediverse?” short animation ⧉ useful for understanding why the Fediverse exists, and if you want more detail there’s a Fediverse guide here.

How does my organisation get started on the Fediverse?

If you just want a general social media presence, the best-supported option is probably Mastodon, a Twitter-style social network. You can sign up on an existing server or create your own server.

If you’re specifically wanting to publish videos, you might want to set up an account on PeerTube, the Fediverse’s video platform.

How do I verify my organisation’s identity?

There are several options for accounts to get verified, see the guide to account verification for more details.

How does my organisation get more followers and interactions on the Fediverse?

If you’re already on the Fediverse, you might want to go through this checklist of ways to get more visibility for your account and posts.

Proactive organisations might want to also follow more accounts themselves.

How does my organisation let people know which account to follow?

Fediverse account addresses have two parts, the username and the server name:

@ (user) @ (server)

If you want to promote your organisation’s account, it’s important to mention both parts in any promotional material. People will be able to follow your account by putting this address into the search box on their server. More info about this on the account address guide.

Do you have more info about how an organisation can run its own server?

Yes, there’s a guide here with tips for servers run by organisations.

Where can I get more help with using Mastodon and the Fediverse?

Have a look at the front page of Fedi.Tips to see a complete list of guides to using the Fediverse.

↩ Back to the front page

How do admins moderate trends on their Mastodon server?

19 April 2025 at 20:47

If you’re the admin of a Mastodon server, there are lots of options for managing the trending posts, hashtags, links and account recommendations in your site’s trends section.

Choose your server’s overall trend settings

First of all, you have to decide whether you want to show trends on your site and whether you want to moderate them in advance:

  1. Log into your server’s website or web app with your admin account
  2. Click on ⚙ Preferences (if you’re on mobile click click ⚙ then ☰)
  3. Click Administration
  4. Click Server Settings
  5. Click the Discovery tab at the top
  6. In the Trends section, tick the boxes for what you want and un-tick boxes for what you don’t want
  7. Click Save Changes at the bottom of the screen

NOTE: It’s very very highly recommended that you do NOT tick the box marked Allow trends without prior review. Allowing unreviewed trends onto your site can cause really awful material to appear there, as trolls may try to use multiple accounts to make offensive material trend. It’s much safer to manually review trends, as the offensive stuff is never visible that way.

Manually reviewing your server’s trends

Here’s how to review the trends on your server (assuming you are using manual reviews):

  1. Log in through your server’s website or web app with your admin account
  2. Click on ⚙ Preferences (if you’re on mobile click click ⚙ then ☰)
  3. Click Recommendations & Trends
  4. Click on the trending section you want to moderate: posts, hashtags, links or follow recommendations
  5. Tick the items you want to approve or reject, then select the appropriate actions at the top as needed

Note that the post moderation lets you moderate both posts and authors, and the link moderation lets you moderate both the link itself and the website (publisher) it comes from. If you see inappropriate stuff from the same person again and again, you can save time by rejecting the author rather than just specific posts.

↩ Back to the front page

Help! I’ve accidentally blocked a server on Mastodon, what do I do now? How do I restore my follows and followers from that server?

6 April 2025 at 15:18

If you’re an ordinary user and you block an entire server on Mastodon, that removes all your follows and followers on that server and prevents you seeing anyone or any posts from that server.

(Admins have different kinds of server blocks that are more powerful.)

I didn’t mean to do it, is there any way I can get back my follows and followers from that server?

Yes, you can undo this, but it will require a bit of work.

Here’s what to do:

  1. Unblock the server. On your server’s website or web app, go to your profile page, then click the ⋯ button and select Blocked domains, then click the unlock icon next to the server you want to unblock.
  2. While still on your server’s website or web app, go to ⚙ Preferences > Follows and followers > Severed relationships (if you’re on the mobile web, click ⚙ Preferences and then ☰ in the top right corner to see the Follows and followers option).
  3. You will now see a page that lists all the server blocks that have ever caused you to lose follows and/or followers. Next to each block are download links which are downloadable files that list all the follows and followers you have lost because of that particular server block. Find the server block you did accidentally, and click the follower and follows download links for that server (there may only be one link if you only lost either follows or followers rather than both). Save these files onto your computer or phone or tablet.
  4. Go to ⚙ Preferences > Import and export > Import (mobile users click ⚙ Preferences > ☰ > Import and export > Import)
  5. To restore your follows (people you follow) from the blocked server, set the Import type as “Following list”, click Browse and select the file for the follows you downloaded in step 3 above. Then select Merge (do NOT select Overwrite!) and then click Upload. ⚠ NOTE: Seriously, do NOT select Overwrite, that would make things much worse as it would replace your current follows with just the ones you lost.
  6. To restore your followers (people who follow you), you will need to manually contact each of the followers on the followers file you downloaded and ask them to refollow you.

This looks painfully complicated! Isn’t there an easier way?

It is complicated, which is why there is a warning message before you actually block the server about how many followers and follows you will lose. (If you don’t have any follows or followers on the server you’re blocking, this message isn’t shown.)

However, perhaps there should be a more straightforward undo feature and perhaps the option itself should be more hidden than it currently is. If you’re comfortable using Github, you may want to read or contribute to an open issue about this on the Mastodon Github ⧉.

↩ Back to the front page

How do I remove followers on Mastodon without blocking them? How do I “soft block”?

5 March 2025 at 19:16

Mastodon has a “Following and followers” management section you can use to remove followers without having to block them:

  1. Sign in on your server’s website or web app
  2. Click on ⚙ Preferences
  3. Click on Follows and followers (if you’re on a phone click ☰ and then Follows and followers)
  4. In the Relationship section click on Followers
  5. Select the followers you want to remove
  6. Click on Remove selected followers

Does this block selected accounts?

No, it does not block them, it just removes them from your followers. If you block a follower, that removes their follow anyway and you don’t need to use follower management.

Why is it called “soft blocking” if it doesn’t block them?

The original way of doing this was by blocking someone to get them off your followers, then immediately unblocking them. The follower management system was introduced later.

How do I do an actual proper full block?

You can find a guide to blocking accounts on Mastodon here.

What about the other option that mentions domains?

If you click Remove followers from the selected domains, it will also remove all followers who are on the same servers as the followers you have selected. Be careful if you use this option, it may remove more followers than you expect.

What does Account Activity: Dormant mean?

It means the accounts listed haven’t posted in a while.

What does Account Status: Primary and Moved mean?

Primary accounts are normal accounts. Moved accounts are just redirecting to a different account elsewhere, and aren’t in use themselves.

↩ Back to the front page

Why is there sometimes a “More From…” section below links on Mastodon? What is “Author Attribution”?

28 February 2025 at 20:46
Screenshot of a Mastodon post featuring a link preview. Below the preview is a second link which says "More from..." and has a link to the account of the person who wrote the article being linked to in the preview.

When someone posts a website or article link on Mastodon, there is sometimes an additional section below the link’s preview which says “More from…” and has a link to an account profile (see the screenshot above for an example). This is a link to the account of the person who runs the website or wrote the article you have linked to. Click on their name to see their profile, and follow it if you want to.

This link to an account profile is also known as “Author attribution” because it is often used by people who write articles or blog posts.

Is this generated automatically?

No. The site owner or article author has to manually add a special piece of HTML code to their site or article to state their Fediverse account address (see the instructions below).

How do we know it’s genuinely their profile?

The link will only appear if the site owner or article author has both confirmed the account address on their website, and also confirmed their connection to that website in their Mastodon settings. They need to confirm at both ends or it won’t appear.

When does this “More from…” author attribution link appear?

It will appear whenever anyone posts a link to the site or article by that author on Mastodon, but it may not be visible in all apps yet as it is a relatively new feature.

I am a website owner or article author. How do I get a “More from…” link to appear underneath links to my site or articles?

Here’s a step-by-step guide:

  1. Log into your server’s website or web app
  2. Click ⚙ Preferences
  3. Click Public Profile (if you’re on the mobile website click ☰ at the top and then Public Profile)
  4. Click the Verification tab at the top
  5. Scroll down to the Author attribution section (DO NOT use the Website Verification section, that is for a totally different feature)
  6. Copy and paste the HTML code into your article or your website’s header
  7. Add the domain name of your website (or the website that carries your articles) into Websites allowed to credit you. If you’re posting on several sites you can add several domains but make sure there is only one per line.
  8. Click Save changes

If you’re an article author and are unsure how to add custom HTML, ask your website owner about it.

Can I use it with non-Mastodon Fediverse accounts?

It’s an open standard so other Fediverse platforms are free to implement it. However, it is a relatively new feature and so far it seems to just be working with Mastodon accounts.

Does this work when anyone posts the link on Mastodon? Or does it have to be the author posting it?

It works when anyone posts the link. The idea is to get more people to notice the author’s account and connect with them on Mastodon.

If there isn’t a “More from…” link, does that mean the author doesn’t have a Mastodon account?

Not necessarily. This is still a fairly new feature, and a lot of journalists and website owners that are on the Fediverse don’t yet know about this. It may take some time for every author and site owner to add the needed code to their site that allows this feature to function.

↩ Back to the front page

When I try to send a DM on Pixelfed, it says “You need to wait a bit before you can DM another account”. What do I do?

17 January 2025 at 15:25

If you’ve just joined a Pixelfed server and try to send or reply to a DM, it may display an error message saying you need to wait a bit.

Don’t worry, this error message will stop appearing 72 hours after you’ve joined the server. It’s there to stop spammers, it’s nothing personal against you.

↩ Back to the front page

How do I import my Instagram account data to Pixelfed?

14 January 2025 at 14:57

You can optionally import data from Instagram accounts to Pixelfed:

  1. Log onto your Pixelfed server’s website
  2. Click Account Settings
  3. Click Import
  4. Re-enter your Pixelfed password for security
  5. Click the Import button and select the ZIP file you got from Instagram

It says I have not been permitted to use this feature?

If you see this message, it’s nothing personal! It just means the Instagram import feature has been switched off on your server.

If a server is overwhelmed with new members, they often switch off Instagram imports to prevent the server crashing. Importing accounts takes up a lot of resources so it tends to get switched off if the server is having lots of new signups.

You might consider signing up on a different Pixelfed server if the one you are on is constantly overwhelmed.

How do I export a ZIP file of my data from Instagram?

There are various guides to exporting your data from Instagram, you can see Instagram’s own official data export guide here ⧉.

↩ Back to the front page

Can I re-use an old subdomain or domain when installing a brand new Fediverse server?

8 December 2024 at 19:03

If possible, you should avoid re-using subdomains or domains when installing new Fediverse servers. If you set up a new server from scratch using exactly the same subdomain or domain as a defunct server, this may cause technical problems when you attempt to communicate with the rest of the Fediverse.

Can I set up a new subdomain on a previously used domain?

Yes! If the subdomain is brand new, that will avoid technical problems. With a brand new subdomain, the rest of the Fediverse will immediately see it correctly as a totally new server.

Could you give an example of what to do?

If you have an old server at social.example.com and it closes down, it would be a bad idea to set up a new server with that same address. Instead, you could use a different subdomain such as social1.example.com or fedi.example.com, or whatever you want to replace the word “social”. The important thing is that it isn’t identical to the old server’s address.

Why would re-use of a subdomain or domain cause technical problems?

All Fediverse servers store data about posts and accounts they have federated with. If they already have data about posts and accounts from a defunct server, this may confuse attempts by your new server to connect using the same address. This is especially true if a username on the old and new server is identical, because they will have different keys verifying their identity.

What if I re-install a server and use the database from an old server?

If you’re re-using the database of the old server as well as re-using that old server’s subdomain or domain, then this should avoid problems because it will be technically the same as the old server, using the same keys to verify accounts.

The problems occur if you’re installing on the same subdomain or domain using a brand new database with a brand new set of keys.

What are keys?

On Fediverse servers, keys are special codes used behind the scenes to confirm that a particular account created a particular post or followed a particular other account. Users never see them, but the software that runs servers depends on them to make sure they’re talking to the right account on the right server.

If I’ve already reused a subdomain or domain, will the technical problems ever go away?

The problems may eventually go away when other servers refresh the keys they use to verify identities. However, this can take a long time, and it’s much better to just avoid these problems altogether by using a new subdomain or domain.

↩ Back to the front page

How to customise your Mastodon server’s icons and thumbnail

9 October 2024 at 19:28

Mastodon server admins can set their own icons for use on browsers and phones, as well as custom thumbnail artwork shown when the server is linked to or listed on sites or apps:

  1. Log into your server’s website or web app with the admin account
  2. Click on Administration
  3. Click on Server Settings
  4. Click the Browse buttons on the icons and thumbnail artwork and upload the images you want to use. You don’t have to upload them all, just upload what you want to customise.
  5. Click the Save Changes button at the bottom

What does “Server Thumbnail”, “Favicon” and “App Icon” actually mean in practice?

  • Server Thumbnail: The artwork which appears in link previews and in Mastodon server listings on websites and apps. It helps get across what kind of server you run.
  • Favicon: This is the icon that appears when people bookmark your server’s website on their web browser.
  • App Icon: This is the icon that appears on phones or tablets if people install your server’s website as a web app.

↩ Back to the front page

Should I publish server rules if I’m running a single-person Fediverse server?

12 August 2024 at 16:51

Yes. It’s a good idea to have some server rules on your server’s public “About” page even if you’re the only person on your server.

The reason is other server admins may often be in situations where they have to decide whether they will federate with your server, especially if they’re running allowlist-based protection on their server. Being able to read your server’s rules tells them immediately what kind of standards they can expect from your posts, and what kind of safety risks they might face federating with you.

What kind of rules should I have?

As rules on single-person servers are entirely for the benefit of people on other servers, it’s a good idea to keep them short, quick to read and easy to understand. However, they need to be specific enough to give some idea of what you consider acceptable.

For example, here are the rules on my own single-person server ⧉. You might want different rules, but whatever they are they should be equally short and easy to understand.

Also bear in mind that these are rules for your server, so it may include some rules that aren’t general statements about the wider world. You might be personally okay with the concept of advertising existing somewhere else but not on your server, so you might have a rule saying “no advertising”.

Is it enough that I say “Be nice to everyone”?

No. Different people can have totally different concepts of being nice, so it’s important to have at least some specific rules to give some indication of what you consider acceptable.

Does it have to be as detailed as rules on public servers?

No, it’s better to keep it simple. Rules on a single-person server are just to indicate to other admins what kind of content you might post. Making such rules too complicated makes it harder for other admins to quickly assess your server.

Why can’t other admins just look at my account profile?

It’s not always easy to tell from an account exactly what rules it is following. Nasty hateful accounts can also post pretty inoffensive stuff too. Rules take away the guesswork involved, and make much clearer what admins can expect from federating.

Also, many single-person servers have multiple themed accounts run by the same person, so from the outside it looks like there are several people on the server. It’s also a pain to have to browse through multiple accounts instead of a single list of rules.

↩ Back to the front page

How to export and download your Mastodon post archive

1 July 2024 at 16:03

Mastodon lets you download an archive of all the posts and media attachments you’ve ever published on your account. Here’s how to do it:

  1. Log in through your server’s website or web app
  2. Click on ⚙ Preferences
  3. Click on Import and export (if you’re using the mobile website click ☰ and then Import and export)
  4. Click on the Request your archive button. This will begin the archive creation process which may take a while, you will receive an email from your server when it is ready. You DO NOT need to stay logged in while this happens, it will happen automatically.
  5. When you’ve received an email from your server telling you the archive is ready, go back to the Import and Export page. (If you remained on the page since requesting the archive, refresh the page to show the download link.)
  6. Click on the Download your archive link and select where you want to save the file.

Does it include images etc that I’ve posted?

Yes, it includes your posts’ media attachments such as images, video, audio.

Does it include other people’s posts that I’ve boosted?

No. It’s just an archive of your own posts.

How often can I ask for an archive?

By default you can request an archive every seven days.

If I ask for another archive, does that have all the posts or just the ones since the last download?

Every archive has all the posts you’ve ever created.

This doesn’t include deleted posts though, these are actually deleted from the server, so if you’ve deleted posts since your last archive download they will not show up on newer archives.

How long is the archive available to download?

By default the archive is available to download for seven days, but different servers may have different download periods. Generally it’s a good idea to download it the same day that it is ready.

If the archive disappears before you downloaded it, you can request that the server creates the archive again.

How often should I download an archive?

It’s totally up to you, some people never download them while others do it regularly.

Is this the same thing as transferring your account?

No. Account archives are totally separate from the account transfer system. They use different files and do different things. The only connection between the two is that they’re both done through the Import and export page.

Diagram of the import and export page, with the links used in account transfers at the top and the link for the archive at the bottom, with a bright red dividing line separating the two.

How do I view the archive?

This is a very good question! The Mastodon developers have provided no official way to view post archives. There are unofficial third party archive viewers, but these usually require a lot of technical knowledge to install and use. Here are some links to third party archive viewers:

Can I upload my post archive to my new account on another server?

No. The archive system is totally separate from the account transfer system, and the archive is NOT used in transferring accounts. The archive is mainly intended for your own personal records, so that you have a private offline copy of your posts and attachments.

There are no Mastodon servers which allow uploads of archives. If you attempt to upload it during an account transfer, it will just give you an error message.

I thought some servers allowed you to upload your archive so you could transfer your posts?

There have been some non-Mastodon Fediverse servers which have allowed uploads of Mastodon archives in order to “transfer” posts, but these clone the post archive as a set of totally new posts which look identical to the old posts but have none of the replies or shares of the old posts. This takes a lot of resources on servers, as it requires creating perhaps thousands of new posts all at once for everyone who uploads their archives, which can really slow the server down. This is possibly why Mastodon doesn’t allow it.

So, if I transfer my account to another Mastodon server, what happens to my old posts?

Your old posts remain on your old account, but the old account’s posts will redirect people to your new account. For example, if someone finds an old post of yours and clicks on the account name to see who wrote it, they will be directed to your new account.

Can I upload my post archive to my own server if it has technical problems and loses my posts?

Another really good question. As far as Fedi.Tips is aware this has never been done. Whether it’s possible or not is unclear.

↩ Back to the front page

Mbin: Reddit-style discussions and link sharing

28 June 2024 at 17:18

Mbin is a Fediverse platform for threaded discussions in the style of Reddit and similar link aggregators. It’s still in early days, so the official Mbin documentation is aimed at techy people ⧉, but hopefully they will create a website for ordinary users soon. Techy people might also want to look at the Mbin source code ⧉. If you just want to see an example of what Mbin looks like, there’s a major server at Fedia.io ⧉ (but please bear in mind I can’t guarantee how reliable this is as the platform is still being worked on).

Wasn’t this called Kbin before?

Mbin is based on an earlier project called Kbin which had a different lead developer. The original Kbin project stopped development, but Mbin carried on and built upon the work of Kbin.

↩ Back to the front page

What are mentions on Mastodon? What does @-ing mean?

18 June 2024 at 23:09

The word “mentions” on Mastodon and other social networks means typing @ and then a username, so that the username appears in your post. It’s also known as @-ing (pronounced “at-ing”) a person.

When you type @ and then begin typing the username, Mastodon will automatically suggest accounts that you can select if you want. You don’t have to accept these suggestions though, you can keep typing, and the suggestions will change as you type. The ultimate aim of a mention is to get an account’s complete Fediverse address to appear in the post. If the Fediverse account address you want isn’t in the suggestions, just ignore the suggestions and type the account address in full.

Why would I want to mention an account?

Mentioning an account can be useful for several reasons on Mastodon and the Fediverse:

  • Mentions cause a notification to appear in the account’s notifications section, so the account’s owner will know they have been mentioned.
  • It means other people reading the post will be able to click on the account’s mention which will take them to the account’s profile page. They will then know exactly who you are talking about, and perhaps follow them or interact with them in some way.
  • The “Mentions”/”Specific People” post visibility setting means only people mentioned in the post can see it. Have a look at the post visibility guide for more details.

Can I just mention Mastodon accounts? Or can I mention other Fediverse accounts as well?

You can mention any type of Fediverse account. All Fediverse accounts use the same address format of @ (user name) @ (server name).

Most Fediverse account types do notify the account owner if you mention them, but a few (PeerTube for example) do not have a notification system for mentions.

I tried to mention an account but it didn’t work. What went wrong?

If you can’t get a mention to appear properly in your post, hopefully one of these suggestions might help:

  • Are you using the correct Fediverse address for the account you want to mention? You can find the account’s address on their profile page.
  • Did you include the @ symbol at the start of the address? All Fediverse addresses begin with an @
  • Sometimes servers have trouble with mentions for accounts they have never “noticed” before. To solve this, copy and paste the account’s Fediverse address into the search box on your server. After you’ve done this once, mentioning the account should start working and the account should start appearing in the suggestions when you’re typing a mention too.
  • If the account is on a server that your server has defederated, you will not be able to mention them.

Where can I see when I am mentioned by other people?

Mentions will appear within your normal notifications in Mastodon. If you want to see just your mentions without the other notifications, go to the 🔔 Notifications section and click the Mentions tab at the top of the screen.

If you do click the Mentions tab, remember to switch notifications back to the All or Everything tab afterwards if you want to keep seeing other types of notifications. If you don’t do this, you will still get beeps for other types of notifications but you won’t see what they actually are.

I mentioned an account but it appears in the post as a short name instead of a full address. What’s happening?

Fediverse addresses all have two parts: the username and the server they are on (similar to how email addresses are written). For mentions to work, you need to include the full Fediverse address with both parts.

However, for the sake of readability, when the post is published Mastodon usually hides the second part of the address. The second part is still there underneath the surface, and if you click on the mention it will take you to the account’s profile page.

Some mentions have their addresses written in full, while most are shortened. Why is this?

Every account on the Fediverse has a unique Fediverse address, but accounts on different servers may have the same username or first part of the address. This is similar to how in real life people might have the same first name but different surnames.

If two accounts with the same username are mentioned in the same post, then when the post is published the account addresses will be written in full. This is similar to how a real life conversation might mention people’s surnames if they have the same first name, to help distinguish between the two.

I tried to mention an account but it keeps abbreviating it to @example instead of @example@server. Why doesn’t it let me write the full address when I’m editing the post?

If you’re mentioning an account on the same server as you are, then it will by default just show the first part. The second part will be automatically added for anyone viewing the post from another server.

This is similar to how traditional landline telephones allow you to dial a phone number without the area code if you are in the same area.

Can I edit a post to add a mention later?

Yes and no.

You can edit a post and add a mention, but the mention will not generate a notification and it will not make a mentions-only post visible to any mentions that are added by editing.

If you want to get someone’s attention or make a post visible to them, it is better to write a new post from scratch and mention them in it.

↩ Back to the front page

Desktop apps for Mastodon

4 June 2024 at 23:33

There are a number of options if you want to use Mastodon on a computer.

Mastodon’s website

The website version of Mastodon is excellent, and it tends to get all the latest features first. You can be logged in on multiple accounts on multiple servers at once, and there’s also an optional Tweetdeck-style mode.

Third Party Apps

Here are some currently-supported third party desktop Mastodon apps, along with which types of computer they support:

Retro Apps

Many old computers from the 1980s and 1990s have Mastodon retro apps available.

↩ Back to the front page

What are notes on Mastodon? What does “Click to add note” mean on Mastodon profiles?

30 May 2024 at 17:45

If you’re browsing a profile on Mastodon’s website or web app or some app store apps, you might see an option that says “Click to add note” or something similar. This is a potentially very useful feature, but it isn’t very well known so most people don’t use it.

What does Notes do?

The Notes feature lets you add private notes to anyone’s profile. Just click on it and type, it will save your notes automatically.

Who can see these notes?

Only you can see these notes. They are stored on your server and aren’t sent elsewhere.

How do I save a note? There’s no save button!

Just click somewhere outside the note, it should automatically save it.

Why is it showing me the old version of a note?

There’s a bug in the current Mastodon software which means you may see an old version of a note displayed even after you’ve edited and saved it. Just refresh the page to see the latest version of the note. This bug will be fixed in the next update of Mastodon.

Why would I want to use notes?

Mastodon’s Notes feature can be useful when dealing with large numbers of people on the Fediverse, where you want to instantly see info about how they relate to you or how you relate to them.

For example if you’re working with a group of people on a collaborative project and you want to keep track of who is doing what, you can add their role to your notes on their profile.

Many people use it to keep track of why they might have muted or blocked someone.

Another example: I use notes a lot on FediFollows ⧉, FediVideo ⧉ and FediGarden ⧉ to keep track of which accounts or servers I’ve featured and when. This helps me avoid featuring the same accounts too often.

What happens to notes if the person transfers their account to another server?

If the person you wrote notes about migrates their account to another server, your notes will automatically appear on the profile of their new account (along with a message saying that they were transferred from the old account).

What if I transfer my account to another server? Do my notes about other people come over to my new server?

No, unfortunately not. There’s currently no way to export and import notes you’ve made about other people, so you would have to manually copy notes over to your account on your new server.

↩ Back to the front page

I can see a reply in my timeline on Mastodon but I don’t know the context. How do I see the discussion it belongs to?

16 May 2024 at 19:00

Just click on any post or reply to be taken to the original discussion thread it belongs to. This will show you the original post and its replies.

Is there any way to see the most complete version of the thread?

Because of the way servers federate together, your server may not always show all the replies in a conversation thread. You can see the most complete version of a thread by using original pages:

  1. Click on the first post of the thread, at the very top
  2. Click on ⋯ for the first post of the thread
  3. Select the option Open original page, which will open the thread on the website of the poster’s server

↩ Back to the front page

What are Hashtags? How do I use them on Mastodon and the Fediverse?

11 May 2024 at 20:06

Hashtags are words or phrases with the # symbol at the start. They are used in social media posts to indicate the topic of the post, and they make it easier for people interested in that topic to discover relevant posts.

To use a hashtag, just include a word or phrase with # at the start in your post. For example, if you were writing about gardening you might include the hashtag #Gardening in your post.

Hashtags are also sometimes just called “tags”. Hashtags and tags are the same thing.

How do I use more than one word in a single hashtag?

If you want to include more than one word in a hashtag, write all the words together without spaces, but with capital letters at the start of each word. For example if you were posting about dogs at polling stations the hashtag would be #DogsAtPollingStations

It is REALLY important to make sure the first letters of each word in a hashtag are capitalised, because they make your hashtag accessible to blind people. Blind people use the internet through special apps called screen readers which read out loud whatever is on the screen. By capitalising the first letter of each word, it makes it possible for the screen reader app to know how to pronounce the hashtag. (If you don’t capitalise words, phrases can sound like meaningless gibberish read out loud.)

Capitalising the first letter of each word also makes your hashtag much easier to read for sighted people!

Capitalising the first letter of each word in a phrase without spaces is commonly known as CamelCase because it resembles the humps of a camel. 🐫

How do I search for posts with particular hashtags?

Just type the hashtag you want into the search box on Mastodon etc. This will bring up a list of suggested tags that match your search, along with little charts to show you which ones are trending right now. Click on the exact tag you want, and it will show you the latest posts using that tag.

Can I follow hashtags like I follow accounts?

Yes! On Mastodon and many other Fediverse server types you can follow hashtags so that posts with that tag automatically appear in your Home timeline, even if you’re not following the author. Click here for a guide to following hashtags.

How do I see a list of trending hashtags?

On Mastodon you can see trending hashtags through your server’s Explore feature, which is often just labelled “Trending” on many apps. This will show you trending tags on the Fediverse as seen from your server.

If you want to see trending hashtags across a much wider range of servers, there are sites like Fedi.Buzz ⧉ which show them.

I couldn’t find any results for a hashtag, what do I do?

It might be that you picked a less common version of that hashtag. Try browsing all the tag suggestions that appear when you search for the hashtag. There should be some kind of chart next to each suggestion to let you know which version of the tag is currently trending.

If you still can’t get any results, you might want to follow a group instead. For various technical reasons, groups cause posts to spread (or “federate”) more widely on the Fediverse than hashtags. Click here for a complete guide to using Fediverse groups.

Why do my hashtags disappear if I write them at the end of a post? How do I make my hashtags appear as small print below my post?

If you write hashtags below a blank line at the end of a post, they will automatically be shown below your post in a separate section with a different and smaller font. This is purely for aesthetic reasons to make the post easier to read, it doesn’t affect how the hashtags work. (This happens in Mastodon and some other Fediverse platforms.)

Note that for the hashtags to be displayed separately from the main body of the post, you do need to include the blank line break before the list of hashtags. Also note that some third party apps may not support displaying tags as small print, but in that case they will simply show them as normal tags at the end of the post.

Alternatively, If you prefer you can include hashtags within the body of the post itself. It won’t affect how they function.

Should I write hashtags within the post or at the end?

There are differing opinions on where hashtags belong:

  • At an aesthetic level it is up to individuals what they prefer.
  • At a technical level it makes no difference whether you include a hashtag in the middle of your post or at the end of it, the tag itself behaves exactly the same way wherever you include it in the post.
  • At an accessibility level there have been contradictory reports about which option is easier. (For whatever it is worth, here is an online survey of screen reader users to ask which they prefer ⧉.)

So… it’s your call where you want to place tags in your post!

How do I know which versions of hashtags I should use? How do I find out which tag is most commonly used on a topic?

Screenshot of the search results on Mastodon for the hashtag #Climate, showing variations of it such as #ClimateCrisis, #ClimateChange etc along with information on how often these tags have been used recently.

You can use multiple hashtags if you want, but if you’re short on space and want to choose just the most common one, try doing a search for the hashtag. Mastodon will show you the most popular variations on that hashtag.

In the example above, searching for #Climate on Mastodon shows the most popular similar hashtags.

How do I write hashtags for years? Why can’t I write hashtags that are all numbers?

For hashtags about particular years write the word “year” before the number, for example #year1996

Hashtags that are entirely digits with no letters will not work on Mastodon. This is because there was a request from the community to prevent this ⧉, as some people wanted to use the symbol # to indicate numbers rather than hashtags.

However, more recently there has been a counter-suggestion to allow all-digit hashtags ⧉. The developers have not so far done this, but if you’re comfortable using Github you can give this suggestion a thumbs up if you want it to happen.

I’ve published a PeerTube video, how do I add multiple hashtags to it?

The tags section on PeerTube’s publishing system can be slightly confusing as it needs you to press the enter key after each separate hashtag.

To add a tag on PeerTube, type a word or phrase into the “Tags” section of your video’s publishing form, and make sure you press enter after each separate tag. If you just use spaces or commas, it won’t separate the tags out.

I am a computer programmer and I have to say this article misuses words! It is not CamelCase, you are talking about PascalCase! And you should be writing camelCase with a small c at the start!

The terms “PascalCase” and “camelCase” (with a small c at the start) are used in computer programming, and this has caused some confusion when the term “CamelCase” (starting with a large C) is used to describe hashtags.

Programmers are rightly very precise about language as even one misspelling will break software. However, this website is not about writing software, and the use of the expression CamelCase when discussing accessibility is intended for a general non-technical audience.

For ordinary everyday language, the expression CamelCase (with a capital C at the start) works much better because:

  • “CamelCase” makes it obvious that the starting letter of each word is capitalised
  • “CamelCase” is much easier to remember than “PascalCase”
  • Camels have humps and everyone knows what a camel looks like 🐫
  • The word Pascal is relatively obscure in the non-programming, non-mathematical world
  • The spelling “camelCase” (starting with a small c) doesn’t make it clear that every word starts with a capital letter

Programming is important, but technical terms have a particular context that doesn’t always overlap exactly with the needs of everyday language.

↩ Back to the front page

Does Mastodon and the Fediverse use algorithms? Does it push stuff at me based on my interactions?

2 May 2024 at 21:21

No. There is no algorithm on Mastodon or other Fediverse server types. You can like and follow and share stuff freely without having to worry about it affecting what appears in your timeline.

Your Home timeline simply shows all the posts and all the shares from all the accounts, groups and hashtags you follow, in chronological order. The timeline doesn’t hide stuff or suggest stuff or move stuff about.

My timeline is way too full now! How can I trim it down without an algorithm?

You can split your Home timeline into themed mini-timelines using Mastodon’s Lists feature, which lets you add accounts to separate timelines and then optionally hide those accounts from your Home timeline.

There are some accounts that I MUST see the posts from. How do I make sure I don’t miss what they post?

Click the bell icon 🔔 on an account’s profile, and you will get an extra notification every time they post (and of course their posts will be in your Home timeline as usual).

There are some accounts and topics I MUST NOT see. How do I stop them appearing in my timeline?

You can block and mute accounts so that you don’t see them in your timeline. You can hide posts that use particular words or phrases by using the filter system.

I follow an account that boosts way too much! How do I stop seeing their boosts without hiding their own posts?

If there are accounts you follow that boost too much, you can hide an account’s boosts without hiding their own posts.

But there’s a column of suggested accounts to follow labelled “For You”! Isn’t this an algorithm?

No, it’s just a list of accounts that are most followed and boosted by people on your server. The same accounts are suggested to everyone on your server, but it automatically hides accounts you are already following (which is where the “for you” name comes from).

Actually, at a technical level, “algorithm” can mean any set of computing instructions. So of course Mastodon uses an algorithm, so do all computers and websites!

That’s not what most people mean by the word “algorithm”. To most people, especially non-technical people, algorithm means a weird hidden thing that messes up their timeline based on what they have previously interacted with.

If algorithm meant any kind of computing instruction, then it would be a useless word when trying to discuss the problems of manipulative black box code.

The “quiet public” post visibility setting on Mastodon’s website talks about “Fewer algorithmic features”. Doesn’t that mean Mastodon uses algorithms?

No, it’s just a badly written description that is trying to fit a long series of sentences into three words. The only actual effect of using quiet public visibility (aka unlisted visibility) is that it doesn’t show up in searches or trends or Federated or Local timelines.

Aren’t the trending posts sections a form of algorithm?

The trending posts sections of Mastodon just show new posts that have received a lot of boosts. There’s no weirdness or black box code or promotion going on, their mechanism is extremely simple and visible in Mastodon’s source code.

↩ Back to the front page

Is Mastodon compatible with rich text formatting such as Markdown?

1 May 2024 at 21:18

This is slightly complicated to answer!

Standard Mastodon doesn’t let users create rich text posts, but it does display rich text posts if they are created on other Fediverse platforms.

There are also non-standard versions of Mastodon which do let you create rich text posts, such as the fork Glitch Mastodon ⧉ (however, not every Glitch server has rich text posting active, you would need to ask a particular Glitch server’s admin if they have it switched on).

There are also standard Mastodon servers that have been manually customised by their admins to allow rich text or other unusual formats such as LaTeX ⧉ (an example of a server with LaTeX is mathstodon.xyz ⧉).

What kind of rich text can standard Mastodon display?

Standard Mastodon will display the following kinds of post formatting: bold, italics, strikethrough, ordered and unordered lists, blockquotes, inline code, fenced code blocks, headers. Headers are displayed as bold text in a separate paragraph.

What kinds of rich text can standard Mastodon create?

None. As mentioned above there is currently no support for posting with rich text on standard Mastodon.

What kinds of rich text can Glitch Mastodon create?

The unofficial fork Glitch Mastodon ⧉ can display and create headers, bold, italics, strikethrough, blockquotes, inline code, code blocks, subscript, superscript and lists. These can be written in Markdown or HTML, and there are more details of how it works here ⧉.

Where can I find a Glitch Mastodon server to join?

There’s a short list of well-run Glitch servers in the Glitch section of fedi.garden ⧉. However, bear in mind they may not all have rich text activated. Ask their admins if you’re unsure.

Standard Mastodon supports showing rich text, so why doesn’t it support creating rich text?

It’s surprisingly difficult to locate the answer, as the topic has been discussed in various different threads on the official Mastodon Github, framed in slightly different ways so that the discussions aren’t always comparable. It seems to have just never been a priority for the developers, it wasn’t seen as crucial.

How do I ask the Mastodon developers to add rich text creation as a standard feature?

If you want standard Mastodon to support creating posts with text formatting, and if you’re comfortable using Github, the best way to let the developers know is probably to give a thumbs up in in this open issue ⧉.

What is rich text? What is Markdown?

Rich text means stuff like underlining, bold text, italics, strikethroughs etc, where ordinary text has additional formatting added to it. There is a popular open standard for creating and editing rich text called Markdown ⧉, but other standards exist too.

↩ Back to front page

Don’t use flashing images or emoji!

16 April 2024 at 16:43

⚠ Please don’t use flashing images or animations in posts or profiles! This includes attachments and emoji, anything which produces a rapid series of flashes. Flashing images can be dangerous to people with certain neurological conditions ⧉, and it makes your post or profile inaccessible to them.

If you absolutely have to post something containing flashes, hide it behind a content warning which says that it contains flashes.

Is there any way I can prevent animated GIFs from playing automatically?

If you’re using the Mastodon web interface, you can optionally prevent animated GIFs from automatically playing:

  1. Log in through your server’s website or the web app
  2. Click on ⚙ Preferences
  3. Scroll down the page and UN-tick the box Auto-play animated GIFs
  4. Click the Save Changes button

Some apps may also have options for this, check their settings menus.

But if people can switch off autoplaying of GIFs, why does it matter if I use flashing images?

It matters because a lot of people may not be able to prevent autoplay:

  • Some people may be viewing your public posts or profile through your server’s website, they may not even be members of the Fediverse. A lot of content on Mastodon and the Fediverse is shared elsewhere through web links.
  • Some people use non-Mastodon platforms which lack options about autoplay.
  • Some people are on Mastodon apps which lack options about autoplay.

↩ Back to the front page

Blocking and Muting Servers on Mastodon

9 April 2024 at 21:26

(If you want to block or mute individual accounts, please see the Blocking and Muting Accounts on Mastodon guide.)

Ordinary individual users do not have any means to block entire servers on Mastodon. The only people who can block servers are the server admins, through a process called defederation.

But what about the “block domain” option? Doesn’t that block servers?

If a user goes to a profile or post and clicks on the ⋯ button, this does bring up an option called “Block domain” which sounds like it would block a server. However, this option just mutes the server, it hides the server’s posts from you but does not hide your posts from the server.

So, if I’m concerned about a particular server, how do I block it?

If you’re an ordinary user, you have two options if you want to cut off communications with a specific server:

  • Talk to your server’s admin and convince them to defederate the server you are concerned about.

OR

If I move to another server, how do I find out if it blocks the server I’m worried about?

To see a server’s defederation list:

  1. Go to its website and click Learn More or ⋯, which takes you to its info page.
  2. Scroll down the info page until you get to the section marked Moderated Servers, and click this to open it.
  3. Scroll down the list until you get to the server you’re worried about. If it says “suspended” next to its name, that means the server has been defederated.

Note that for safety reasons some servers hide their defederation list, or obfuscate the names. If you are unable to see the defederation list, try messaging the server’s admin to ask if they have defederated the server you’re worried about.

↩ Back to the front page

How to manually add a book on BookWyrm

9 April 2024 at 01:30
Screenshot of search results on BookWyrm, with the "manually add book" link highlighted.
Screenshot of search results on a BookWyrm server, with the “Manually add book” link highlighted

BookWyrm has a built-in catalogue of books, which is based on open data from WikiData ⧉ in collaboration with Inventaire ⧉. This data is collaboratively written by volunteers, just like Wikipedia, so it is huge but does also have gaps.

If you can’t find the book you want, you can manually add it to BookWyrm by doing the following:

  1. Log in on your BookWyrm server and search for the book you want in the search box at the top of the screen.
  2. If you can’t find your book in the results, click the link at the bottom of the screen to include results from catalogues on other BookWyrm servers. This will give you even more search results.
  3. If you still can’t find your book, click on the Manually add book link at the bottom of the screen below the second set of search results.

Why is it so awkward? Why do I have to search first?

The idea of this setup is to discourage people from manually entering the details of books that are already in the catalogue. Duplicates cause headaches for other people trying to choose particular books, because they don’t know which one of the duplicates to select. By reducing the number of duplicates, the catalogue is kept easier to use.

Can I import book lists into BookWyrm from other sources?

Yes, if you have an existing account on Goodreads, LibraryThing, StoryGraph, OpenLibrary or Calibre you can import your book lists into BookWyrm.

↩ Back to the front page

Mastodon admins: Leave the “content cache retention period” blank!

11 March 2024 at 17:40
Screenshot of Mastodon admin settings page, with the content cache retention period setting highlighted and a bold caption saying Leave This Blank!

⚠ If you’re the admin of a Mastodon server, you might have noticed a server setting called “content cache retention period”. Do NOT put any numbers in this, just leave it blank!

What happens if I put numbers in there?

It will start permanently breaking threads on your server that are older than that number of days, without any possibility of restoring them. This setting is not really a cache, because there’s no way of getting the content back later.

Whaaat? Why does this setting even exist?

Apparently it was only intended for announcement servers which wanted to avoid data retention for legal reasons. It isn’t intended by the developers for use on ordinary servers.

So why is such a dangerous and niche setting included on normal servers if it’s not intended for normal servers?

Really good question, it probably shouldn’t be there as most admins will never need it and won’t realise the damage it causes. There is a pull request on Github to move it into a separate “danger zone” section ⧉, which includes technical discussion of the situation.

What about the other settings on the same page, can I use them?

Yes, the other settings are okay to use. It’s just the “content cache retention period” one that needs to stay blank.

Can I set the “Media cache retention period”? Can I set the “User archive retention period”?

Yes, it’s fine to set time limits on the media cache and user archives, because they can be reloaded if needed. It’s only the “content cache” that you need to avoid, because the content it deletes cannot be reloaded.

↩ Back to the front page

How do I check which version of Mastodon is running on a server? What are Mastodon forks?

25 January 2024 at 16:59

Each server is totally independent, and does updates on its own schedule. You may want to check which version of Mastodon a server is running, as this can let you know whether a new feature is available on that server. To check a server’s version:

  1. Go to that server’s website (you don’t need to log in)
  2. If you’re on the desktop website, the server’s Mastodon version will be written at the bottom left corner of the screen. If you’re on the mobile website, click the ⋯ icon and scroll to the bottom of the page.
  3. The version number will look something like “v2.2.4” or similar. It may have some extra letters if it’s a customised or experimental version of Mastodon, but the numbers should indicate which version it is based on.

How do I find out the latest version number for Mastodon?

The Mastodon developers’ Github page has the latest version number written at the top of its releases page ⧉.

(If you’re technical that page also lets you browse through the details of the latest version, but you don’t need to do this.)

The server has “glitch” or “hometown” written on its version number. What does this mean?

Mastodon is free open source software, which means anyone with the necessary programming knowledge can create their own customised version, known as a “fork”. Two of the most popular and well-established forks are Glitch Mastodon ⧉ and Hometown Mastodon ⧉. If you see these names in the version number, it means your server is running one of these forks.

There’s nothing wrong with a server running on a fork of Mastodon, in fact it often brings more features. Forks and originals aren’t rivals or competitors, they can contribute to each other in both directions. Many features of standard Mastodon originally appeared on the Glitch fork. Whichever fork your server is running, it’s still compatible with standard Mastodon and you’ll be able to follow and interact with people from standard Mastodon servers.

Standard Mastodon is often called “Vanilla Mastodon” to distinguish it from Glitch Mastodon, Hometown Mastodon and other forks.

The server’s version number has lots of letters and numbers and the word “alpha” or “beta”. What does this mean?

There are always two latest versions of Mastodon: the stable release version and the experimental version.

The vast majority of servers run the stable release version, as it has been extensively tested and is known to work well. However, some servers prefer to have the very latest cutting edge experimental features, and they will run the experimental version which is usually labelled differently. In software development, the words “alpha”, “beta” and “nightly” usually indicate an experimental version that isn’t yet ready for release. Experimental version numbers may look even more complicated such as “alpha.0+pr-28693-384ec56”.

If your server is running a test version of Mastodon, you will probably see new features ahead of servers running the release version. However, features on the experimental version may disappear without warning, or not work properly, or break other features, and that’s why most servers use the release version instead.

↩ Back to the front page

How do I get a link preview to appear in my post on Mastodon?

19 January 2024 at 21:56
Screenshot of a post from Mastodon with a link in the body of the post and a link preview below the post. The preview has a short text description of the site being linked to, and there's an image in the preview taken from the header of the site being linked to.

Link previews are little boxes of information about a website link, often including an image and short text description, which appear below a post that includes that link.

To make a preview appear in your post, just include the link in the post. You don’t need to do anything else, because the link’s preview will be automatically generated.

Why doesn’t the preview appear when I include a link?

It may take some time for the preview to appear as it’s your server which does the generation, and it may have a queue of other tasks to deal with first. If you go back to the post later, the preview should be visible.

Why do previews sometimes look different on different servers?

At a technical level, previews are generated by the server of the person viewing a post, so people from different servers may see slightly different previews, depending on which version of Mastodon (or other Fediverse software) their server is running.

Why do some previews have pictures while others are just text?

Previews are generated based on the settings of the website being linked to. If the website doesn’t have any settings for preview images, the previews in links to that site will just be text.

I run a website, how do I add settings for preview images and descriptions?

Mastodon uses Open Graph information to generate previews. Website owners can include Open Graph code to provide information about their site.

Here are some examples taken from the Wikipedia article on the Open Graph Protocol, you can put them in the header of your site:

<meta property="og:title" content="Example title of article">
<meta property="og:site_name" content="example.com website">
<meta property="og:type" content="article">
<meta property="og:url" content="http://example.com/example-title-of-article">;
<meta property="og:image" content="http://example.com/article_thumbnail.jpg">;
<meta property="og:image" content="http://example.com/website_logo.png">;
<meta property="og:description" content="This example article is an example of OpenGraph protocol.">

You don’t need to include all these tags, just the ones you want to include info about. For example if you want images in your preview, you should include the image tag with a link to the image you want to appear on a preview.

↩ Back to the front page

How do I stop receiving email notifications from Mastodon?

12 January 2024 at 19:15

Mastodon sometimes may send you emails when certain things happen on your account. You can switch off these emails by doing the following:

  1. Log in through your server’s website or through the web app
  2. Click on ⚙ Preferences
  3. Click Notifications on the left of the screen (or on the mobile site click ☰ and then Notifications in the menu)
  4. UN-tick all the boxes in the section marked Events for e-mail notifications
  5. Click the Save Changes button at the top of the screen

This won’t affect notifications you get within Mastodon itself, it just switches off the emails.

↩ Back to the front page

Using Mastodon on retro computers

31 December 2023 at 00:15

There are many retro computing apps / clients available which let you use Mastodon through classic hardware from the 1980s and 1990s:

APPLE IIMastodon for Apple II ⧉
APPLE MACINTOSH (Pre-OS X)Macstodon ⧉
COMMODORE 64MOStodon ⧉
COMMODORE AMIGAamidon ⧉
MS-DOSDOStodon ⧉
MVSBREXXTODON ⧉
PALM OSHeffalump ⧉
WINDOWS 95Mastodon for Workgroups ⧉

↩ Back to the front page

How to install Web Apps for Mastodon and the Fediverse

30 November 2023 at 18:13

Most people think about websites and apps as being two separate things. However, some websites are specially written to function pretty much like apps, and you can even install these sites as apps with their own icon. You don’t need to go through any app stores, you can install them directly from your web browser.

These kinds of special installable websites are called “web apps”. Web apps are so sophisticated nowadays, many of the apps you install from app stores are actually web apps.

The websites of Mastodon servers and other Fediverse server types such as Pixelfed, PeerTube, BookWyrm etc can be installed as web apps on your phone or tablet. Scroll down this page to see a list of the Fediverse server types that support web app installation.

Should I use app store apps or web apps?

In most cases it’s just a matter of taste!

For example, Mastodon has lots of official and third party app store apps, but many people prefer the Mastodon web app as it tends to get features before the app store apps. The web app has also been in development for longer than any other Mastodon app, so its features tend to be well-developed and mature.

However, some Fediverse server types (such as BookWyrm for example) don’t have app store apps at all yet, so the web apps are their only app.

How to install web apps on Android phones and tablets:

  1. Open your Android phone or tablet’s web browser and go to your server’s website
  2. Open the browser’s options menu (usually ︙ in top right corner of screen)
  3. Click on Install app
  4. It will ask for confirmation of the installation, click Install
  5. An icon will appear on your home screen, click on this and log into your account

How to install web apps on iPhone and iPad:

  1. Open the Safari web browser and go to your server’s website
  2. Click the Share icon at the bottom of the screen (it looks like a box with an arrow pointing upwards)
  3. Scroll down through the options and click on Add to Home Screen
  4. Give the name you want for the icon and confirm the installation by clicking on Add
  5. An icon will appear on your home screen, click on this and log into your account

Do I get notifications for web apps? How do I control the notifications?

Yes, web apps nowadays support notifications.

Once you’ve installed the web app and you’ve logged in, your phone or tablet may ask if it’s okay to show notifications for the web app, if you want notifications you should say yes to this. You can also set notifications for the web app in your phone or tablet’s notifications settings section.

Which Fediverse server types can be installed as web apps?

You can install web apps for most Fediverse server types including:

BookWyrm
Friendica
Funkwhale
Mastodon
Mobilizon
OwnCast
PeerTube
Pixelfed
WriteFreely

Isn’t this just a bookmark? What’s the point of this?

Web apps are slightly different to bookmarks.

Installation won’t work for all websites, it will only work for those specifically desgined to be web apps. If you try to install non-app websites on your home screen, either the installation option will just not be there, or they will produce an icon but that icon will just open the site in a web browser exactly like a bookmark.

Web apps work a bit differently when they are added to your home screen, they hide the browser’s interface and let you just use the web app’s own interface. At a technical level they are still working through the browser, but in practice using a web app is pretty much like using an app. As noted above, many of the apps in app stores are actually web apps.

By adding web apps to your home screen, it means you can install Fediverse platforms that aren’t on app stores yet (such as Pixelfed or BookWyrm). Even on platforms that do have separate apps, such as Mastodon, many people prefer the web interface so they use the web app.

My iPhone/iPad calls these bookmarks?

Parts of the iPhone/iPad interface do refer to web apps as bookmarks, but web apps behave differently to bookmarks. Normal websites open in the browser just like bookmarks with the browser controls visible, but installed web apps hide the browser controls and the entire screen is devoted to the web app.

What are Progressive Web Apps / PWAs? What are Web Clients?

You might hear web apps referred to as Progressive Web Apps or PWAs or Web Clients. These are all pretty much just different names for the same thing.

↩ Back to the front page

How can organisations or groups run a Mastodon server?

28 November 2023 at 04:27

Running any kind of social media server is a big topic, especially if it’s a jointly-owned server run by a group, collective, business etc.

The legal side of things depends on where your organisation is based and what your organisation’s existing structure is. Your local laws will provide various options for joint ownership structures, for example co-operatives are popular in many countries. Usually a Mastodon server can be jointly owned and managed just like anything else that belongs to your organisation.

How does joint management of a Mastodon server work in practice?

Many people can jointly run a single Mastodon server by using the “roles” system, where accounts are assigned special privileges by the owners of the server. These privileges allow staff to do things that ordinary members can’t do, for example delete posts or block users. Different roles have different amounts and types of privilege.

There are a number of pre-made roles (Owner, Admin, Moderator) but completely new roles can also be created with highly customised sets of abilities. The “Owner” account is the highest-ranked role and has the final word on everything, so this is normally given to people most trusted by your organisation. You can assign several accounts as owners if you want.

If your organisation needs a hierarchy, there is an optional priority system for roles so that if two staff members disagree on certain actions, the higher priority role gets the final decision.

The profiles of staff carry a special badge with their role name, so everyone on your server can see that they are staff.

How to give a server member a special role

  1. Log in through an account that has the power to assign roles. Owners can assign any role, other staff members may also be able to (depending on what privileges they have been given).
  2. Go to Preferences > Moderation > Accounts
  3. Click on the member you want to assign a role to
  4. Scroll down to the Roles section of the page and click on Change role
  5. Select the correct role and click Save changes

How to adjust existing roles or create new roles

  1. Log in through an account with power to create roles (usually Owners)
  2. Go to Preferences > Administration > Roles
  3. To edit an existing role click the Edit button next to it, to create a new role click the Add role button at the top of the screen

Note that there are a lot of differnet abilities that can be assigned to roles (see below). You may want to err on the side of caution and only assign abilities that you’re totally sure you want them to have.

Screenshot of Mastodon's role creation feature, showing a very long list of various abilities that can be assigned to the role such as managing reports, blocking users, creating emoji etc.
Screenshot of the role creation screen showing all the abilities that can be assigned to the role

↩ Back to the front page

How to subscribe to PeerTube channels through podcast apps

25 November 2023 at 19:02
Screenshots of a PeerTube channel’s feed link option and the same channel displayed in Apple Podcasts

Every PeerTube channel has a feed link that can be subscribed to through most podcast apps such as AntennaPod, Apple Podcasts etc.

To subscribe via podcast apps, first you need to get the channel’s feed link:

  1. Go to a PeerTube channel’s profile page
  2. Click on the arrow on right side of its Subscribe button
  3. Copy the link from Subscribe via RSS option. If you’re using a phone or tablet, long-press and select Copy link. If you’re on a computer, click on the option to open the link and then copy the feed’s address from the bar at the top of the browser.

Once you’ve got the link, you can use it in your podcast app. Different apps will have different interfaces, but they should be broadly similar in how they work. Usually there will be a box for you to paste the feed link into.

As an example, here’s how to subscribe to a feed link in Apple Podcasts:

  1. Click on the Library tab at the bottom of the screen
  2. Click the ⋯ icon in the top right
  3. Select Follow show by URL
  4. Paste the link into the box, then click Follow

Does this work for video or audio podcasts?

Both! This works for both video and audio, as PeerTube lets people upload both video and audio files.

Can I listen to video episodes as just audio?

Usually yes, but it depends on the podcast app you’re using.

For example, in Apple Podcasts when you press play on a video podcast, the audio plays but the video is shown as a tiny preview (which you can expand to full screen if you want). You can even lock the screen which blanks it, but the audio will carry on playing.

Which podcast apps does this work on?

It should work on any podcast app that allows you to follow a podcast’s feed link. Different apps might call these links “URL” or “RSS” or “Feed” or “Syndication” or other terms, but they all involve the same process of pasting the link into the app.

Most podcast apps allow following podcasts by pasting links. On some podcast apps this may be the only method!

Is this for channels or accounts?

The channel page has a feed for just that channel, the account page has a feed that combines all of the account’s channels into one feed.

Can I download episodes to the podcast app to listen/watch offline?

Yes, if the uploader has enabled downloads. Just use your podcast app’s ordinary download function.

How do I promote my PeerTube channel to podcast app users?

Tell them what the feed link is for your channel, to save them having to do the steps above.

I’m viewing a PeerTube account or channel from Mastodon, how do I find its feed link?

Go to the account or channel’s original page, which will take you to its profile page on PeerTube. Then follow the steps above.

Will this feed work on RSS news feed readers too?

Yes, the same feed works on both RSS news apps and podcast apps.

Will podcast subscribers show on my channel’s subscriber numbers?

No. The subscriber number only shows people following you from the Fediverse (including other PeerTube accounts, Mastodon, Friendica etc). Podcast following works through passive feed subscription, it doesn’t send any kind of following data back to your server.

↩ Back to the front page

What does the eye icon 👁️ mean on Mastodon?

5 November 2023 at 22:50

If you’re browsing a thread on Mastodon through your server’s website or on the web app, you may have noticed an icon in the top right corner that looks like an eye 👁

Clicking this icon reveals or hides all posts in the thread that are hidden by Content Warnings (CW). If the posts with CWs are hidden, click on the eye to open them all at once, or click again to close them all.

This feature is really useful on threads with a lot of posts hidden by CWs, as it means you don’t have to open each CW one by one.

I can’t see the eye, where is it?

The eye icon is only visible when you’re viewing a thread. You can view a thread by clicking on a post, which will show you the thread the post comes from.

I clicked the eye and it doesn’t seem to do anything?

Try clicking it again. If you have one post revealed and you click the eye, it just hides that post and leaves the rest hidden, so it appears to do nothing. When you click again, it opens all the posts at once.

There’s an eye in the official app but it doesn’t reveal the whole thread?

The official Mastodon app also has an eye symbol but it’s displayed in posts rather than at the top of threads, and it just reveals the contents of that specific post.

↩ Back to the front page

How do I post a thread on Mastodon?

2 November 2023 at 03:00

Mastodon threads are built with the traditional method used on many other social networks.

Here’s how to do this manually in any app:

  1. Post the first part of your thread, and mention that it is the start of the thread
  2. Reply to the post with the second part of the thread
  3. Reply to this reply with the third part etc
  4. Just keep replying to your last previous reply to add the next part, and go through all your posts in order
  5. When you get to the final reply, mention that it’s the end of the thread

Should I number the thread?

A lot of people also number their threads at the bottom of each part to indicate it is in a thread, and which part it is (such as 1/9 on first post in a nine post thread, 2/9 on second part, 3/9 on part 3 etc). Some also optionally add a cotton reel emoji 🧵 next to the first post’s numbering as a visual pun to indicate a thread.

If you’re not sure how many parts a thread will have, you can just number them as 1/X, 2/X, 3/X and then END on the final post. As Mastodon has an edit function, you can add the numbering to a thread afterwards too.

What visibility setting should I use for threads?

If you are posting a public thread, it’s considered polite to use a public visibility setting for the first post but an unlisted visibility setting for the replies in the thread. This means that only the start of the thread shows up on public timelines, and makes them easier to browse. However, if you’re unsure about how to do this don’t worry.

Is there an easier way to create threads? Can I create them in advance in one go instead of manually bit-by-bit?

Some apps and scheduled posting services may include thread-creation systems which let you write the thread in full and then post the thread in one go, but at a technical level they are just doing the above process of replies-to-replies automatically.

If you’re on a computer, you can use a notepad application to type the whole thread in one go, then split it into bits by copying and pasting sections of your text over to Mastodon.

↩ Back to the front page

How do I use PeerTube? How do I follow PeerTube accounts from Mastodon?

23 October 2023 at 20:03

This is a guide for watching and interacting with PeerTube videos, and following PeerTube accounts. If you want to publish videos on PeerTube, please click here.

What is PeerTube anyway?

It’s a video platform for the Fediverse, kind of like YouTube but spread out on lots of servers that talk to each other instead of being on one site. Have a look at fedi.video ⧉ if you want to see an example server.

Also here’s the really cool bit: because PeerTube and Mastodon are both part of the Fediverse, you can follow PeerTube accounts from Mastodon. You can also watch, comment on and like PeerTube videos entirely within Mastodon, using your Mastodon account.

How do I watch PeerTube videos?

If you just want to browse and search for PeerTube videos and don’t want to follow or interact, then the easiest method is probably to watch them directly on a PeerTube server website. You don’t need to register, there are no ads, no cookies etc, you can just watch videos in peace without having to do anything else. For an easy way to get started exploring PeerTube, I run a site at fedi.video ⧉ which highlights interesting videos from across the whole PeerTube network.

Different servers will have different videos visible, depending on which other parts of PeerTube they federate with. If you can’t find the videos you want on the server you’re browsing, try using one of the discovery methods mentioned below.

How do I upload videos to PeerTube?

Please see the guide to publishing on PeerTube.

How do I follow PeerTube accounts from Mastodon?

There are many ways to follow PeerTube accounts, but the most popular by far is following them from Mastodon. This allows you to watch, follow and interact with PeerTube using your existing Mastodon account, and without leaving your Mastodon app or website. It’s so simple and seamless that many people who use it don’t even realise they are following PeerTube accounts!

To follow a PeerTube account on Mastodon:

  1. Find the PeerTube account’s fediverse address on its profile page
  2. Copy the account’s address and paste it into the search box in Mastodon, this will bring up the PeerTube account’s profile within Mastodon
  3. Go to the PeerTube profile
  4. Click Follow

…and that’s it! Videos from followed accounts will start appearing in your timeline. You can watch them within Mastodon by clicking the play button, or click on the link to watch the same video on its PeerTube server.

If you want to try this out, copy and paste the account address @theatticdwellers@tilvids.com into the search box on Mastodon. This will bring up a PeerTube account which you can follow, and its videos will be visible on its profile page.

Can I comment and like PeerTube videos from Mastodon?

Yes! You can interact with PeerTube videos entirely within Mastodon.

If you are following a PeerTube account its videos will appear in your home timeline. The videos will look just like posts from Mastodon accounts, and you interact with them in exactly the same way. If you favourite a PeerTube video in Mastodon, it will appear as a thumbs up for that video in PeerTube. If you reply to a PeerTube video in Mastodon, it will appear as a comment below that video in PeerTube.

If you’re wondering how this is possible, it’s because PeerTube and Mastodon are both part of the Fediverse and use the same open technical standard (called ActivityPub) to communicate between servers. That means Mastodon servers can talk to PeerTube servers and vice versa.

How to discover PeerTube accounts to follow

There are lots of ways of discovering PeerTube accounts and videos:

  • Visit the website fedi.video ⧉, which highlights nice videos from across PeerTube which you can browse or search. It does this using an allowlist system which screens out bad content before it can appear.
  • Follow the account @FediVideo@social.growyourown.services ⧉ in Mastodon, it boosts interesting PeerTube videos every day. If you like a particular video and want to see more, click on the video’s profile link and click Follow. There is also a PeerTube playlist ⧉ you can watch which includes every video boosted by the account.
  • Browse the PeerTube section on Fedi.Directory ⧉, and click on an account to find out more. If you like it, copy and paste the account’s address into the search box on Mastodon and click Follow.
  • Some people on Mastodon may also mention their PeerTube account addressrs in their profiles. You can follow these addresses in Mastodon.
  • There is an official PeerTube search engine called SepiaSearch ⧉, which aims to search as many PeerTube servers and videos as possible to give the largest number of relevant current results. However, the downside of this is it may also contain nasty content. (The admins of SepiaSearch screen out bad content when it is reported, but because it uses a blocklist system instead of allowlist, bad stuff may sneak through if no one reports it.)

Following PeerTube accounts from PeerTube

Of course, you can just follow PeerTube accounts from PeerTube itself!

Using a PeerTube account allows you to comment, like, follow etc but also allows some things not possible through Mastodon, such as being creating playlists, saving videos to watch later and various other options such as donating to the creator. Some video accounts also offer file downloads if you want to watch the videos offline. The experience of using a PeerTube account is very similar to YouTube.

You can get a PeerTube account on any PeerTube server that is open for signups, for example tilvids.com ⧉ is a good one. If the video you want to interact with isn’t visible on the server you signed up on, you can make it appear by copying and pasting the video’s link into the search box on your PeerTube server. The video will appear, and you’ll then be able to interact with it and follow its creator’s account.

Can I use PeerTube accounts through an app instead of the website?

Yes, the Fedilab app can be used for PeerTube accounts as well as Mastodon ones, and there’s also a free open source app called NewPipe ⧉ which is PeerTube-compatible too. The PeerTube part of Fedilab is separate from the Mastodon section, and has an interface dedicated to PeerTube.

Also, if you just want to subscribe and watch/listen, but don’t want to comment or like, you might want to try following PeerTube through your favourite podcast app.

A video starts playing but it’s really jerky. How do I fix this?

If you pause a video, this will give the video a chance to load up a bit more so that it doesn’t have to keep stopping.

Also, some videos include a download link so you can watch it on your own device’s video player (this is optional though, it’s is up to the person who uploads the videos to decide if it will include a download link).

A video won’t load, or it says it’s not available. What do I do?

If a video says it cannot be accessed, try reloading the page and pressing play again.

The reason this happens is usually because the video is on a different server to the one you’re watching from, and occasionally the connection can get a bit flaky. Reloading the page usually fixes this problem.

If it still doesn’t load, it’s possible that the server actually hosting the video is down.

Following PeerTube channels and accounts on Podcast apps

If you just want to subscribe to a channel and don’t care about commenting or liking, you can follow any PeerTube channel or account through most podcast apps.

Following PeerTube accounts through RSS

If you’re a fan of using RSS news feeds, you can follow PeerTube accounts through RSS. To get an account’s RSS feed address, go to the account’s profile on PeerTube and click the options arrow next to the Subscribe button, one of the options wthatill be RSS.

As it’s RSS, interactions are impossible because RSS feeds are one directional.

Following PeerTube accounts from other Fediverse server types

There are also other Fediverse platforms which let you follow PeerTube accounts, such as Friendica. You can use exactly the same methods for following as detailed in the above section about Mastodon, it all works in the same way.

Why can’t I find what I want on PeerTube?

PeerTube is very new and most people publishing videos on it have only just got started. It has grown significantly since its early days, and hopefully the explosion of new users on Mastodon will make PeerTube grow even faster. If you want to see more content on PeerTube, it helps if you follow, comment and like the videos that are there already.

Another thing to bear in mind is that PeerTube is mainly built and run by volunteers. Each server has to cover its own operating costs, and the PeerTube platform’s software is developed by a non-profit organisation together with volunteer programmers. There are no VC investors or corporations funding PeerTube, the whole thing is a grassroots effort paid for by donations.

There’s a “friendly reminder” warning at the bottom of the page. What does it mean?

The warning is there for an abundance of transparency, rather than because of significant risk.

PeerTube reduces the stress on servers by sharing the bandwidth of people who are watching the same video at the same time. This allows small independent servers to exist more easily because it keeps costs down on popular videos.

In theory, because the bandwidth is being shared, someone watching the same video as you at exactly the same time as you might be able to see your IP address. However, this is not a built-in feature of PeerTube, it would require significant modifications by whoever did it, and all it would tell them is that someone with that IP address is watching that video. It wouldn’t by itself tell them who you are or any personal info.

Also, even seeing the IP address would be difficult for various technical reasons ⧉.

IP addresses are a short series of numbers that your internet provider assigns to your computer or phone whenever it connects to the internet. Everything on the internet has an IP address so that information can flow correctly from one place to another. IP addresses for ordinary internet users aren’t permanent, and may change every time you connect to the internet.

If you’re concerned about the risk of IP addresses being visible to others, bear in mind your IP address is already visible to any internet site you look at, or online app you interact with, because that’s how the internet knows where to send stuff. The only way to avoid IP addresses being exposed to others is to use a VPN ⧉.

↩ Back to the front page

How to publish videos (and audio) on PeerTube

23 October 2023 at 20:02

This is a guide to publishing on PeerTube, the Fediverse’s video platform. If you want help with just watching PeerTube videos and following PeerTube accounts, click here.

Why publish on PeerTube?

There are many reasons why people choose to publish on PeerTube:

  • PeerTube videos are shown without adverts or interruptions
  • PeerTube servers don’t insert trackers or try to invade people’s privacy
  • Video makers are not at the mercy of an opaque, ever-changing algorithm that manipulates search results
  • PeerTube is part of the Fediverse, which means PeerTube accounts can be followed and interacted with from any of the millions of accounts on Mastodon etc
  • PeerTube servers are totally independent and generally fairly small, so it’s easy to communicate directly with the owner if there’s a problem
  • You can create your own PeerTube server if you want complete control, ownership and flexibility over your video platform

1. Sign up on an existing server, or start your own server?

There are two main ways to publish on PeerTube: sign up on an existing server that belongs to someone else, or start your own server.

The existing server option is much easier, and is the most popular option for individual accounts. Bear in mind some servers allow you to sign up but don’t allow uploads, so you’ll have to find a server that allows uploads for its members. Some well-run servers where you can currently sign up and upload are listed below. By default they are general servers, but ones with a specific theme have been marked:

There are also some servers where uploads are possible but you need to contact the server admin directly in order to activate the upload function for your account:

You can also look at the account addresses of existing PeerTube accounts to see where they are hosted. Their server will be mentioned in the last part of their Fediverse address. To browse existing PeerTube accounts, have a look at fedi.video ⧉.

Alternatively, you can start your own server! Starting your own server is a bit more complicated, but it gives you full control over the server and is favoured by large organisations such as the European Union ⧉ or the Blender Foundation ⧉. You may also want to start your own server for other people to sign up on.

Non-technical people can create their own server through a managed hosting service ⧉ which handles all the techy stuff behind the scenes for a monthly fee. Semi-technical people can use software like Yunohost ⧉ to set up a server on a VPS. Highly technical people can use PeerTube’s full manual instructions ⧉ to set up a server.

2. Accounts vs Channels

Whatever method you use to get onto PeerTube, you will need to create an account and channels for your videos to be uploaded to. Accounts are what you use to log into PeerTube, and channels are like categories for your videos to go into.

However, there is a complication here: the channel system doesn’t work properly on Mastodon. When people view PeerTube videos on Mastodon, they will see the video as being posted by your account and not your channel. Because of this situation, it’s recommended that you use separate PeerTube accounts if you’re wanting to have channels with separate identities, with just have one channel per account and the same name for both.

Channels do work well when viewed through PeerTube, but unfortunately most of the potential audience is on Mastodon where only accounts are visible.

3. Choose your account and channel address carefully

Every account and channel has a display name in big letters, and a Fediverse address in smaller letters below that.

You can change your account or channel display names any time you want, but the account and channel addresses have to stay the same. Fediverse addresses cannot be changed for the same reason that website addresses or email addresses cannot be changed, because any change to an address would break existing connections from other sites.

So, be really sure about your addresses when you are setting up an account and an channel, as you will need to stick with those addresses. If you need to change your identity or branding, changing the display name is a much safer option than fiddling with the addresses.

4. Upload your videos gradually, one at a time or in small batches. Do NOT upload them all at once.

You can upload videos through your server’s website, or though PeerTube-compatible apps like Fedilab.

Because of the way content federates across most of the Fediverse, it is highly recommended that you upload videos gradually, perhaps once a day at most, rather than uploading a huge load of videos all at once.

If you upload all your videos at once before you have any followers, Mastodon users will see your profile as totally blank and may not know you have uploaded any videos at all. Gradual uploads allows you to build up a following, which in turn allows your videos to federate to a much wider audience, gaining you even more followers.

If you’ve already uploaded all your videos in one batch, you can either take some down and reupload them gradually as your follower numbers grow, or you can boost some from your Mastodon account (if you have one). To boost videos on Mastodon, paste the video’s web address into the Mastodon search box, and then clicking the video’s boost button in Mastodon. This will cause the PeerTube video to federate to your Mastodon server and all the servers of people who follow your Mastodon account.

If you have an account on an existing video service, you can import videos directly to your PeerTube account using the Import with URL feature ⧉, but only do this for videos you have legal permission to share. Also bear in mind the automatic import feature reduces the picture quality of the video, and it’s better to upload the original file if you can ⧉.

5. Think about what time of day you upload

Most people on the Fediverse use chronological timelines, so they see posts appearing at the time they were written. On the Fediverse there isn’t an algorithm punishing or rewarding accounts, people simply follow and see all posts from everyone they follow.

This means it’s a good idea to publish videos at a time when your potential audience is awake and looking at their timelines. If you publish when your audience is sleeping, they are much less likely to see your video. (They might still see it from searches and shares, though.)

6. Tag your videos

Lots of people on Mastodon follow hashtags and search for hashtags, so it’s important to tag your PeerTube videos so that they will be noticed by Mastodon users.

To tag a video, to go the video’s Tags section and enter a word or phrase for a tag and then press enter. After you press enter, the tag will be created, and you can add another tag (you can have up to five on a video).

7. Let people know about your PeerTube account

If you have a Mastodon account, tell people about your PeerTube account’s address so they can follow it directly from Mastodon. For example you could post about it, put it in a pinned post, and list the account address on your profile.

If you want your videos to be as visible as possible to a wider audience, it is important to get Mastodon followers for your PeerTube account, because Mastodon has a much larger userbase than PeerTube. Mastodon followers mean each follower’s server will notice whatever videos you upload, and your videos will become visible and searchable to everyone on those Mastodon servers. However, this visibility will only apply to videos uploaded after you were followed, so that’s why it’s important to upload new content gradually as your follower numbers grow.

Alternatively, you can tell my accounts at FediFollows ⧉ and FediVideo ⧉ about your PeerTube account, and I might give it a shoutout!

8. Tell podcast app users how to subscribe to your PeerTube channel feeds

PeerTube channels can be subscribed to via most podcast apps. You might want to let people know this is an option for your PeerTube channel, there’s a guide to how to subscribe to PeerTube on podcast apps here.

Bear in mind though, like all podcasts this is one-directional so people won’t be able to like or comment from their podcast app. Also, podcast subscribers will not show up on your subscriber numbers, though it may show on your view numbers.

By the way, the same podcast link can also be used to subscribe through RSS news feed readers.

What kind of files can I upload to PeerTube? Can I upload audio-only files too?

PeerTube accepts uploads in lots of different video and audio formats. Here’s a complete list:

.webm, .ogv, .ogg, .mp4, .mkv, .mov, .qt, .mqv, .m4v, .flv, .wmv, .avi, .3gp, .3gpp, 3g2, 3gpp2, .nut, .mts, .m2ts, .mpv, .m2v, .m1v, .mpg, .mpe, .mpeg, .vob, .mxf, .mp3, .wma, .wav, .flac, .aac, .m4a, .ac3

If you upload an audio file, you can optionally add a still image as artwork. if you don’t add artwork, the audio file will play over a blank background.

Is there a PeerTube app which includes support for uploading videos?

Yes, the Fedilab app can be used to manage your PeerTube account including uploading videos. It’s mainly known as a Mastodon app, but it also includes full support for PeerTube accounts.

If PeerTube is ad-free, what does that mean for sponsorships and donations? Am I allowed to ask for donations? Am I allowed to upload sponsored videos?

Sponsorships and calls for donations are generally fine.

There are popular PeerTube accounts with sponsorships mentioned in their videos (for example The Linux Experiment ⧉), and many PeerTubers have donation links for viewers that want to support their content. This is all okay.

The “ad-free” description of PeerTube just means that there is no ad system, and there are no adverts or trackers inserted into videos or websites by PeerTube itself.

If you’re in any doubt about whether something is okay to upload to your server, check with your server admin about what is acceptable there. The server owners are the ones paying the bills for the video hosting, so it’s ultimately their call on what is allowed on their server.

↩ Back to the front page

DMs aren’t getting through to me on Pixelfed! What do I do?

1 October 2023 at 18:40

For safety reasons, the default settings on Pixelfed automatically block DMs from people you don’t follow.

If you want to receive DMs from people you don’t follow, you will need to change the settings:

  1. Log into your account on your Pixelfed server
  2. Go to Account Settings
  3. Go to Privacy
  4. Tick the box marked Receive Direct Messages from anyone
  5. Click the Submit button at the bottom of the screen

If you change your mind, repeat this process but untick the box and click Submit.

↩ Back to the front page

Language codes used by Mastodon

24 September 2023 at 20:27

Here’s a complete list of all the language codes used by Mastodon. These can be useful when doing searches by language.

For example if you search mastodon including the phrase language:fr you will only see results in French. You can combine this with keywords or hashtags, or just have the operator on its own if you want to see all recent posts in that language.

(NOTE: If you want your timelines permanently filtering languages, use the dedicated language filters instead.)

LanguageCode
Afaan Oromoo (Oromo)om
Afaraf (Afar)aa
Afrikaans (Afrikaans)af
Akan (Akan)ak
Aragonés (Aragonese)an
Asturianu (Asturian)ast
Asụsụ Igbo (Igbo)ig
Avesta (Avestan)ae
Aymar aru (Aymara)ay
Azərbaycan dili (Azerbaijani)az
Bahasa Indonesia (Indonesian)id
Bahasa Melayu (Malay)ms
Bamanankan (Bambara)bm
Basa Jawa (Javanese)jv
Basa Sunda (Sundanese)su
Bislama (Bislama)bi
Bosanski jezik (Bosnian)bs
Brezhoneg (Breton)br
Català (Catalan)ca
čeština (Czech)cs
Chamoru (Chamorro)ch
ChiCheŵa (Chichewa)ny
ChiShona (Shona)sn
Corsu (Corsican)co
Crnogorski (Montenegrin)cnr
Cymraeg (Welsh)cy
Dansk (Danish)da
Davvisámegiella (Northern Sami)se
Deutsch (German)de
Dhivehi (Divehi)dv
Diné bizaad (Navajo)nv
Eesti (Estonian)et
Ekakairũ Naoero (Nauru)na
Englishen
Esperanto (Esperanto)eo
Español (Spanish)es
Euskara (Basque)eu
Eʋegbe (Ewe)ee
Faka Tonga (Tonga)to
Fiteny malagasy (Malagasy)mg
Français (French)fr
Frysk (Western Frisian)fy
Fulfulde (Fula)ff
Føroyskt (Faroese)fo
Gaeilge (Irish)ga
Gaelg (Manx)gv
Gàidhlig (Scottish Gaelic)gd
Galego (Galician)gl
Gĩkũyũ (Kikuyu)ki
Hiri Motu (Hiri Motu)ho
Hrvatski (Croatian)hr
Ido (Ido)io
Ikinyarwanda (Kinyarwanda)rw
Ikirundi (Kirundi)rn
Interlingua (Interlingua)ia
Interlingue (Interlingue)ie
Iñupiaq (Inupiaq)ik
IsiNdebele (Northern Ndebele)nd
IsiNdebele (Southern Ndebele)nr
IsiXhosa (Xhosa)xh
IsiZulu (Zulu)zu
Íslenska (Icelandic)is
Italiano (Italian)it
Julevsámegiella (Lule Sami)smj
Kajin M̧ajeļ (Marshallese)mh
Kalaallisut (Kalaallisut)kl
Kanuri (Kanuri)kr
Kernewek (Cornish)kw
Kikongo (Kongo)kg
Kiswahili (Swahili)sw
Kreyòl ayisyen (Haitian)ht
Kuanyama (Kwanyama)kj
Kurmancî (Kurmanji (Kurdish))ku
La .lojban. (Lojban)jbo
Láadan (Láadan)ldn
Latine (Latin)la
Latviešu valoda (Latvian)lv
Lëtzebuergesch (Luxembourgish)lb
Lietuvių kalba (Lithuanian)lt
Limburgs (Limburgish)li
Lingála (Lingala)ln
Lingua franca nova (Lingua Franca Nova)lfn
Luganda (Ganda)lg
Magyar (Hungarian)hu
Malti (Maltese)mt
Nederlands (Dutch)nl
Norsk (Norwegian)no
Norsk bokmål (Norwegian Bokmål)nb
Norsk Nynorsk (Norwegian Nynorsk)nn
ꆈꌠ꒿ Nuosuhxop (Nuosu)ii
Occitan (Occitan)oc
Otjiherero (Herero)hz
Owambo (Ndonga)ng
Polski (Polish)pl
Português (Portuguese)pt
Reo Tahiti (Tahitian)ty
Română (Romanian)ro
Rumantsch grischun (Romansh)rm
Runa Simi (Quechua)qu
Sardu (Sardinian)sc
Saɯ cueŋƅ (Zhuang)za
Scots (Scots)sco
Sesotho (Southern Sotho)st
Setswana (Tswana)tn
Shqip (Albanian)sq
SiSwati (Swati)ss
Slovenčina (Slovak)sk
Slovenščina (Slovenian)sl
ślůnsko godka (Silesian)szl
Soomaaliga (Somali)so
Suomi (Finnish)fi
Svenska (Swedish)sv
Taqbaylit (Kabyle)kab
Te reo Māori (Māori) mi
Tiếng Việt (Vietnamese)vi
Toki pona (Toki Pona)tok
Tshiluba (Luba-Katanga)lu
Tshivenḓa (Venda)ve
Türkçe (Turkish)tr
Türkmen (Turkmen)tk
Twi (Twi)tw
Vakaviti (Fijian)fj
Volapük (Volapük)vo
Walon (Walloon)wa
Wikang Tagalog (Tagalog)tl
Wollof (Wolof)wo
Xitsonga (Tsonga)ts
Yângâ tî sängö (Sango)sg
Yorùbá (Yoruba)yo
Åarjelsaemien Gïele (Southern Sami)sma
Ελληνικά (Greek)el
аҧсуа бызшәа (Abkhaz)ab
авар мацӀ (Avaric)av
башҡорт теле (Bashkir)ba
беларуская мова (Belarusian)be
български език (Bulgarian)bg
нохчийн мотт (Chechen)ce
чӑваш чӗлхи (Chuvash)cv
Хальмг келн (Kalmyk)xal
қазақ тілі (Kazakh)kk
коми кыв (Komi)kv
Кыргызча (Kyrgyz)ky
македонски јазик (Macedonian)mk
Монгол хэл (Mongolian)mn
ирон æвзаг (Ossetian)os
Русский (Russian)ru
српски језик (Serbian)sr
ѩзыкъ словѣньскъ (Old Church Slavonic)cu
тоҷикӣ (Tajik)tg
татар теле (Tatar)tt
Українська (Ukrainian)uk
Ўзбек (Uzbek)uz
አማርኛ (Amharic)am
Հայերեն (Armenian)hy
অসমীয়া (Assamese)as
বাংলা (Bengali)bn
भोजपुरी (Bihari)bh
ဗမာစာ (Burmese)my
廣東話 (Cantonese)zh-YUE
ᏣᎳᎩ ᎦᏬᏂᎯᏍᏗ (Cherokee)chr
中文 (Chinese)zh
简体中文 (Chinese (China))zh-CN
繁體中文(香港)(Chinese (Hong Kong))zh-HK
繁體中文(臺灣)(Chinese (Taiwan))zh-TW
ᓀᐦᐃᔭᐍᐏᐣ (Cree)cr
རྫོང་ཁ (Dzongkha)dz
ქართული (Georgian)ka
ગુજરાતી (Gujarati)gu
हिन्दी (Hindi)hi
ⵜⴰⵎⴰⵣⵉⵖⵜ (Standard Moroccan Tamazight)zgh
ᐃᓄᒃᑎᑐᑦ (Inuktitut)iu
日本語 (Japanese)ja
ಕನ್ನಡ (Kannada)kn
ខេមរភាសា (Khmer)km
कश्मीरी (Kashmiri)ks
한국어 (Korean)ko
ລາວ (Lao)lo
മലയാളം (Malayalam)ml
मराठी (Marathi)mr
नेपाली (Nepali)ne
ᐊᓂᔑᓈᐯᒧᐎᓐ (Ojibwe)oj
ଓଡ଼ିଆ (Oriya)or
ਪੰਜਾਬੀ (Panjabi)pa
पाऴि (Pāli)pi
संस्कृतम् (Sanskrit)sa
सिन्धी (Sindhi)sd
සිංහල (Sinhala)si
தமிழ் (Tamil)ta
తెలుగు (Telugu)te
ไทย (Thai)th
བོད་ཡིག (Tibetan)bo
ትግርኛ (Tigrinya)ti
اللغة العربية (Arabic) ar
باليبلن (Balaibalan)zba
هَوُسَ (Hausa)ha
עברית (Hebrew)he
پښتو (Pashto)ps
فارسی (Persian)fa
سۆرانی (Sorani (Kurdish))ckb
اردو (Urdu)ur
ئۇيغۇرچە ‎ (Uyghur)ug
ייִדיש (Yiddish)yi

↩ Back to the front page

❌