Mastodon Timeline Embed
Embeddable Mastodon timelines (profile/hashtag/local) using a client-side widget.
What it does
This is a small collection of static embed pages that render a Mastodon timeline inside a container using the MastodonTimeline JavaScript widget.
It’s useful when you want an embeddable feed UI (e.g., profile posts) without running a server.
How to use it
- Open: /tools/mastodon/index.html
There are multiple entry pages under /tools/mastodon/ for different feed types:
- Profile timeline: /tools/mastodon/profile.html
- Hashtag timeline: /tools/mastodon/hashtag.html
- Local timeline: /tools/mastodon/local.html
To point the embed at a different instance / account / hashtag, edit the page’s inline initialization block (it passes settings like instanceUrl, timelineType, and userId).
Notes
- The widget fetches public data via the instance’s API endpoints.
- Because this is client-side, the browser is the one making requests to the Mastodon instance.
Details
- JavaScript
- HTML
- CSS
Features
- Profile / hashtag / local timeline modes
- Light/dark theme (auto via prefers-color-scheme)
- Pure client-side embed (fetches from Mastodon API)