Preparing the Images

To add a board to CircuitPython.org, you will need three sizes of the same image for each board.

  1. Small Size Minimum Width of 292 pixels. (Most photos are 293x225)
  2. Large Size Minimum Width of 590 pixels. (Most photos are 780x600)
  3. Original Size Photo in a Large Size

A good aspect ratio that looks nice for the Original Photo size is 13:10. This is the ratio used for most of Adafruit's product photos. We will start with finding an image, if you don't already have it, resizing it to the appropriate size, and optimizing it for the website.

Finding Images on Flickr

Adafruit has many products available on Flickr in high resolution. Most of the photos are in the 13:10 aspect ratio.

  1. Go to https://www.flickr.com
  2. Type "Adafruit Industries" into the search box and click "Search people"
  3. Click on Adafruit Industries

Click the Magnifying Glass icon on the right

At the top, type in your Search Term and press enter

Click on a Photo in the Search Results

Verify the Description matches the item that you're looking for

Click the Arrow on the right side and select a size that will be your Original Sized photo

Resizing Photos

Photos can be resized in your favorite photo editor such as PhotoShop or GIMP or via websites such as ezgif.com

All three images should have the exact same filename.

PhotoShop

PhotoShop is one of the most popular pieces of Photo Editing software by Adobe, however it is not free. Here are the steps to resize the image in PhotoShop.

  1. Open the Original Sized Photo
  2. Go to Image→Image Size...
  3. Type a width like 780. The height should automatically adjust.
  4. Press OK
  5. Go to File→Export→Export As...
  6. Select JPG for your Format and you can leave the quality as 100%
  7. Click Export All... and save the file into a folder where you'll remember it. Choose a filename appropriate to your board.
  8. Click Edit→Undo until you undo the resizing of the image
  9. Repeat at step 2 for the small sized image, except choose something like 293 for the width

GIMP

GIMP, which stands for Gnu Image Manipulation Program is another very popular, but free piece of software. Here are the steps to resize an image in GIMP.

  1. Open the Original Sized Photo
  2. If it asks about Converting to RGB Working Space, click Convert
  3. Go to Image→Scale Image...
  4. Type a width like 780. The height should automatically adjust
  5. Press Scale
  6. Go to File→Export As...
  7. Select JPG for your Format and you can leave the quality as 100%.
  8. Click Export to save the file into a folder where you'll remember it. Choose a filename appropriate to your board.
  9. Click Edit→Undo until you undo the resizing of the image
  10. Repeat at step 2 for the small sized image, except choose something like 293 for the width

ezgif.com

ezgif.com is a website that provides all kinds of free image manipulation tools. This is a great option if you don't want to install any software on your computer. Here are the steps to resize the image in ezgif.com.

  1. Navigate to https://ezgif.com/resize in your browser
  2. Click Choose File and select your image
  3. Click Upload!
  4. Type a width like 780 into the width box. Leave the height empty so it should automatically adjust
  5. Under If the aspect ratio does not match leave it as Center and crop to fit.
  6. Click Resize image!
  7. Scroll down and under the resized image, click save
  8. It will download as ezgif.com-resize.jpg into your downloads folder
  9. Find it in your downloads and rename it to something more appropriate
  10. Repeat for the small sized image, except choose something like 293 for the width

Optimizing Images

Use your favorite image optimization website such as compressjpeg.com which we will cover.

  1. Navigate to https://compressjpeg.com/ in your browser
  2. Drag and drop all of your images into the area labeled Drop Your Files Here
  3. Once they are done automatically compressing, click the Download All button
  4. Unzip the file that downloads
  5. If you had several similar filenames for the same board, you can look at the file size to determine the appropriate file.
  6. Rename the files to the final name you would like to use.

Your images should now be ready for adding a board.

This guide was first published on Jul 24, 2019. It was last updated on Jul 24, 2019. This page (Preparing the Images) was last updated on Sep 26, 2019.