beenull/libreddit
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
Private front-end for Reddit
58 commits 10 branches 114 tags 3.1 MiB
Rust 59.3%
HTML 23.5%
CSS 13.8%
Dockerfile 2%
JavaScript 1.2%
Other 0.2%
Find a file
Spike 863b512718
Create rust.yml
2020-12-03 21:07:01 -08:00
.github/workflows Create rust.yml 2020-12-03 21:07:01 -08:00
src Proxy Thumbnails 2020-11-30 21:10:08 -08:00
static Use base64 for encoding & Upgrade Media Handling 2020-11-30 20:33:55 -08:00
templates Use base64 for encoding & Upgrade Media Handling 2020-11-30 20:33:55 -08:00
.gitignore Actix Rewrite 2020-10-25 13:25:59 -07:00
Cargo.lock Update dependencies 2020-12-02 13:37:33 -08:00
Cargo.toml Proxy Thumbnails 2020-11-30 21:10:08 -08:00
Dockerfile Fix Dockerfile 2020-11-17 21:45:15 -08:00
LICENSE Publish Metadata Files 2020-10-25 13:48:44 -07:00
README.md Updated Screenshot 2020-11-24 19:27:12 -08:00
rustfmt.toml Added Percent Encoding Support 2020-11-29 18:50:29 -08:00

README.md

Libreddit

An alternative private front-end to Reddit

Libre + Reddit = Libreddit

  • 🚀 Fast: written in Rust for blazing fast speeds and safety
  • ☁️ Light: no javascript, no ads, no tracking
  • 🕵 Private: all requests are proxied through the server, including media
  • 🔒 Safe: does not rely on Reddit's OAuth-requiring APIs
  • 📱 Responsive: works great on mobile!

Think Invidious but for Reddit. Watch your cat videos without being watched.

Screenshot

Status

  • Hosting

    • Instances
      • Clearnet instance
      • .onion instance
    • Cargo deployment
    • Docker deployment

  • Subreddits

    • Title
    • Description
    • Posts
      • Post sorting

  • Posts

    • Flairs
    • Comments
      • Comment sorting
      • Nested comments
    • UTC post date
    • Image thumbnails
    • Embedded images
      • Proxied images
    • Reddit-hosted video
      • Proxied video

  • Users

    • Username
    • Karma
    • Description
    • Post history
    • Comment history

  • Search

    • Post aggregating
    • Comment aggregating
    • Result sorting

Instances

Installation

A) Cargo

Make sure Rust stable is installed along with cargo, Rust's package manager.

cargo install libreddit

B) Docker

Deploy the Docker image of Libreddit:

docker run -d --name libreddit -p 8080:8080 spikecodes/libreddit

Deploy using a different port (in this case, port 80):

docker run -d --name libreddit -p 80:8080 spikecodes/libreddit

C) AUR

Libreddit is available from the Arch User Repository as libreddit-git.

Install:

yay -S libreddit-git

D) GitHub Releases

If you're on Linux and none of these methods work for you, you can grab a Linux binary from the newest release.

Deploy an Instance

Once installed, deploy Libreddit (unless you're using Docker) by running:

libreddit

Specify a custom address for the server by passing the -a or --address argument:

libreddit --address=0.0.0.0:8111

To disable the media proxy built into Libreddit, run:

libreddit --no-default-features

Building from Source

git clone https://github.com/spikecodes/libreddit
cd libreddit
cargo run