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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

images_upload_cli-4.1.0-py3-none-win_amd64.whl (3.2 MB view details)

Uploaded Jul 13, 2026 Python 3Windows x86-64

images_upload_cli-4.1.0-py3-none-musllinux_1_2_x86_64.whl (4.3 MB view details)

Uploaded Jul 13, 2026 Python 3musllinux: musl 1.2+ x86-64

images_upload_cli-4.1.0-py3-none-musllinux_1_2_aarch64.whl (4.0 MB view details)

Uploaded Jul 13, 2026 Python 3musllinux: musl 1.2+ ARM64

images_upload_cli-4.1.0-py3-none-manylinux_2_28_x86_64.whl (4.3 MB view details)

Uploaded Jul 13, 2026 Python 3manylinux: glibc 2.28+ x86-64

images_upload_cli-4.1.0-py3-none-manylinux_2_28_aarch64.whl (4.0 MB view details)

Uploaded Jul 13, 2026 Python 3manylinux: glibc 2.28+ ARM64

images_upload_cli-4.1.0-py3-none-macosx_11_0_arm64.whl (3.1 MB view details)

Uploaded Jul 13, 2026 Python 3macOS 11.0+ ARM64

File details

Details for the file images_upload_cli-4.1.0-py3-none-win_amd64.whl.

File metadata

Download URL: images_upload_cli-4.1.0-py3-none-win_amd64.whl
Upload date: Jul 13, 2026
Size: 3.2 MB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for images_upload_cli-4.1.0-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`77c45d84c6ade7e6447979fc2bd13db56e187f45e7f92e0af01479d9b5fb85fc`
MD5	`b82df651b56f4704f85cfef60cd3b374`
BLAKE2b-256	`f475302ff6704a05b55320363a8b53183f7c7a86fcbabc9658224c5727b23775`

See more details on using hashes here.

Provenance

The following attestation bundles were made for images_upload_cli-4.1.0-py3-none-win_amd64.whl:

Publisher: main.yml on deadnews/imgup

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: images_upload_cli-4.1.0-py3-none-win_amd64.whl
- Subject digest: 77c45d84c6ade7e6447979fc2bd13db56e187f45e7f92e0af01479d9b5fb85fc
- Sigstore transparency entry: 2163322335
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: deadnews/imgup@a0069d3eb1866324830e0a21d3ae560e26839de8
- Branch / Tag: refs/tags/v4.1.0
- Owner: https://github.com/deadnews
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: main.yml@a0069d3eb1866324830e0a21d3ae560e26839de8
- Trigger Event: push

File details

Details for the file images_upload_cli-4.1.0-py3-none-musllinux_1_2_x86_64.whl.

File metadata

Download URL: images_upload_cli-4.1.0-py3-none-musllinux_1_2_x86_64.whl
Upload date: Jul 13, 2026
Size: 4.3 MB
Tags: Python 3, musllinux: musl 1.2+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for images_upload_cli-4.1.0-py3-none-musllinux_1_2_x86_64.whl
Algorithm	Hash digest
SHA256	`46043447bc405816c6d08232ab0c2950288b88e8df57137d2f7f13b33e160ffa`
MD5	`356fcdd82753c28a7367bd5c7ab7cb0e`
BLAKE2b-256	`05f4073ceee4b55fa46085fe92d3e71c5c829c13af588340571533662d02a0f6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for images_upload_cli-4.1.0-py3-none-musllinux_1_2_x86_64.whl:

Publisher: main.yml on deadnews/imgup

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: images_upload_cli-4.1.0-py3-none-musllinux_1_2_x86_64.whl
- Subject digest: 46043447bc405816c6d08232ab0c2950288b88e8df57137d2f7f13b33e160ffa
- Sigstore transparency entry: 2163322353
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: deadnews/imgup@a0069d3eb1866324830e0a21d3ae560e26839de8
- Branch / Tag: refs/tags/v4.1.0
- Owner: https://github.com/deadnews
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: main.yml@a0069d3eb1866324830e0a21d3ae560e26839de8
- Trigger Event: push

File details

Details for the file images_upload_cli-4.1.0-py3-none-musllinux_1_2_aarch64.whl.

File metadata

Download URL: images_upload_cli-4.1.0-py3-none-musllinux_1_2_aarch64.whl
Upload date: Jul 13, 2026
Size: 4.0 MB
Tags: Python 3, musllinux: musl 1.2+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for images_upload_cli-4.1.0-py3-none-musllinux_1_2_aarch64.whl
Algorithm	Hash digest
SHA256	`1b8f8dac24a0e1dcdfd27d6b1e35d6d70021285bd2384116f8deca6717fc2dae`
MD5	`e4487d7cf731b15537ab8490242512b1`
BLAKE2b-256	`fbbd8ecdd13f24e83e5b26f7fc506336f1b094c83723f0b9c92010e123e8c3ce`

See more details on using hashes here.

Provenance

The following attestation bundles were made for images_upload_cli-4.1.0-py3-none-musllinux_1_2_aarch64.whl:

Publisher: main.yml on deadnews/imgup

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: images_upload_cli-4.1.0-py3-none-musllinux_1_2_aarch64.whl
- Subject digest: 1b8f8dac24a0e1dcdfd27d6b1e35d6d70021285bd2384116f8deca6717fc2dae
- Sigstore transparency entry: 2163322416
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: deadnews/imgup@a0069d3eb1866324830e0a21d3ae560e26839de8
- Branch / Tag: refs/tags/v4.1.0
- Owner: https://github.com/deadnews
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: main.yml@a0069d3eb1866324830e0a21d3ae560e26839de8
- Trigger Event: push

File details

Details for the file images_upload_cli-4.1.0-py3-none-manylinux_2_28_x86_64.whl.

File metadata

Download URL: images_upload_cli-4.1.0-py3-none-manylinux_2_28_x86_64.whl
Upload date: Jul 13, 2026
Size: 4.3 MB
Tags: Python 3, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for images_upload_cli-4.1.0-py3-none-manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`f3e5d513fd17c3f14c652f49bd16e084593f0842592cedf4903f5685c88c2e92`
MD5	`bf5692d68272dfe44521ee533a6e5667`
BLAKE2b-256	`100579ed7997745a14c1dd085de718150e10ad5dc14d04fa53925d76ae9fbecf`

See more details on using hashes here.

Provenance

The following attestation bundles were made for images_upload_cli-4.1.0-py3-none-manylinux_2_28_x86_64.whl:

Publisher: main.yml on deadnews/imgup

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: images_upload_cli-4.1.0-py3-none-manylinux_2_28_x86_64.whl
- Subject digest: f3e5d513fd17c3f14c652f49bd16e084593f0842592cedf4903f5685c88c2e92
- Sigstore transparency entry: 2163322368
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: deadnews/imgup@a0069d3eb1866324830e0a21d3ae560e26839de8
- Branch / Tag: refs/tags/v4.1.0
- Owner: https://github.com/deadnews
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: main.yml@a0069d3eb1866324830e0a21d3ae560e26839de8
- Trigger Event: push

File details

Details for the file images_upload_cli-4.1.0-py3-none-manylinux_2_28_aarch64.whl.

File metadata

Download URL: images_upload_cli-4.1.0-py3-none-manylinux_2_28_aarch64.whl
Upload date: Jul 13, 2026
Size: 4.0 MB
Tags: Python 3, manylinux: glibc 2.28+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for images_upload_cli-4.1.0-py3-none-manylinux_2_28_aarch64.whl
Algorithm	Hash digest
SHA256	`c66e08ce01902f358eb18878719f5bb47b7fea11058a5aef3c232963c92ce37e`
MD5	`9689ab0b5ea59009602e437d76496adc`
BLAKE2b-256	`91baa30997ca37e7924f5b709b3e7f2633cd8cb246cb34ac92ecee858f63f3f6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for images_upload_cli-4.1.0-py3-none-manylinux_2_28_aarch64.whl:

Publisher: main.yml on deadnews/imgup

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: images_upload_cli-4.1.0-py3-none-manylinux_2_28_aarch64.whl
- Subject digest: c66e08ce01902f358eb18878719f5bb47b7fea11058a5aef3c232963c92ce37e
- Sigstore transparency entry: 2163322398
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: deadnews/imgup@a0069d3eb1866324830e0a21d3ae560e26839de8
- Branch / Tag: refs/tags/v4.1.0
- Owner: https://github.com/deadnews
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: main.yml@a0069d3eb1866324830e0a21d3ae560e26839de8
- Trigger Event: push

File details

Details for the file images_upload_cli-4.1.0-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: images_upload_cli-4.1.0-py3-none-macosx_11_0_arm64.whl
Upload date: Jul 13, 2026
Size: 3.1 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for images_upload_cli-4.1.0-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`4cc009dd722898509027a88bcc7f111223bf786881f3b6dbc04b9aa2202448ee`
MD5	`cbf4ca4525fa9855422adcc2424a402e`
BLAKE2b-256	`4403ac4d7962d745b16c45cef6bc3a6f9b9bd329581c52d260573dcc9e3b9895`

See more details on using hashes here.

Provenance

The following attestation bundles were made for images_upload_cli-4.1.0-py3-none-macosx_11_0_arm64.whl:

Publisher: main.yml on deadnews/imgup

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: images_upload_cli-4.1.0-py3-none-macosx_11_0_arm64.whl
- Subject digest: 4cc009dd722898509027a88bcc7f111223bf786881f3b6dbc04b9aa2202448ee
- Sigstore transparency entry: 2163322386
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: deadnews/imgup@a0069d3eb1866324830e0a21d3ae560e26839de8
- Branch / Tag: refs/tags/v4.1.0
- Owner: https://github.com/deadnews
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: main.yml@a0069d3eb1866324830e0a21d3ae560e26839de8
- Trigger Event: push

Release history Release notifications | RSS feed

This release

4.1.0

Jul 13, 2026

4.0.3

Jun 24, 2026

4.0.2

Apr 6, 2026

4.0.1

Apr 6, 2026

4.0.0

Apr 3, 2026

4.0.0a6 pre-release

Apr 3, 2026

4.0.0a5 pre-release

Apr 3, 2026

4.0.0a4 pre-release

Mar 30, 2026

4.0.0a2 pre-release

Mar 30, 2026

4.0.0a1 pre-release

Mar 30, 2026

3.1.0a7 pre-release

Apr 8, 2024

3.1.0a0 pre-release

Jul 6, 2025

3.0.6

Jul 6, 2025

3.0.5

Dec 15, 2024

3.0.5a1 pre-release

Dec 15, 2024

3.0.5a0 pre-release

Oct 24, 2024

3.0.4

Oct 11, 2024

3.0.4a1 pre-release

Oct 9, 2024

3.0.4a0 pre-release

Jul 26, 2024

3.0.3

Apr 8, 2024

3.0.3rc4 pre-release

Apr 3, 2024

3.0.3rc3 pre-release

Apr 3, 2024

3.0.3rc2 pre-release

Apr 3, 2024

3.0.3rc1 pre-release

Apr 3, 2024

3.0.3a6 pre-release

Apr 4, 2024

3.0.3a5 pre-release

Apr 4, 2024

3.0.3a4 pre-release

Apr 4, 2024

3.0.3a3 pre-release

Apr 4, 2024

3.0.3a2 pre-release

Apr 4, 2024

3.0.3a1 pre-release

Apr 3, 2024

3.0.3a0 pre-release

Apr 3, 2024

3.0.2

Apr 3, 2024

3.0.2b1 pre-release

Apr 3, 2024

3.0.2b0 pre-release

Apr 3, 2024

3.0.1

Feb 22, 2024

3.0.0

Feb 20, 2024

3.0.0a1 pre-release

Feb 20, 2024

3.0.0a0 pre-release

Feb 18, 2024

2.0.2a10 pre-release

Feb 16, 2024

2.0.2a9 pre-release

Feb 14, 2024

2.0.2a8 pre-release

Feb 6, 2024

2.0.2a7 pre-release

Feb 6, 2024

2.0.2a6 pre-release

Feb 6, 2024

2.0.2a5 pre-release

Feb 5, 2024

2.0.2a4 pre-release

Feb 4, 2024

2.0.2a3 pre-release

Feb 4, 2024

2.0.2a2 pre-release

Feb 4, 2024

2.0.2a1 pre-release

Jan 7, 2024

2.0.2a0 pre-release

Oct 1, 2023

2.0.1

Jul 11, 2023

2.0.0

Jun 24, 2023

2.0.0a1 pre-release

Jun 22, 2023

2.0.0a0 pre-release

Jun 21, 2023

1.1.3

May 8, 2023

1.1.3a0 pre-release

May 8, 2023

1.1.2

May 7, 2023

1.1.1

May 7, 2023

1.1.0

Feb 24, 2023

1.0.9

Feb 19, 2023

1.0.9a0 pre-release

Feb 19, 2023

1.0.8

Nov 30, 2022

1.0.7

Oct 8, 2022

1.0.6

Sep 8, 2022

1.0.5

Aug 30, 2022

1.0.4

Aug 29, 2022

1.0.3

Aug 16, 2022

1.0.2

Aug 16, 2022

1.0.1

Aug 3, 2022

1.0.1a5 pre-release

Aug 3, 2022

1.0.1a4 pre-release

Aug 3, 2022

1.0.1a2 pre-release

Aug 3, 2022

1.0.1a1 pre-release

Aug 3, 2022

1.0.1a0 pre-release

Aug 3, 2022

1.0.0

Aug 3, 2022

1.0.0a0 pre-release

Aug 3, 2022

0.3.0a0 pre-release

Aug 3, 2022

0.0.0

May 5, 2023

images-upload-cli 4.1.0

imgup

Installation

Hostings

Usage

Env Variables

Project links

Key dates

1 maintainer

GitHub Statistics

License

Tags

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed