Upload images via APIs
Installation • Hostings • Usage • Env Variables
# PyPI
uv tool install images-upload-cli
# AUR
yay -S imgup-bin| 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 |
| 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: 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, 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 versionFREEIMAGE_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=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