eddrit

An alternative frontend for Reddit. Inspired by Nitter, an alternative frontend for Twitter.

Written with Python + Starlette.

• Lightweight
• No ads
• Compact design (closer to old.reddit.com than to the redesign)
• Better mobile support
• No need to register for an OAuth2 identifier for self-hosting: mimic the official Android app by default

Official instance: eddrit.com

⚠️ Rate-limiting

By default, eddrit will mimic the official Android app to bypass the rate-limiting (huge thanks to redlib for the implementation) and use the oauth.reddit.com domain to fetch the data.

If you want, you can instead use the old.reddit.com .json endpoints that don't require authentication (you may encounter rate-limiting or may be blocked from Reddit). To enable this mode, set the environment variable SPOOFED_CLIENT (directly or through an environment variable) to none.

Screenshots

Installation

Docker

A Docker image is available on Docker Hub and on ghcr.io.

There are multiple tags:

• latest for the latest stable tagged release
• dev for the latest commit on the master branch
• Version tags (like 0.1.1, 0.1.2) for specific versions

The image supports linux/amd64 or linux/arm64 architectures.

Without Docker

You can run the app with gunicorn directly :

1. Make sure Python >= 3.12 is installed on your system.
2. Install Poetry which is used to manage dependencies of the project.
3. Download the repository and run "make init" to install the dependencies.
4. You can then run the app through gunicorn, for example with the following command: poetry run gunicorn eddrit.app:app -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8080

Donations

If you wish to support the app, donations are possible here.

Credits

• Bootstrap Icons for the icons used
• dash.js for playing videos
• Pico.css for the CSS framework used
• redlib for the Android app spoofing code
• Video.js for playing videos