GitXplorerGitXplorer
u

mastodon-bookmark-rss

public
56 stars
4 forks
2 issues

Commits

List of commits on branch main.
Unverified
217c13d3f39abed9c16e690d79d57fc3aa4b9026

bump rate limits

uuntitaker committed 3 months ago
Unverified
ad03a11e12a6e03972b24d9c5f7df98a818078d9

remove custom error handler

uuntitaker committed 3 months ago
Unverified
db37090c6ef90e44f6c0aa356a071907c8a7edad

bump tower-governor

uuntitaker committed 3 months ago
Unverified
767a0eb2471ba3ad3ab0f0f51be14464923b658e

fix syntax

uuntitaker committed 3 months ago
Unverified
dae47f56d1abbc540ddb336831ceaf7851b139cf

update axum, return standard retry-after header

uuntitaker committed 3 months ago
Unverified
0f7d1a860bfa61521058eb66520f100c96195e4b

remove svelte

uuntitaker committed 3 months ago

README

The README file for this repository.

mastodon-bookmark-rss

A small web service to let you connect your mastodon bookmarks to your RSS reader.

Save interesting posts found on Mastodon into your read-it-later list by using Mastodon's bookmark function.

Use the instance at woodland.cafe or explore the options for self-hosting below.

Linking behavior

Normally the generated RSS feed links to the respective bookmarked Mastodon post. However, if the Mastodon post itself contains a link to another website, the RSS item will use the link and title from that website, or rather from Mastodon's link preview.

The purpose of this is to allow automatic prefetching and saving of article content, which is a feature found in a few RSS readers such as Inoreader. In those cases Mastodon (and Twitter) is just being used as a glorified link aggregator.

The original Mastodon post URL and content is still stored in the RSS <content:encoded> tag, so that additional context can be recovered.

Feed limits

This tool is limited by design to fetch 20 bookmarks. It is mainly intended to automate adding new bookmarks to a reading list, not to provide a complete historical archive within an RSS reader. More could be added, but since there is no state management or caching in place, it could become inconsiderate towards the target Mastodon server to pull many items on every fetch of the feed.

Operating it yourself

Please see docs/deploy.md.

Running it locally

  1. Clone this repository
  2. Have Rust, Node and Yarn installed. I recommend rustup for Rust and Volta for installing both Node and Yarn.
  3. Install entr
  4. Run npm install && npm run dev to get a devserver at localhost:3000

To get a standalone release binary, run npm install && npm run build && cargo build --release.

License

MIT, see LICENSE.