Image sharing web app.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gechandesu aed21e14a3
Merge pull request #2 from gechandesu/dependabot/pip/bottle-0.12.20
2 weeks ago
Dockerfile feat: Reduce image size from ~930M to ~85M 5 months ago
LICENSE feat: Update LICENSE 7 months ago fix: Fix typo in README 7 months ago
Upload to imgs fix: Naitilus script fixed 6 months ago
favicon.ico feat: Add favicon 7 months ago
imgs feat: Add shell-scripts 7 months ago
imgs.ini feat: Update imgs.ini 7 months ago fix: Fixed WSGI app startup 7 months ago
index.tpl feat: Update version 7 months ago
requirements.txt build(deps): Bump bottle from 0.12.19 to 0.12.20 2 months ago
style.css init 1 year ago


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

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


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

See deployment options in Bottle documentation:

Run imgs in Docker

Clone repository and edit imgs.ini.

Build Docker image:

docker build --tag imgs .

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

sudo docker run --rm --name imgs --detach --publish --volume /path/to/your/uploads/dir:/opt/imgs/uploads imgs

imgs will launched on Set up reverse proxy server. I recommed to use basic authentication to prevent abuses. 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;

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

    location ~* \..* {
        auth_basic off;


imgs client with CLI

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

sudo cp imgs /usr/bin/imgs

Nautilus integration

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

Just place Upload to imgs script into ~/.local/share/nautilus/scripts/ directory.