Tangled RSS is a simple application that generates RSS feeds for Tangled.sh repositories, making it easy to follow updates from specific users on the Bluesky network. It works by resolving Bluesky handles to DIDs, fetching all records from a user's Tangled repository, and generating an RSS feed.

Features#

Convert Bluesky handles to RSS feeds for Tangled repositories
Sort entries by date (most recent first)
Properly escaped XML output
Simple API interface

Installation#

You'll need Deno installed on your system.

Clone this repository
Navigate to the project directory

Usage#

Running the application#

# Start the application
just start

# Run in development mode with auto-reload
just dev

# Build a standalone executable
just build

API Endpoints#

Access RSS feeds by making a GET request to:

http://localhost:8000/{bluesky_handle}

For example:

http://localhost:8000/alice.bsky.social

Environment Variables#

PORT: The port on which the server will run (default: 8000)

How It Works#

The application takes a Bluesky handle as input
Resolves the handle to a DID using Bluesky's API
Fetches the DID document from PLC directory
Uses the service endpoint to retrieve all Tangled repositories
Generates an RSS feed with the repositories sorted by date

Development#

This application is built with:

Deno - A secure JavaScript and TypeScript runtime
Hono - A lightweight web framework

License#

MIT

Contributing#

Contributions are welcome! Please feel free to submit a Pull Request.

Clone this repository