libreddit/README.md

105 lines
2.1 KiB
Markdown
Raw Normal View History

2020-10-25 20:48:44 +00: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
- 🕵 Private: ~~all~~ most requests are proxied through the server (images are still loaded from Reddit)
2020-11-22 04:35:42 +00:00
- 🔒 Safe: does not rely on Reddit's OAuth-requiring APIs
2020-10-25 20:48:44 +00:00
- 📱 Responsive: works great on mobile!
Think Invidious but for Reddit. Watch your cat videos without being watched.
## Screenshot
![](https://i.ibb.co/SfFHDhh/image.png)
## 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 00:56:37 +00:00
- [x] Flairs
2020-10-25 20:48:44 +00:00
- [x] Comments
- [x] Comment sorting
- [ ] Nested comments
- [x] UTC post date
- [x] Image thumbnails
- [x] Embedded images
- [ ] Proxied images
- [x] Reddit-hosted video
- [ ] Proxied video
- [ ] Localized post date
- [x] Users
- [x] Username
- [x] Karma
- [x] Description
- [x] Post history
- [x] Post sorting
- [ ] Comment history
- [ ] Comment sorting
- [ ] 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-10-26 04:19:04 +00:00
### A) Cargo
2020-10-25 20:48:44 +00:00
Make sure Rust stable is installed along with `cargo`, Rust's package manager.
```
2020-10-26 04:19:04 +00:00
cargo install libreddit
2020-10-25 20:48:44 +00:00
```
### B) Docker
Deploy the Docker image of Libreddit:
```
2020-10-26 04:03:59 +00:00
docker run -d --name libreddit -p 8080:8080 spikecodes/libreddit
2020-10-25 20:48:44 +00:00
```
Deploy using a different port (in this case, port 80):
```
2020-10-26 04:03:59 +00:00
docker run -d --name libreddit -p 80:8080 spikecodes/libreddit
2020-10-25 20:48:44 +00: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
```
Deploy:
```
libreddit
```
2020-10-26 04:19:04 +00:00
## Building
```
git clone https://github.com/spikecodes/libreddit
cd libreddit
cargo run
```