rimgo/README.md

145 lines
5.6 KiB
Markdown
Raw Normal View History

2022-01-17 23:08:49 +00:00
<img src="https://codeberg.org/video-prize-ranch/rimgo/raw/branch/main/static/img/rimgo.svg" width="96" height="96" />
2022-01-17 23:08:00 +00:00
# rimgo
An alternative frontend for Imgur. Based on [rimgu](https://codeberg.org/3np/rimgu) and rewritten in Go.
2021-10-06 16:19:35 +00:00
2022-01-17 23:08:00 +00:00
<a href="https://www.gnu.org/licenses/agpl-3.0.en.html">
2022-01-17 23:15:58 +00:00
<img alt="License: AGPLv3" src="https://shields.io/badge/License-AGPL%20v3-blue.svg">
2022-01-17 23:08:00 +00:00
</a>
2022-04-03 15:27:18 +00:00
<a href="https://matrix.to/#/#rimgo:nitro.chat">
<img alt="Matrix" src="https://img.shields.io/badge/chat-matrix-blue">
</a>
2022-02-21 17:23:23 +00:00
<a href="https://gitlab.com/overtime-zone-wildfowl/rimgo">
<img alt="CI" src="https://gitlab.com/overtime-zone-wildfowl/rimgo/badges/main/pipeline.svg">
</a>
2021-10-06 16:19:35 +00:00
2022-01-17 23:08:00 +00:00
It's read-only and works without JavaScript. Images and albums can be viewed without wasting resources from downloading and running tracking scripts. No sign-up nags.
2021-10-06 16:19:35 +00:00
2022-01-17 23:08:00 +00:00
## Features
2021-10-07 13:24:37 +00:00
2022-02-21 17:23:23 +00:00
- URL-compatible with i.imgur.com - just replace the domain in the URL
- Images and videos (~~gifv~~, mp4)
- Galleries with comments
- Albums
- User page
- Tag page
2021-10-07 13:24:37 +00:00
2022-04-03 15:27:18 +00:00
Some things left to implement (contributions welcome!):
2022-01-17 22:11:33 +00:00
- [x] Streaming (currently media is downloaded in full in rimgu before it's returned)
2021-10-07 13:24:37 +00:00
- [ ] Localization/internationalization
2022-01-17 22:11:33 +00:00
- [x] Pretty CSS styling (responsive?)
2022-01-17 23:22:46 +00:00
- [ ] Support for other popular image sites
2022-04-03 15:27:18 +00:00
- [x] Filtering and exploration on user/tags pages
- [x] Responsive scaling of videos on user/tags pages
2022-01-17 22:11:33 +00:00
- [x] Logo
2022-01-17 23:08:00 +00:00
Things that are considered out of scope:
2022-01-17 23:22:46 +00:00
* Uploading, commenting, voting, etc - rimgo is read-only.
2022-01-17 23:08:00 +00:00
* Authentication, serving HTTPS, rate limiting, etc - Use a reverse proxy or load balancer like Caddy, Traefik, or NGINX.
2022-01-17 23:22:46 +00:00
* Anything requiring JavaScript or the client directly interacting with upstream servers.
2022-01-17 23:08:00 +00:00
## Instances
Open an issue to have your instance listed here!
### Clearnet
2022-04-01 23:14:38 +00:00
| URL | Country | Cloudflare |
| :--------------------------------------------------------- | :------ | :--------- |
2022-05-03 03:28:16 +00:00
| [i.bcow.xyz](https://i.bcow.xyz) (official) | 🇳🇱️ NL | |
| [rimgo.pussthecat.org](https://rimgo.pussthecat.org) | 🇩🇪 DE | |
| [img.riverside.rocks](https://img.riverside.rocks) | 🇺🇸 US | |
| [rimgo.totaldarkness.net](https://rimgo.totaldarkness.net) | 🇨🇦 CA | |
| [rimgo.bus-hit.me](https://rimgo.bus-hit.me) | 🇨🇦 CA | |
| [rimgo.esmailelbob.xyz](https://rimgo.esmailelbob.xyz) | 🇨🇦 CA | |
2022-04-01 23:14:38 +00:00
| [rimgo.lunar.icu](https://rimgo.lunar.icu) | 🇩🇪 DE | 😢 |
| [i.actionsack.com](https://i.actionsack.com) | 🇺🇸 US | 😢 |
2022-05-31 11:56:30 +00:00
| [rimgo.privacydev.net](https://rimgo.privacydev.net) | 🇺🇸 US | |
### Tor
2022-04-01 23:14:38 +00:00
| URL | Country |
| :-- | :------ |
| [l4d4owboqr6xcmd6lf64gbegel62kbudu3x3jnldz2mx6mhn3bsv3zyd.onion](http://l4d4owboqr6xcmd6lf64gbegel62kbudu3x3jnldz2mx6mhn3bsv3zyd.onion/) | N/A |
| [jx3dpcwedpzu2mh54obk5gvl64i2ln7pt5mrzd75s4jnndkqwzaim7ad.onion](http://jx3dpcwedpzu2mh54obk5gvl64i2ln7pt5mrzd75s4jnndkqwzaim7ad.onion) | 🇺🇸 US |
| [rimgo.lqs5fjmajyp7rvp4qvyubwofzi6d4imua7vs237rkc4m5qogitqwrgyd.onion](http://rimgo.lqs5fjmajyp7rvp4qvyubwofzi6d4imua7vs237rkc4m5qogitqwrgyd.onion) | 🇨🇦 CA |
| [be7udfhmnzqyt7cxysg6c4pbawarvaofjjywp35nhd5qamewdfxl6sid.onion](http://be7udfhmnzqyt7cxysg6c4pbawarvaofjjywp35nhd5qamewdfxl6sid.onion) | 🇦🇺 AU |
### I2P
2022-04-01 23:14:38 +00:00
| URL | Country |
| :-- | :------ |
| [xazdnfgtzmcbcxhmcbbvr4uodd6jtn4fdiayasghywdn227xsmoa.b32.i2p](http://xazdnfgtzmcbcxhmcbbvr4uodd6jtn4fdiayasghywdn227xsmoa.b32.i2p) | 🇦🇺 AU |
2022-01-18 16:04:47 +00:00
2022-05-14 16:11:31 +00:00
## Automatically redirect links
### LibRedirect
Use [LibRedirect](https://github.com/libredirect/libredirect) to automatically redirect Imgur links to rimgo!
- [Firefox](https://addons.mozilla.org/firefox/addon/libredirect/)
- [Chromium-based browsers (Brave, Google Chrome)](https://github.com/libredirect/libredirect#install-in-chromium-brave-and-chrome)
- [Edge](https://microsoftedge.microsoft.com/addons/detail/libredirect/aodffkeankebfonljgbcfbbaljopcpdb)
### GreaseMonkey script
There is a script to redirect Imgur links to rimgo.
[https://codeberg.org/zortazert/GreaseMonkey-Redirect/src/branch/main/imgur-to-rimgo.user.js](https://codeberg.org/zortazert/GreaseMonkey-Redirect/src/branch/main/imgur-to-rimgo.user.js)
2022-01-17 23:30:51 +00:00
## Install
2022-01-20 21:47:21 +00:00
rimgo can run on any platform Go compiles on.
2021-10-06 16:19:35 +00:00
2022-05-03 03:28:16 +00:00
### Docker (recommended)
2022-01-17 23:30:51 +00:00
Install Docker and docker-compose, then clone this repository.
```
git clone https://codeberg.org/video-prize-ranch/rimgo
cd rimgo
```
2021-10-06 16:19:35 +00:00
2022-01-17 23:30:51 +00:00
Edit the `docker-compose.yml` file using your favorite text editor.
2021-10-06 16:19:35 +00:00
```
2022-01-17 23:30:51 +00:00
nvim docker-compose.yml
2021-10-06 16:19:35 +00:00
```
2022-02-11 23:50:24 +00:00
2022-01-17 23:30:51 +00:00
You can now run rimgo.
2021-10-06 16:19:35 +00:00
```
2022-02-12 17:09:15 +00:00
sudo docker-compose up -d
2021-10-06 16:19:35 +00:00
```
2022-01-17 23:30:51 +00:00
### Build from source
2021-10-06 16:19:35 +00:00
2022-01-17 23:30:51 +00:00
#### Requirements
* Go v1.16 or later
2021-10-06 16:19:35 +00:00
2022-01-17 23:30:51 +00:00
Clone the repository and `cd` into it.
2021-10-06 16:19:35 +00:00
```
2022-01-17 23:30:51 +00:00
git clone https://codeberg.org/video-prize-ranch/rimgo
cd rimgo
2021-10-06 16:19:35 +00:00
```
2022-01-17 23:30:51 +00:00
Build rimgo.
```
go build
```
2022-01-17 23:08:00 +00:00
2022-01-17 23:30:51 +00:00
You can now run rimgo.
2022-01-17 23:08:00 +00:00
```
2022-01-17 23:30:51 +00:00
./rimgo
2022-01-17 23:08:00 +00:00
```
2021-10-07 06:21:37 +00:00
2021-10-06 16:19:35 +00:00
## Configuration
2022-04-22 15:55:53 +00:00
rimgo can be configured using environment variables.
2022-01-17 23:08:00 +00:00
### Environment variables
2022-04-22 15:55:53 +00:00
| Name | Default |
|-----------------|-----------------|
| PORT | 3000 |
| ADDRESS | 0.0.0.0 |
| IMGUR_CLIENT_ID | 546c25a59c58ad7 |
## Contributing
2022-02-11 23:50:24 +00:00
PRs are welcome! You can also send patches to `cb.8a3w5@simplelogin.co` but pull requests are preferred.
2021-10-08 19:32:18 +00:00
2022-01-17 23:22:46 +00:00
This software is released under the AGPL 3.0 license. In short, this means that if you make any modifications to the code and then publish the result (e.g. by hosting the result on a web server), you must publicly distribute your changes and declare that they also use AGPL 3.0.