# rimgo An alternative frontend for Imgur. Originally based on [rimgu](https://codeberg.org/3np/rimgu). License: AGPLv3 Matrix ## Table of Contents - [Features](#features) - [Comparison](#comparison) - [Speed](#speed) - [Privacy](#privacy) - [Usage](#usage) - [Instances](#instances) - [Clearnet](#clearnet) - [Tor](#tor) - [Automatically redirect links](#automatically-redirect-links) - [LibRedirect](#libredirect) - [GreaseMonkey script](#greasemonkey-script) - [Redirector](#redirector) - [Install](#install) - [Docker (recommended)](#docker-recommended) - [Automatic updates](#automatic-updates) - [Build from source](#build-from-source) - [Requirements](#requirements) - [Configuration](#configuration) - [Environment variables](#environment-variables) - [Contributing](#contributing) - [License](#license) ## Features - Lightweight - No JavaScript - No ads or tracking - No sign up or app install prompts - Bandwidth efficient - automatically uses newer image formats (if enabled) ## Comparison Comparing rimgo to Imgur. ### Speed Tested using [Google PageSpeed Insights](https://pagespeed.web.dev/). | | [rimgo](https://pagespeed.web.dev/report?url=https%3A%2F%2Fi.bcow.xyz%2Fgallery%2FgYiQLWy) | [Imgur](https://pagespeed.web.dev/report?url=https%3A%2F%2Fimgur.com%2Fgallery%2FgYiQLWy) | | ------------------- | ------- | --------- | | Performance | 91 | 28 | | Request count | 29 | 340 | | Resource Size | 218 KiB | 2,542 KiB | | Time to Interactive | 1.6s | 23.8s | ### Privacy Imgur collects information about your device and uses tracking cookies for advertising, this is mentioned in their [privacy policy](https://imgur.com/privacy/). [Blacklight](https://themarkup.org/blacklight) found 31 trackers and 87 third-party cookies. See what cookies and trackers Imgur uses and where your data gets sent: https://themarkup.org/blacklight?url=imgur.com ## Usage Replace imgur.com or i.imgur.com with the instance domain. For i.stack.imgur.com, replace i.stack.imgur.com with the instance domain and add stack/ before the media ID. You can use a browser extension to do this [automatically](#automatically-redirect-links). Imgur: `https://imgur.com/gallery/j2sOQkJ` -> `https://rimgo.bcow.xyz/gallery/j2sOQkJ` Stack Overflow: `https://i.stack.imgur.com/KnO3v.jpg?s=64&g=1` -> `https://rimgo.bcow.xyz/stack/KnO3v.jpg?s=64&g=1` ## Instances Open an issue to have your instance listed here! ### Clearnet To help distribute load, consider using instances other than the official one. | URL | Country | Provider | Privacy | Notes | | :------------------------------------------------------------ | :----------- | :----------------------- | :-------------------- | :---- | | [rimgo.bcow.xyz](https://rimgo.bcow.xyz) (official) | πŸ‡³πŸ‡± NL | Fly.io | ⚠️ Data collected | | | [rimgo.pussthecat.org](https://rimgo.pussthecat.org) | πŸ‡©πŸ‡ͺ DE | Hetzner | ⚠️ Data collected | | | [rimgo.totaldarkness.net](https://rimgo.totaldarkness.net) | πŸ‡¨πŸ‡¦ CA | Vultr | βœ… Data not collected | | | [rimgo.bus-hit.me](https://rimgo.bus-hit.me) | πŸ‡¨πŸ‡¦ CA | Oracle | ⚠️ Data collected | | | [rimgo.esmailelbob.xyz](https://rimgo.esmailelbob.xyz) | πŸ‡¨πŸ‡¦ CA | OVH | ⚠️ Data collected | | | [imgur.artemislena.eu](https://imgur.artemislena.eu) | πŸ‡©πŸ‡ͺ DE | Vodafone Deutschland | βœ… Data not collected | Self-hosted, provider is ISP | | [rimgo.vern.cc](https://rimgo.vern.cc) | πŸ‡ΊπŸ‡Έ US | OVHCloud | βœ… Data not collected | [Edited theme](https://git.vern.cc/root/modifications/src/branch/master/rimgo) | | [rim.odyssey346.dev](https://rim.odyssey346.dev/) | πŸ‡«πŸ‡·οΈ FR | Trolling Solutions (OVH) | βœ… Data not collected | | | [rimgo.privacytools.io](https://rimgo.privacytools.io/) | πŸ‡ΈπŸ‡ͺ SE | Cloudflare | βœ… Data not collected | | | [i.habedieeh.re](https://i.habedieeh.re/) | πŸ‡¨πŸ‡¦οΈ CA | Oracle Cloud | βœ… Data not collected | | | [rimgo.hostux.net](https://rimgo.hostux.net/) | πŸ‡«πŸ‡·οΈ FR | Gandi | ⚠️ Data collected | | | [ri.zzls.xyz](https://ri.zzls.xyz/) | πŸ‡¨πŸ‡± CL | TELEFΓ“NICA CHILE | βœ… Data not collected | Self-hosted, provider is ISP | | [rimgo.marcopisco.com](https://rimgo.marcopisco.com/) | πŸ‡΅πŸ‡Ή PT | Cloudflare | ⚠️ Data collected | | ### Tor | URL | Privacy | Notes | | :-- | :------ | :----------------------- | | [rimgo.esmail5pdn24shtvieloeedh7ehz3nrwcdivnfhfcedl7gf4kwddhkqd.onion](http://rimgo.esmail5pdn24shtvieloeedh7ehz3nrwcdivnfhfcedl7gf4kwddhkqd.onion) | ⚠️ Data collected | Onion of rimgo.esmailelbob.xyz | | [rimgo.vernccvbvyi5qhfzyqengccj7lkove6bjot2xhh5kajhwvidqafczrad.onion](http://rimgo.vernccvbvyi5qhfzyqengccj7lkove6bjot2xhh5kajhwvidqafczrad.onion) | βœ… Data not collected | Onion of rimgo.vern.cc | | [imgur.lpoaj7z2zkajuhgnlltpeqh3zyq7wk2iyeggqaduhgxhyajtdt2j7wad.onion](http://imgur.lpoaj7z2zkajuhgnlltpeqh3zyq7wk2iyeggqaduhgxhyajtdt2j7wad.onion) | βœ… Data not collected | Onion of imgur.artemislena.eu | | [rim.odysfvr23q5wgt7i456o5t3trw2cw5dgn56vbjfbq2m7xsc5vqbqpcyd.onion](http://rim.odysfvr23q5wgt7i456o5t3trw2cw5dgn56vbjfbq2m7xsc5vqbqpcyd.onion) | ⚠️ Data collected | | | [tdp6uqjtmok723suum5ms3jbquht6d7dssug4cgcxhfniatb25gcipad.onion](http://tdp6uqjtmok723suum5ms3jbquht6d7dssug4cgcxhfniatb25gcipad.onion) | βœ… Data not collected | Onion of rimgo.privacytools.io | | [i.habeehrhadazsw3izbrbilqajalfyqqln54mrja3iwpqxgcuxnus7eid.onion](http://i.habeehrhadazsw3izbrbilqajalfyqqln54mrja3iwpqxgcuxnus7eid.onion/) | βœ… Data not collected | Onion of i.habedieeh.re | ## 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) ### 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) ### Redirector You can use the [Redirector](https://github.com/einaregilsson/Redirector) extension to redirect Imgur links to rimgo with the configuration below: * Description: Imgur -> rimgo * Example URL: https://imgur.com/a/H8M4rcp * Include pattern: `^https?://i?.?imgur.com(/.*)?$` * Redirect to: `https://rimgo.example.com$1` * Pattern type: Regular Expression * Advanced options: * Apply to: * [x] Main window (address bar) * [x] Images For Stack Overflow images: * Description: Stack Overflow Imgur -> rimgo * Example URL: https://i.stack.imgur.com/BTKqD.png?s=128&g=1 * Include pattern: `^https?://i\.stack\.imgur\.com(/.*)?$` * Redirect to: `https://rimgo.example.com/stack$1` * Pattern type: Regular Expression * Advanced options: * Apply to: * [x] Images ## Install rimgo can run on any platform Go compiles on. > It is strongly recommended to use [Caddy](https://caddyserver.com/) as your reverse proxy. Caddy is simple to configure, automatically manages your TLS certificates, and provides better performance with support for HTTP/2 and /3 (allow UDP port 443 in your firewall to use HTTP/3). ### Docker (recommended) Install [Docker](https://docs.docker.com/engine/install/) and [docker-compose](https://docs.docker.com/compose/install/), then clone this repository. ``` git clone https://codeberg.org/video-prize-ranch/rimgo cd rimgo ``` Edit the `docker-compose.yml` file using your favorite text editor. ``` nvim docker-compose.yml ``` You can now run rimgo. ``` sudo docker-compose up -d ``` #### Automatic updates [Watchtower](https://containrrr.dev/watchtower/) can automatically update your Docker containers. Create a new `docker-compose.yml` file or add the watchtower section to your existing `docker-compose.yml` file. ```yml version: "3" services: watchtower: image: containrrr/watchtower volumes: - /var/run/docker.sock:/var/run/docker.sock ``` ### Build from source #### Requirements * Go v1.16 or later Clone the repository and `cd` into it. ``` git clone https://codeberg.org/video-prize-ranch/rimgo cd rimgo ``` Build rimgo. ``` go build ``` You can now run rimgo. ``` ./rimgo ``` To include version information use: ``` go build -ldflags "-X codeberg.org/video-prize-ranch/rimgo/pages.VersionInfo=$(date '+%Y-%m-%d')-$(git rev-list --abbrev-commit -1 HEAD)" ``` (optional) You can use a .env file to set environment variables for configuration. ``` cp .env.example .env nvim .env ``` ## Configuration rimgo can be configured using environment variables. The path to the .env file can be changed the -c flag. ### Environment variables | Name | Default | |-----------------------|-----------------| | PORT | 3000 | | ADDRESS | 0.0.0.0 | | IMGUR_CLIENT_ID | 546c25a59c58ad7 | | FORCE_WEBP | 0 | | PRIVACY_POLICY | | | PRIVACY_MESSAGE | | | PRIVACY_COUNTRY | | | PRIVACY_PROVIDER | | | PRIVACY_CLOUDFLARE | | | PRIVACY_NOT_COLLECTED | | | PRIVACY_IP | | | PRIVACY_URL | | | PRIVACY_DEVICE | | | PRIVACY_DIAGNOSTICS | | ## Contributing Pull requests are welcome! If you have any questions or bug reports, open an [issue](https://codeberg.org/video-prize-ranch/rimgo/issues/new). ## License This software is released under the AGPL-3.0 license. If you make any modifications to the code and distribute it (including use on a network server), you must publicly distribute your changes and release them under the AGPL-3.0.