images-upload-cli 4.0.0a1

Upload images via APIs

images-upload-cli

Upload images via APIs

Installation • Hostings • Usage • Env Variables

Installation

# PyPI
uv tool install images-upload-cli

# AUR
yay -S images-upload-cli-bin

Note: Run with: imgup.

Hostings

host	key required	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
freeimage	+	https://iili.io/{id}.png
gyazo	+	https://i.gyazo.com/{id}.png
imageban	+	https://i2.imageban.ru/out/2022/07/30/{id}.png
imagebin	-	https://ibin.co/{id}.png
imgbb	+	https://i.ibb.co/{id}/image.png
imgchest	+	https://cdn.imgchest.com/files/{id}.png
imgur	-	https://i.imgur.com/{id}.png
lensdump	+	https://i.lensdump.com/i/{id}.png
pixeldrain	+	https://pixeldrain.com/api/file/{id}
pixhost	-	https://img75.pixhost.to/images/69/{id}_img.png
ptpimg	+	https://ptpimg.me/{id}.png
sxcu	-	https://sxcu.net/{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

Upload images via APIs

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

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

Options:
  -H, --hosting <HOSTING>          Hosting service to use [default: imgur]
                                   [possible values: beeimg, catbox, fastpic, freeimage, gyazo,
                                   imageban, imagebin, imgbb, imgchest, imgur, lensdump,
                                   pixeldrain, pixhost, ptpimg, sxcu, thumbsnap, tixte, uplio,
                                   uploadcare, vgy, zpic]
  -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

FREEIMAGE_KEY=
GYAZO_TOKEN=
IMAGEBAN_TOKEN=
IMGBB_KEY=
IMGCHEST_KEY=
IMGUR_CLIENT_ID=
LENSDUMP_KEY=
PIXELDRAIN_KEY=
PTPIMG_KEY=
THUMBSNAP_KEY=
TIXTE_KEY=
UPLIO_KEY=
UPLOADCARE_KEY=
VGY_KEY=
ZPIC_KEY=

You can set these in environment variables, or in .env file:

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