Install ImageMagick Textcleaner script on Windows

TextCleaner is a script created by Fred Weinhaus. It’s used to clean scanned documents and to make the final image more readable for OCR process.


Today I will show you how to install and run TextCleaner along with a simple command to pre-process an image.

First step is to download ImagMagick. Scroll down to find Windows binaries and then install the program.

Next download Cygwin.

Cygwin is a command line interface environment similar to Unix, but designed for Microsoft-based platforms. Cygwin allows the development and testing of Windows-based applications on a Unix-like platform. Thus, Unix applications can be developed in a Cygwin environment to be executed easily on the Windows platform with little original source code alteration. In addition, Windows applications could be launched from within Cygwin as well as using Cygwin tools and applications in the context of Windows systems.

Actually, it is the only way I found to execute the scripts I need on Windows.

Run the installer (I reccomend to leave all with default values, especially the installation folder) and pay attention when you arrive at this screen:


Here, be sure to select Full in View menu, write bc in Search and select the first element (make sure it is under math category) in the list. This is an important package useful to correctly run most of the scripts that use ImageMagick (and not only). Go ahead and finish the installation.

After that there are two important steps you have to do: add some folder to environment path and create a new variable. Let’s start with this last one.

Under System variables create a new variable and add as name SHELLOPTS and as value igncr.


Then add these paths. For ImageMagick add the path where you installed it.

Under User variables, add the next paths.


Now, last step is to download the script you want to use: in this case we will download TextCleaner script from Fred Weinhaus site.

Once downloaded, take it and paste in C:\cygwin64\bin (or where you installed Cygwin). Then rename the script from textcleaner to textcleaner.exe

That said, launch your Terminal from the CygwinTerminal shortcut. Thats all. Now it’s only about use scripts and know commands.

We will use this for our demonstration:

textcleaner -g -e normalize -f 5 -o 10 -s 2 C:/Users/Link/Desktop/card.jpg C:/Users/Link/Desktop/clean-card.png

I will not explain here what the parameters are or their values. I will only say that it’s structured like this:

scriptname -parameter(s) input_image_location.extension output_image_location.extension

Thats the result of the script:


Now, doing OCR on the processed image should not be so difficult right ?

This script and many others developed by Fred Weinhaus are free only for non-commercial use, otherwise you will need to contact him for a license.

7 Responses

  1. Thanks for the nice write-up for using my scripts on Windows Cygwin.

    Please note on your page that my text cleaner script is free only for non-commercial use. Otherwise, the user will need to contact me to license it.

    Alternately, you may simply point the user to my home page, which shows my licensing arrangement and from which they can access the textcleaner script.

  2. i follow every step from this but i am facing an error while i am running the textcleaner via cmd. ~Unsupported 16-bit Application , The program or feature C:\cygwin64\bin\textcleaner.exe” cannot start or run due to incompatibity with 64-bit versions of Windows, Please contact the software vendor to ask if 64-bit Windows campatible version is available.”

  3. Hi Sir,
    I follow every step from this but i am facing an error while i am running

    skannan@DESKTOP-JMP2L9R ~
    $ textcleaner -g -e normalize -f 5 -o 10 -s 2 C:/Users/skannan/Desktop/opt.jpg C:/Users/skannan/Desktop/opt_output.png
    /usr/bin/textcleaner: line 313: bc: command not found
    /usr/bin/textcleaner: line 314: [: -eq: unary operator expected
    Invalid Parameter – configure
    /usr/bin/textcleaner: line 436: [: : integer expression expected
    Invalid Parameter – configure
    /usr/bin/textcleaner: line 453: [: : integer expression expected
    /usr/bin/textcleaner: line 459: [: : integer expression expected
    Invalid Parameter – C:

    — FILE C:/Users/skannan/Desktop/opt.jpg NOT READABLE OR HAS ZERO SIZE —

    Could u please help me out.

    Appreciate your help,


  4. Hi Fred,

    This version of textcleaner is not runnning on Windows 10 64 bit. I have followed the same steps as mentioned above.

    Note : Just tried adding +x permission. I know it is not required.

    Administrator@DESKTOP-60U78C6 MINGW64 /c/cygwin64/bin
    $ chmod +x textcleaner

    Administrator@DESKTOP-60U78C6 MINGW64 /c/cygwin64/bin

    Administrator@DESKTOP-60U78C6 MINGW64 /c/cygwin64/bin
    $ textcleaner -g -e normalize -f 5 -o 10 -s 2 C:/Users/Administrator/Desktop/images/rose.jpeg C:/Users/Administrator/Desktop/images/result.jpeg
    bash: textcleaner: command not found

    Administrator@DESKTOP-60U78C6 MINGW64 /c/cygwin64/bin

    Administrator@DESKTOP-60U78C6 MINGW64 /c/cygwin64/bin

Leave a Reply

Your email address will not be published. Required fields are marked *

Post comment