Using Python to Convert Images to WEBP

See Python: Tips and Tricks for similar articles.

On each of our course pages, we include an image like this one that is meant to represent the course: Introduction to Python

The image is in WebP format. This one was converted from the following png file: Introduction to Python

The WebP file (4 KB) is nine times smaller than the png file (36 KB).

Although Google offers conversion tools for all major operating systems, you can easily roll your own with Python and Pillow. Here’s how:

  1. Create a webp folder for storing your code.
  2. Create and activate a virtual environment.
  3. Install Pillow with pip:
    pip install Pillow
  4. Create a subfolder within the webp folder called images and put some png files in there. You can download these images if you don’t have any handy.
  5. Create a file within the webp folder. This is where you’ll write the code.
  6. Import Path from pathlib:
    from pathlib import Path
    Our function will take a source Path to the png file and return a destination Path to the WebP file.
  7. Import Image from PIL:
    from PIL import Image
    This is what we will use to do the conversion.
  8. Write the convert_to_webp() function:
    def convert_to_webp(source):
        """Convert image to WebP.
            source (pathlib.Path): Path to source image
            pathlib.Path: path to new image
        destination = source.with_suffix(".webp")
        image =  # Open image, format="webp")  # Convert image to webp
        return destination
    1. The with_suffix() method of a Path object replaces the current suffix with a new suffix.
    2. The conversion process is just two steps:
      1. Open the image with passing in the source.
      2. Save the image with passing in the destination and the format.

That’s all there is to it. You can call the function like this:

The complete code is shown below along with a main() function for converting all the images in the images folder:

from pathlib import Path
from PIL import Image

def convert_to_webp(source):
    """Convert image to webp.

        source (pathlib.Path): Path to source image

        pathlib.Path: path to new image
    destination = source.with_suffix(".webp")

    image =  # Open image, format="webp")  # Convert image to webp

    return destination

def main():
    paths = Path("images").glob("**/*.png")
    for path in paths:
        webp_path = convert_to_webp(path)


Converting to WebP in Django Admin

On our site, we provide a fallback image using code like this, which instructs the browser to use the first supported image type:

    <source srcset="PYT138.webp" type="image/webp">
    <source srcset="PYT138.png" type="image/png">
    <img src="PYT138.png" alt="Introduction to Python 3 Training">

In Django admin, we only upload the png file and we use code similar to that described above to create a WebP file: webp django admin The Update WebP link shown in the bottom right of the image uses Ajax to call a view that converts the image.

Written by Nat Dunn. Follow Nat on Twitter.

Related Articles

  1. Fixing WebVTT Times with Python
  2. Using Python to Convert Images to WEBP (this article)
  3. Scientific Notation in Python
  4. Understanding Python’s __main__ variable
  5. Converting Leading Tabs to Spaces with Python
  6. pow(x, y, z) more efficient than x**y % z and other options
  7. A Python Model for Ping Pong Matches
  8. Bulk Convert Python files to IPython Notebook Files (py to ipynb conversion)
  9. Python’s date.strftime() slower than str(), split, unpack, and concatenate?
  10. Basic Python Programming Exercise: A Penny Doubled Every Day
  11. Bi-directional Dictionary in Python
  12. How to find all your Python installations on Windows (and Mac)
  13. Associate Python Files with IDLE
  14. Change Default autosave Interval in JupyterLab
  15. Python: isdigit() vs. isdecimal()
  16. Python Clocks Explained
  17. Python Color Constants Module
  18. Maximum recursion depth exceeded while calling a Python object
  19. When to use Static Methods in Python? Never
  20. Finally, a use case for finally – Python Exception Handling
  21. Creating an Email Decorator with Python and AWS
  22. Python Coding Challenge: Two People with the Same Birthday
  23. How to Create a Simple Simulation in Python – Numeric Data
  24. Collatz Conjecture in Python
  25. Simple Python Script for Extracting Text from an SRT File
  26. Python Virtual Environments with venv
  27. Mapping python to Python 3 on Your Mac
  28. How to Make IDLE the Default Editor for Python Files on Windows
  29. How to Do Ternary Operator Assignment in Python
  30. How to Convert Seconds to Years with Python
  31. How to Create a Python Package
  32. How to Read a File with Python
  33. How to Check the Operating System with Python
  34. How to Use enumerate() to Print a Numbered List in Python
  35. How to Repeatedly Append to a String in Python
  36. Checking your Sitemap for Broken Links with Python
  37. How to do Simultaneous Assignment in Python
  38. Visual Studio Code - Opening Files with Python open()
  39. How to Slice Strings in Python
  40. How Python Finds Imported Modules
  41. How to Merge Dictionaries in Python
  42. How to Index Strings in Python
  43. How to Create a Tuple in Python