Getting Started

What is FeedElity?

FeedElity is a personal-first, video-oriented RSS client for following creators across YouTube, Odysee, and PeerTube in one fast, high-density interface. It is self-hosted, privacy-focused, and open source.

The app provides a three-column workflow: a creator/source column on the left, a content list in the middle, and a selected content viewer on the right. You can browse the global catalog anonymously, or sign in to manage subscriptions, favorites, playlists, and history.

Built with modern tooling: Solid on the frontend, Hono on the backend, Drizzle ORM with SQLite/libSQL for storage, better-auth for authentication, and Bun as the runtime.

Requirements

Self-Hosting

  • Docker
  • Docker Compose (v2 or later)

Development

  • Bun 1.3 or later
  • Git

Quick Start

The fastest way to get FeedElity running is with Docker Compose.

1. Clone the repository

git clone https://github.com/anomalyco/FeedElity.git
cd FeedElity

2. Create your environment file

cp .env.docker.example .env

Open .env and set at least BETTER_AUTH_SECRET to a random string of 32 or more characters. Update BETTER_AUTH_URL and CORS_ORIGIN to match your domain if you are not using localhost.

3. Start the services

With a local libSQL database container:

docker compose --profile local-db up -d

Or with an external database (Turso cloud or any libSQL-compatible server). Set DATABASE_URL in .env to your external connection string, then run:

docker compose up -d

4. Open the app

http://localhost

If you changed WEB_PORT, use that port instead. Create an account and start adding sources.

Development Setup

To work on FeedElity locally without Docker, use the Bun runtime.

Install dependencies

bun install

Start the local database

bun run db:local

This starts a local libSQL server on port 5000.

Push the database schema

bun run db:push

Start all dev servers

bun run dev

This starts the web app, API server, and any other dev targets through Turborepo. You can also run individual targets:

bun run dev:web     # Solid web app only
bun run dev:server  # Hono API server only

Type checking and builds

bun run check-types  # TypeScript type check across workspace
bun run build       # Production build

Next Steps

  • Read the Self-Hosting Guide for full deployment options, environment variables, and backup strategies.
  • Add your first source by pasting a YouTube channel URL, Odysee channel URL, or PeerTube video/channel URL.
  • Subscribe to creators, mark favorites, and organize content with playlists.