imgup

Upload images via APIs

Installation • Hostings • Usage • Env Variables

Installation

# PyPI
uv tool install images-upload-cli

# AUR
yay -S imgup-bin

Hostings

key: - none · ± optional · + required

host	key	return example
beeimg	-	https://beeimg.com/images/{id}.png
catbox	-	https://files.catbox.moe/{id}
fastpic	-	https://i120.fastpic.org/big/2022/0730/d9/{id}.png
gofile	-	https://gofile.io/d/{id}
imgbox	-	https://images2.imgbox.com/52/8c/{id}_o.png
kappa	-	https://kappa.lol/{id}.png
pixhost	-	https://img75.pixhost.to/images/69/{id}_img.png
sxcu	-	https://sxcu.net/{id}.png
imgur	±	https://i.imgur.com/{id}.png
cloudinary	+	https://res.cloudinary.com/{cloud}/image/upload/{id}.png
filepost	+	https://cdn.filepost.dev/file/.../{id}.png
freeimage	+	https://iili.io/{id}.png
gyazo	+	https://i.gyazo.com/{id}.png
imageban	+	https://i2.imageban.ru/out/2022/07/30/{id}.png
imagekit	+	https://ik.imagekit.io/{id}/img_{id}.png
imgbb	+	https://i.ibb.co/{id}/image.png
imgchest	+	https://cdn.imgchest.com/files/{id}.png
imghippo	+	https://i.imghippo.com/files/{id}.png
imglink	+	https://imglink.cc/cdn/{id}.png
lensdump	+	https://i.lensdump.com/i/{id}.png
pixeldrain	+	https://pixeldrain.com/api/file/{id}
pixvid	+	https://pixvid.org/images/2022/07/30/{id}.png
postimages	+	https://i.postimg.cc/{id}/img.png
redacted	+	https://redacted.sh/i/{id}.png
thumbsnap	+	https://thumbsnap.com/i/{id}.png
tixte	+	https://{domain}.tixte.co/r/{id}.png
uplio	+	https://upl.io/i/{id}.png
uploadcare	+	https://ucarecdn.com/{id}/img.png
vgy	+	https://i.vgy.me/{id}.png
zpic	+	https://zpi.cx/b/{id}.png

Usage

Usage: imgup [OPTIONS] <IMAGES>...

Arguments:
  <IMAGES>...  Image files to upload

Options:
  -H, --hosting <HOSTING>          Hosting service to use [default: imgur]
                                   [possible values: <hostings list from above>]
  -f, --format <FORMAT>            Output format for the links [default: plain]
                                   [possible values: plain, bbcode, html, markdown]
  -t, --thumbnail                  Create captioned thumbnails
  -n, --notify                     Send desktop notification on completion
      --no-clipboard               Disable copying the result to the clipboard
      --env-file <ENV_FILE>        Path to .env file. Overrides default config path
  -j, --jobs <JOBS>                Max concurrent uploads [default: 4]
  -v, --verbose...                 Increase verbosity (-v for info, -vv for debug)
  -h, --help                       Print help
  -V, --version                    Print version

Env Variables

CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=
FILEPOST_KEY=
FREEIMAGE_KEY=
GYAZO_TOKEN=
IMAGEBAN_TOKEN=
IMAGEKIT_PRIVATE_KEY=
IMGBB_KEY=
IMGHIPPO_KEY=
IMGCHEST_KEY=
IMGLINK_KEY=
IMGUR_CLIENT_ID= # optional
LENSDUMP_KEY=
PIXELDRAIN_KEY=
PIXVID_KEY=
POSTIMAGES_KEY=
REDACTED_API_KEY=
THUMBSNAP_KEY=
TIXTE_KEY=
UPLIO_KEY=
UPLOADCARE_KEY=
VGY_KEY=
ZPIC_KEY=

These can be set as environment variables or in a .env file:

• Unix: ~/.config/imgup/.env
• MacOS: ~/Library/Application Support/imgup/.env
• Windows: C:\Users\<user>\AppData\Roaming\imgup\.env