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
1 maintainer
Metadata
1 maintainer
Release files for images-upload-cli 4.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| images_upload_cli-4.1.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| images_upload_cli-4.1.0-py3-none-musllinux_1_2_x86_64.whl | Python 3 | none | Linux musl 1.2+ x86-64 | Details |
| images_upload_cli-4.1.0-py3-none-musllinux_1_2_aarch64.whl | Python 3 | none | Linux musl 1.2+ ARM64 | Details |
| images_upload_cli-4.1.0-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details |
| images_upload_cli-4.1.0-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details |
| images_upload_cli-4.1.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
Total release size: 22.9 MB
Release files / images_upload_cli-4.1.0-py3-none-win_amd64.whl
| Download URL | images_upload_cli-4.1.0-py3-none-win_amd64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
77c45d84c6ade7e6447979fc2bd13db56e187f45e7f92e0af01479d9b5fb85fc
|
|
BLAKE2b-256 checksum How to use checksums |
f475302ff6704a05b55320363a8b53183f7c7a86fcbabc9658224c5727b23775
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 13, 2026.
Transparency logRelease files / images_upload_cli-4.1.0-py3-none-musllinux_1_2_x86_64.whl
| Download URL | images_upload_cli-4.1.0-py3-none-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 4.3 MB |
| Tags | Linux musl 1.2+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
46043447bc405816c6d08232ab0c2950288b88e8df57137d2f7f13b33e160ffa
|
|
BLAKE2b-256 checksum How to use checksums |
05f4073ceee4b55fa46085fe92d3e71c5c829c13af588340571533662d02a0f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 13, 2026.
Transparency logRelease files / images_upload_cli-4.1.0-py3-none-musllinux_1_2_aarch64.whl
| Download URL | images_upload_cli-4.1.0-py3-none-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | Linux musl 1.2+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
1b8f8dac24a0e1dcdfd27d6b1e35d6d70021285bd2384116f8deca6717fc2dae
|
|
BLAKE2b-256 checksum How to use checksums |
fbbd8ecdd13f24e83e5b26f7fc506336f1b094c83723f0b9c92010e123e8c3ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 13, 2026.
Transparency logRelease files / images_upload_cli-4.1.0-py3-none-manylinux_2_28_x86_64.whl
| Download URL | images_upload_cli-4.1.0-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 4.3 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
f3e5d513fd17c3f14c652f49bd16e084593f0842592cedf4903f5685c88c2e92
|
|
BLAKE2b-256 checksum How to use checksums |
100579ed7997745a14c1dd085de718150e10ad5dc14d04fa53925d76ae9fbecf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 13, 2026.
Transparency logRelease files / images_upload_cli-4.1.0-py3-none-manylinux_2_28_aarch64.whl
| Download URL | images_upload_cli-4.1.0-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
c66e08ce01902f358eb18878719f5bb47b7fea11058a5aef3c232963c92ce37e
|
|
BLAKE2b-256 checksum How to use checksums |
91baa30997ca37e7924f5b709b3e7f2633cd8cb246cb34ac92ecee858f63f3f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 13, 2026.
Transparency logRelease files / images_upload_cli-4.1.0-py3-none-macosx_11_0_arm64.whl
| Download URL | images_upload_cli-4.1.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4cc009dd722898509027a88bcc7f111223bf786881f3b6dbc04b9aa2202448ee
|
|
BLAKE2b-256 checksum How to use checksums |
4403ac4d7962d745b16c45cef6bc3a6f9b9bd329581c52d260573dcc9e3b9895
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 13, 2026.
Transparency log
