Skip to main content

picToSquare (Pic To Square) is an experimental python script that 'squares up' every picture in a directory to be Instagram ready.

Project description

PicToSquare Documentation Status

picToSquare is an experimental script that makes use of Pillow to enter and make every picture in a directory “Instagram Ready” by framing ‘em up into a little square.

This script was inspired by how there are multiple free/paid apps to accomplish this on the mobile app store, but none for desktop. Hope this made your social media routine a little less annoying!

Tested On Windows 10 + Python 3.6 + PILLOW 6.0

Terminal Sample: ![console-script](

Output Sample: ![output-sample](

  • Free software: MIT license


  • Does not compress or crop images.
  • Relatively quick.
  • Does not rename images.
  • Optionally set a background colour to either “white” or “black”. (Defaults to white if not set)
  • All pictures are resized into a “picToSquare” directory

How It Works:

  1. git pull this repository
  2. cd pictosquare
  3. <code>pip install requirements.txt</code>
  4. run <code>python src/ -dir <i>(Your Image Directory Path)</i></code>
  5. visit “picToSquare” folder within the directory specified for your images 🖼.

Running Examples:

  1. Basic Script Usage:

    <code>python src/ -dir C://UserName/FolderToBeResized</code>

  2. Custom Colours:

    <code>python src/ -dir C://UserName/FolderToBeResized -color black</code>

Points To Remember:

  • This script requires a folder and does not work on single files. (If you require this to work on a single file, just place it in a folder. Easy!)
  • The script will ignore all files that are not .jpeg, or .jpg. With .png files it would attempt to do an Image.alpha_compose before squaring up the image.
  • This script tends to break on RGBA (Transparent) images. Some transparent images get ‘squared’ into an image with a transparent background instead of the colour specified. It’s recommended that you convert the .png image to a .jpeg to fix this.
  • Every image in your “picToSquare” folder will be overwritten if the filenames match. The script would not clean the Resized folder before each run. (But you can add that functionality yourself, if need be)
  • The script depends on Args (for the command line prompts) and PIL/Pillow.


  • Watermark each image.
    • Save a .png image with the name “watermark.png” in the same directory you want the script to look up. The script would automatically watermark each picture with the watermarked image.

    • Optionally set the image size of the watermark by setting its percentage at the end of the filename. Example “watermark**20**.png” implying watermark that’s sized 20% of the image.

    • End the filename with an optional placement.

      Positions Include: - “-bl” - bottom left (default) - “-br” - bottom right - “-tl” - top left - “-tr” - top right

      Usage: “watermark -bl.png” (without spaces!)

  • Set a custom background color for specific images. - Add a “#hexcode” at the end of the filename from your folder and watch the script add that to the specific image. Usage: “imagename #eeeeeeee.png” (without spaces!)

  • Set a custom background that is neither “black” not “white” for all images. - Add “-color hex-code” to the end of your request. - Example: <code>python src/ -dir C://UserName/FolderToBeResized -color *cccccc* </code>

  • Pick Dominant Colour For Every Image: (Powered by [ColorThief](

    Set colour to “thief”.

    Run: <code>python src/ -dir C://UserName/FolderToBeResized -color thief</code>

Future Plans

  • Probably turn this into an installable package.
  • Add a friendly GUI to perform the same actions.


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


  • 28/05/2019
    • Added colorThief Support.
    • Code hygiene changes.
  • 18/05/2019
    • Added progressbar + tqdm dependency.
    • Fixed to reflect the above stated dependency.
    • Fixed ReadMe file typos.


0.1.0 (2019-10-30)

  • First release on PyPI.

Project details

Download files

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

Files for pictosquare, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size pictosquare-0.1.0.tar.gz (19.3 kB) File type Source Python version None Upload date Hashes View

Supported by

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