Redlib: A Private, Fast, and Lightweight Front-End for Reddit

Introduction

Redlib is a private, open-source front-end for Reddit, designed to offer a browsing experience free from ads, trackers, and unnecessary bloat. Originating from Libreddit, this project, written in Rust, prioritizes speed, memory safety, and user privacy. It functions similarly to other alternative front-ends like Invidious for YouTube or Nitter for Twitter, allowing users to explore Reddit content without direct interaction with Reddit's tracking mechanisms. Redlib achieves this by proxying all requests, including media, through its server and implementing a strong Content Security Policy.

Installation

Deploying Redlib is flexible, with several methods available to suit different environments.

Docker: Recommended for production, container images are available on quay.io for amd64, arm64, and armv7 platforms. You can use docker compose or the docker CLI to set up and run Redlib.
```
docker pull quay.io/redlib/redlib:latest
docker run -d --name redlib -p 8080:8080 quay.io/redlib/redlib:latest
```
Podman: For rootless containerized deployment, Podman can be used with quadlets on systemd-based distributions.

Binary: Pre-compiled binaries for Linux are available from the latest GitHub releases.

wget https://github.com/redlib-org/redlib/releases/download/v0.31.0/redlib
sudo chmod +x redlib && sudo cp ./redlib /usr/bin/redlib
redlib

Building from Source: For those who wish to deploy with the latest changes or contribute, Redlib can be built directly from its source code.
```
git clone https://github.com/redlib-org/redlib && cd redlib
cargo run
```
Cloud Hosting (Replit/Heroku): Free hosting options are available for quick setups, though users should be aware these are not private and may monitor server usage.
- Run on Repl.it
- Deploy to Heroku
macOS (launchd): A launchd service is provided in contrib/redlib.plist for macOS users.

Examples

Once Redlib is deployed, you can access your instance via the configured port, typically http://localhost:8080 if running locally with default settings. For example, to browse the r/unpopularopinion subreddit privately, you would navigate to your Redlib instance URL followed by /r/unpopularopinion.

Redlib also supports various configuration options through environment variables or a redlib.toml file. For instance, to enable SFW-only mode and set a dark theme by default:

REDLIB_SFW_ONLY=on REDLIB_DEFAULT_THEME=dark redlib

If using Docker, these settings can be defined in a .env file for centralized management.

Why Use Redlib

Redlib offers significant advantages over directly browsing Reddit, primarily focusing on privacy, speed, and a clean user experience.

Enhanced Privacy: Unlike Reddit, which logs extensive user data including IP addresses, user-agent strings, device information, and tracks activity with numerous cookies, Redlib logs nothing in production. It uses optional, non-cross-site cookies only for storing user-configured settings, containing no personal data. All requests are proxied, preventing direct browser connections to Reddit.
Blazing Fast Performance: Written in Rust, Redlib is designed for speed and memory safety. Performance metrics show Redlib significantly outperforms the official Reddit site, with a Speed Index of 0.6s compared to Reddit's 1.9s, and a Performance Score of 100% versus Reddit's 64%.
Lightweight and Bloat-Free: Redlib eliminates JavaScript, ads, and tracking scripts, resulting in a much lighter page load. This not only contributes to its speed but also provides a cleaner, distraction-free browsing environment.
Comparison with Other Front-Ends:
- Teddit: While also a privacy-focused alternative, Teddit often adheres closer to Reddit's old design, whereas Redlib is themed around Reddit's redesign. Redlib's Rust backend also offers distinct performance and memory safety benefits.
- Libreddit: Redlib originated as a fork of Libreddit, but has implemented several technical improvements. These include OAuth token spoofing to circumvent Reddit's rate limits, token refreshing to mimic official app behavior, and HTTP header mimicking to reduce detection.