Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/geraldwuhoo/omgur
Private front-end for Imgur. Mirror of https://gitlab.wuhoo.xyz/jerry/omgur.
https://github.com/geraldwuhoo/omgur
golang imgur libre privacy proxy self-hosted
Last synced: about 2 months ago
JSON representation
Private front-end for Imgur. Mirror of https://gitlab.wuhoo.xyz/jerry/omgur.
- Host: GitHub
- URL: https://github.com/geraldwuhoo/omgur
- Owner: geraldwuhoo
- License: agpl-3.0
- Created: 2021-04-01T23:29:45.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-07-25T08:18:45.000Z (about 2 months ago)
- Last Synced: 2024-07-25T09:46:28.683Z (about 2 months ago)
- Topics: golang, imgur, libre, privacy, proxy, self-hosted
- Language: Go
- Homepage:
- Size: 78.1 KB
- Stars: 16
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- alternative-front-ends - Omgur - source alternative Imgur front-end focused on privacy. Inspired by the Invidious, Nitter, and Teddit projects. (Overview / Imgur)
README
# omgur
[](https://gitlab.wuhoo.xyz/jerry/omgur/-/commits/master)
Omgur is a free and open-source alternative Imgur front-end focused on privacy.
Inspired by the [Invidious](https://github.com/iv-org/invidious), [Nitter](https://github.com/zedeus/nitter), and [Teddit](https://github.com/teddit-net/teddit) projects.
- No JavaScript or ads
- All requests go through the backend, client never talks to Imgur
- Prevents Imgur from tracking your IP or JavaScript fingerprint
- Lightweight
- Self-hostable
## Features roadmap
- [x] Direct image loading via https://i.imgur.com/
- [x] Imgur album loading via https://imgur.com/a/
- [x] Imgur gallery loading via https://imgur.com/gallery/
- [x] Imgur post loading via https://imgur.com/
- [x] Redis caching for images
- [x] Proper embedding of videos on albums/galleries (direct loading already works)
- [ ] Mock tests of the functionality
## Far-future roadmap
- [ ] Render comments on Imgur posts
- [ ] Frontpage imgur url form
- [ ] Public API endpoints
## Installation
### Docker
Using Docker and docker-compose:
```
docker-compose build
docker-compose up
```
Omgur should now be running at http://localhost:8080.
Prebuilt images are also available at `registry.wuhoo.xyz/jerry/omgur:latest` and `registry.gitlab.com/geraldwuhoo/omgur:latest`.
### Manual
1. Install [Golang](https://golang.org/).
1. (Optional) Install [redis-server](https://redis.io/).
Caches images from imgur – highly recommended.
1. Clone and set up the repository.
```
git clone https://wuhoo.xyz/jerry/gerald/omgur
cd omgur
go mod init git.geraldwu.com/gerald/omgur
go mod tidy
go build -v -a ./cmd/omgur
export REDIS_HOST=localhost
redis-server
./omgur
```
Omgur should now be running at http://localhost:8080. It is possible to change the listening port with the `OMGUR_LISTEN_PORT` environment variable if you already have services using the default port `8080`.