imgs by Bayesia

Note : as the orignal imgs maker is MIA, Bayesia is for now maintaining the project.

Imgs is a minimalictic image sharing web app written with Bottle framework.

No database. No image compression. No time limits. No additional dependencies.

Features:

• Upload images via Drag&Drop
• Easy copy share link
• MIME type detecting

See deployment options in Bottle documentation: https://bottlepy.org/docs/dev/deployment.html

Run imgs in Docker

Run container from docker.io image. Replace /path/to/your/uploads/dir with path to directory where you want to store images:

docker run -d \
    --name imgs \
    --publish 127.0.0.1:5000:5000 \
    --volume /path/to/your/uploads/dir:/opt/imgs/uploads \
    baptisterajaut/imgs:latest

imgs will launched on 127.0.0.1:5000.

Editing imgs.ini

You can add a volume to use a custom imgs.ini if required.

docker run -d \
    --name imgs \
    --publish 127.0.0.1:5000:5000 \
    --volume /path/to/your/uploads/dir:/opt/imgs/uploads \
    --vlume /path/to/your/imgs.ini:/opt/imgs/imgs.ini \
    baptisterajaut/imgs:latest

Imgs has no authentification system builtin ; if you require so, please use a reverse proxy.

Nginx virtual host example:

server {
    listen 80;
    server_name yourdomain.tld;
    root /path/to/imgs/root;

    location / {
        auth_basic "Authentication required";
        auth_basic_user_file /path/to/.htpasswd;
        proxy_pass http://127.0.0.1:5000;
    }

    location ~* ^/favicon.ico$ {
        try_files $uri $uri/ =404;
    }

    location ~* \..* {
        auth_basic off;
        proxy_pass http://127.0.0.1:5000;
    }
}

Apache2 virtual host example

<VirtualHost *:80>
    ServerName yourdomain.tld
 	AllowEncodedSlashes     NoDecode

    RewriteEngine On
	RemoteIPHeader X-Remote-Ip

    ProxyRequests off
    ProxyPreserveHost on
    <LocationMatch "^/.">
        Allow From All
        Satisfy Any
        ProxyPass "http://127.0.0.1:5000/"
        ProxyPassReverse "http://127.0.0.1:5000/"
    </LocationMatch>
    <Location />
        AuthName "Authentication required"
        AuthType Basic
        AuthBasicProvider file
        AuthUserFile "/path/to/.htpasswd"
        Require valid-user
        ProxyPass "http://127.0.0.1:5000/"
        ProxyPassReverse "http://127.0.0.1:5000/"
    </Location>

   

</VirtualHost>

Additional scripts

Requirements

All scripts require curl.

The scripts will try to source "$HOME"/.config/.imgsremote if it exists and use the following variables :

IMGSREMOTE : remote imgs instance URI. (no default) IMGSDEBUG : enables verbose mode and logging (not set/false by default) IMGSLOG : path to logfile. Default: ~/imgs_debug.log

IMGSREMOTE is highly recommended to be set for the cli AND is required for the gnome files script.

imgs CLI

imgs has a simple CLI tool based on curl. Copy the imgscli script to your PATH.

sudo cp scripts/imgscli /usr/bin/

Nautilus integration

Push files to your imgs instance via GNOME Files (former name: Nautilus). Depends on: curl, libnotify (notify-send utility).

Just place imgs-upload script into ~/.local/share/nautilus/scripts/ directory.

DIR=~/.local/share/nautilus/scripts/; mkdir -p $DIR && cp scripts/imgs-upload $DIR