Skip to main content

CLI application for bulk image instantiation with basic feature support

Project description


imginit is a CLI (Command-Line Interface) application made in Python that creates images and allows customisation for what they contain. You can customise the size, colour and the output directory (what folder the images will be placed in after creation).

imginit also comes with built-in default argument values, making the creation of test material more efficient when using imginit.



  • Python 3.7.1 or later


You can get the latest version of Python 3 for your OS (Operating System) by clicking here, However, if you would like the exact version that imginit was made in, you can download the set-up files for that version here.

After installation, or if you already have Python installed, you can use pip to install imginit like so:

pip install imginit


imginit n [--size/-s width height] [--colour/-c rg b] [--dir/-d path] 

Using imginit on its own creates 10 white, 800x600, .PNG images within the directory the command was run in. This can be helpful for creating images made for testing purposes both quickly and efficiently.


Using the n argument defines how many images will be made. It cannot be less than or equal to 0 and must be an integer, otherwise the program will not work accordingly.

imginit 100

Creates 100 of the same images as described above.


Using imginit --size enables size manipulation for all of the images being generated. The parameter requires 2 arguments: the width and the height.

imginit 100 --size 1920 1080 

You can also use the shortened alias -s for faster queries.

imginit 100 -s 1920 1080


To change the colour of the image, you can use the --colour parameter followed by 3 numbers, all of which must be a number between 0 - 255. The colour mode used is RGB, so if you would like the image to be red then you would do

imginit 50 --colour 255 0 0

Colour is spelled this way due to my being in the UK, but it also supports US spelling so you can do --color instead and imginit will still work accordingly.

The shortened alias -c can also be used as a replacement.

imginit 50 -c 255 0 0


imginit uses the CLI's current working directory as the output directory. This can be changed by using the --dir parameter and supplying a path to a directory that exists.

imginit 25 --dir C:\Users\Me\Pictures

You can always use -d as the shortened alias for --dir.

imginit 25 -d C:\Users\Me\Pictures


Currently the only OS I have tested imginit on is Windows 7, so if there are any issues then feel free to report the issue here.


imginit goes by the MIT License as shown in LICENSE.

Project details

Download files

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

Source Distribution

imginit-1.0a1.tar.gz (2.6 kB view hashes)

Uploaded source

Built Distribution

imginit-1.0a1-py3-none-any.whl (3.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page