How to Extract Images from a PDF

You can extract and save all images from a PDF as PNG files on a page-by-page basis with this little script. If an image has a CMYK colorspace, it will be converted to RGB first.

    doc = fitz.open("file.pdf")
    for i in range(len(doc)):
        for img in doc.getPageImageList(i):
            xref = img[0]  # check if this xref was handled already?
            pix = fitz.Pixmap(doc, xref)
            if pix.n < 5:  # this is GRAY or RGB
                pix.writePNG("p%s-%s.png" % (i, xref))
            else:  # CMYK needs to be converted to RGB first
                pix1 = fitz.Pixmap(fitz.csRGB, pix)  # make RGB pixmap copy
                pix1.writePNG("p%s-%s.png" % (i, xref))
                pix1 = None  # release storage early (optional)
            pix = None  # release storage early (optional)

This runs very fast: it takes less than 2 seconds to extract the 180 images of Adobe's manual on a 4.0 GHz desktop PC. This is a PDF with 1'310 pages, 30+ MB size and 330,000+ PDF objects.

Find a more advanced version of the script here. Major differences include support for masked images and respecting the original image format (i.e. "JPEG", "TIFF", etc. as opposed to converting everything to PNG). It also tries to decide about the "worthiness" of the extraction and excludes images which are too small or just decorations, etc.

Notes

1. The script relies on the PDF's structural health. It will e.g. not work, if the document's page tree is damaged. There are alternatives for problem PDFs - see below.
2. If images are referenced by multiple pages, they will of course be extracted more than once. Use the image's xref number (first entry of the items in getPageImageList) to check this.

There is another image extractor, which scans all PDF objects (ignoring pages). It will recover from many PDF structure problems.

You may want to read this recipes chapter of the documentation to find out more about image handling in PyMuPDF.