---

A lightweight alternative frontend for Reddit.

Official instance: eddrit.com

• 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 to bypass rate-limiting.

Inspired by Nitter, an alternative frontend for Twitter.

Written with Python & Starlette.

Usage

You can use the official instance at eddrit.com.

Like Nitter, the URLs are identical to reddit, so if you can just replace reddit.com by eddrit.com to open a Reddit page in eddrit.

Deployment (for self-hosting)

You can also deploy eddrit for yourself if you don't want to use the public instance.

Docker (recommended)

You can get the image from either:

• Docker Hub as corentingarcia/eddrit
• ghcr.io as ghcr.io/corenting/eddrit

There are multiple tags:

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

The following architectures are supported by the Docker image:

• linux/amd64
• linux/arm64
• linux/arm/v7
• linux/ppc64le

Without Docker

If you know how to deploy a Python ASGI application, you can also deploy it directly without Docker.

For example, with gunicorn:

1. Make sure Python >=3.12 is installed on your system as it's the minimum version supported by eddrit.
2. Install Poetry which is used to manage dependencies of the project.
3. Download/clone the repository and run poetry install --only main to install the application.
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

Configuration

The application can be configured through environment variables (if a .env file is present, it will also be read). The following configuration parameters are available:

• DEBUG (default is false): enable starlette debug mode. Should not be needed outside of development.
• LOG_LEVEL (default is WARNING): only log if the message level is superior or equal to this level.
• SPOOFED_CLIENT (default is android): use android to bypass reddit rate-limiting by spoofing the Android client, or use none to use the old.reddit.com endpoints that don't need any authentication (but in this case you will encounter rate-limiting or may be blocked from Reddit if using an hosting provider IP address).

Donations

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

Credits

• Bootstrap Icons for the icons used in the frontend
• dash.js: library used for DASH videos in the frontend
• Pico.css: CSS framework used for the frontend
• redlib: for the backend Android app spoofing code
• Video.js: the library used for the videos in the frontend