2020-10-25 21:48:44 +01:00
|
|
|
# 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
|
2020-11-23 05:22:51 +01:00
|
|
|
- 🕵 Private: all requests are proxied through the server, including media
|
2020-11-22 05:35:42 +01:00
|
|
|
- 🔒 Safe: does not rely on Reddit's OAuth-requiring APIs
|
2020-10-25 21:48:44 +01:00
|
|
|
- 📱 Responsive: works great on mobile!
|
|
|
|
|
|
|
|
|
|
Think Invidious but for Reddit. Watch your cat videos without being watched.
|
|
|
|
|
|
|
|
|
|
## Screenshot
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Status
|
|
|
|
|
|
|
|
|
|
- [x] Hosting
|
|
|
|
|
- [x] Instances
|
|
|
|
|
- [x] Clearnet instance
|
|
|
|
|
- [ ] .onion instance
|
|
|
|
|
- [x] Cargo deployment
|
|
|
|
|
- [x] Docker deployment
|
|
|
|
|
- [x] Subreddits
|
|
|
|
|
- [x] Title
|
|
|
|
|
- [x] Description
|
|
|
|
|
- [x] Posts
|
|
|
|
|
- [x] Post sorting
|
|
|
|
|
- [x] Posts
|
2020-11-18 01:56:37 +01:00
|
|
|
- [x] Flairs
|
2020-10-25 21:48:44 +01:00
|
|
|
- [x] Comments
|
|
|
|
|
- [x] Comment sorting
|
|
|
|
|
- [ ] Nested comments
|
|
|
|
|
- [x] UTC post date
|
|
|
|
|
- [x] Image thumbnails
|
|
|
|
|
- [x] Embedded images
|
2020-11-23 05:22:51 +01:00
|
|
|
- [x] Proxied images
|
2020-10-25 21:48:44 +01:00
|
|
|
- [x] Reddit-hosted video
|
2020-11-23 05:22:51 +01:00
|
|
|
- [x] Proxied video
|
2020-10-25 21:48:44 +01:00
|
|
|
- [x] Users
|
|
|
|
|
- [x] Username
|
|
|
|
|
- [x] Karma
|
|
|
|
|
- [x] Description
|
|
|
|
|
- [x] Post history
|
2020-11-23 20:33:43 +01:00
|
|
|
- [x] Comment history
|
2020-10-25 21:48:44 +01:00
|
|
|
|
|
|
|
|
- [ ] Search
|
|
|
|
|
- [ ] Post aggregating
|
|
|
|
|
- [ ] Comment aggregating
|
|
|
|
|
- [ ] Result sorting
|
|
|
|
|
|
|
|
|
|
## Instances
|
|
|
|
|
|
|
|
|
|
- [libredd.it](https://libredd.it) 🇺🇸 (Thank you to [YeapGuy](https://github.com/YeapGuy)!)
|
|
|
|
|
- [libreddit.spike.codes](https://libreddit.spike.codes) 🇺🇸
|
|
|
|
|
|
|
|
|
|
## Deploy an Instance
|
|
|
|
|
|
2020-11-23 04:21:07 +01:00
|
|
|
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
|
|
|
|
|
```
|
|
|
|
|
|
2020-10-26 05:19:04 +01:00
|
|
|
### A) Cargo
|
2020-10-25 21:48:44 +01:00
|
|
|
|
|
|
|
|
Make sure Rust stable is installed along with `cargo`, Rust's package manager.
|
|
|
|
|
|
|
|
|
|
```
|
2020-10-26 05:19:04 +01:00
|
|
|
cargo install libreddit
|
2020-10-25 21:48:44 +01:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### B) Docker
|
|
|
|
|
|
|
|
|
|
Deploy the Docker image of Libreddit:
|
|
|
|
|
```
|
2020-10-26 05:03:59 +01:00
|
|
|
docker run -d --name libreddit -p 8080:8080 spikecodes/libreddit
|
2020-10-25 21:48:44 +01:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Deploy using a different port (in this case, port 80):
|
|
|
|
|
```
|
2020-10-26 05:03:59 +01:00
|
|
|
docker run -d --name libreddit -p 80:8080 spikecodes/libreddit
|
2020-10-25 21:48:44 +01:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### C) AUR
|
|
|
|
|
|
|
|
|
|
Libreddit is available from the Arch User Repository as [`libreddit-git`](https://aur.archlinux.org/packages/libreddit-git).
|
|
|
|
|
|
|
|
|
|
Install:
|
|
|
|
|
```
|
|
|
|
|
yay -S libreddit-git
|
|
|
|
|
```
|
|
|
|
|
|
2020-10-26 05:19:04 +01:00
|
|
|
## Building
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
git clone https://github.com/spikecodes/libreddit
|
|
|
|
|
cd libreddit
|
|
|
|
|
cargo run
|
|
|
|
|
```
|
