Repair and compress PDF files with python

Got a broken PDF file? You might wanna try fixing this with Python. Follow this easy Python script and have your PDF files repaired in a sec.

Repair PDF files with python or Compress PDF files with python is very simple. Well that was what I was thinking. Python is very powerful so repairing or compressing a simple PDF file should be easy right? Well……

So I was doing my book keeping for my little own company TS Intermedia and I had to upload (or mail) all these invoices to the Receipt scanner service. I created (of course) a mail python script for this. But at a certain point PDF files where not imported. I contacted the helpdesk and they told me that the PDF file was “corrupt.” Well not really corrupt, but there where some strange characters at the beginning of the file. I guess the system that created the PDF files had a bug so it started with some HTML code.

As I do not like doing work twice…. and in this case manually typing in the numbers, dates and other invoice data of 20+ invoices I wanted to repair the PDF’s so I could upload them.

Mac Viewer

So the fantastic 🙂 OS X software has a feature called Viewer. Within viewer you can save the PDF you are looking at and guess what…. it fixed the PDF file!

I could upload it to the system and it was converted into usable data.

Now…. again… I’m not the guy that does work twice (manually) so opening, saving and closing 20+ PDF files…. no I guess not. So as the Mac Viewer app is very good to use for one file, it was no option.


So I searched fo a Python package to help me repair my PDF files. Now there are a lot of fixes to be found on the internet. But, they don’t work. Or they don’t work in Python 3.x or you need a contract with a third party as some fixes are your api calls to services that will fix you PDF.

Finally I found a solution on Github. # theeko74 created the Pdfc – PDF Compressor python PDF repair / compressor tool. It was actually ment to only compress PDF files but it also fixed the file.

Now there is one catch! It not a python solution at all! It actually uses GhostScript on the background to solve this problem.


Ghostscript is an interpreter for PostScript™ and Portable Document Format (PDF) files. Ghostscript consists of a PostScript interpreter layer, and a graphics library. Sometimes the Ghostscript graphics library is confusingly also referred to simply as Ghostscript. Even more confusingly, sometimes people say Ghostscript when they really mean GhostPDL.

So if you want to use the PDF compressor you need to install GhostScript.

Got a Mac? Then its easy.

brew install ghostscript

Have windows… well… good luck with the installation!

Class version repair PDF with Python

So as the theeko74, Pdfc – PDF Compressor works very well, it does not work on folders with multiple files. So I forked the code in Github and created an other version of it.

I created a Class for the function that you can call to compress and repair. Using a class is more easy for you to use as you can just call it, to use it or extent it to build an even better version for you needs.

So to compress and or repair PDF files you can use the files on my Github account.

For using my code just add import CompressPDF to your code.

And then it’s as ease as…..

start\_folder = "/your-folder" 
compress = 2
p = CompressPDF(compress)  

compress\_folder = os.path.join(start\_folder, "compressed\_folder/")  
if not os.path.exists(compress\_folder):  

'''Loop within folder over PDF files'''  
for filename in os.listdir(start\_folder):  
    my\_name, file\_extension = os.path.splitext(filename)  
    if file\_extension == '.pdf':  
        file = os.path.join(start\_folder, filename)  
        new\_file = os.path.join(compress\_folder, filename)  

        if p.compress(file, new\_file):  
            print("{} done!".format(filename))  
            print("{} gave an error!".format(file))

Did you find this article valuable?

Support Theo van der Sluijs by becoming a sponsor. Any amount is appreciated!