logoHARMAN is a software that can be used to merge, split and cut PDF documents. HARMAN is written in Python Programming Language using the PyGTK GUI toolkit and pyPdf library. Being a multi-platform software, HARMAN should run on both Windows and GNU/Linux.

HARMAN is a free software licensed under GPL v3. Please check out the "COPYING" file to learn more about your full rights under GPL. To download HARMAN visit: http://www.istihza.com/harman/icindekiler_harman_en.html


Screenshot

Screenshot

How to Run HARMAN?

Depending on which operating system you are using, you can install or run HARMAN in various ways:

Installing HARMAN with the setup.py script

GNU/Linux users can use the setup.py script to easily install HARMAN into their computers. Just issue this command:

sudo python setup.py install

HARMAN will go into the "office" menu after installation.

Besides installing HARMAN, the above command will also create a text file named "kurulum.txt". This file contains the list of directory names that HARMAN is installed to. If you would like to completely remove HARMAN from your computer, you can use this file with the "kaldir.py" script as follows:

sudo python kaldir.py kurulum.txt

HARMAN has the following dependencies:

So you should have these modules installed in your computer before you can run HARMAN.

Installing HARMAN through its .deb package

Download the .deb package of HARMAN at http://www.istihza.com/harman/icindekiler_harman_en.html

Ubuntu or Kubuntu users can double-click on the downloaded .deb package to install HARMAN onto their system. HARMAN will reside in the "office" menu after installation.

Running HARMAN through its .exe File

Windows users can download "harman-x.y.exe.7z" from the above address. Note that HARMAN's files are compressed with 7zip for maximum compression. After downloading and uncompressing the file, double-click on the "harman.exe" in the folder. If double-clicking harman.exe does not start HARMAN, this means that you do not have the necessary Windows library named "vcredist.exe" installed. You can download and install this library from Microsoft's website.

Running HARMAN directly from its source .py file

If you intend to run HARMAN from its source code, then you should already have the following modules installed before starting the program:

You can run HARMAN just as you run any other Python program. Following is the command we need to run HARMAN:

python harman.py

Note that HARMAN is not yet compatible with Python's 3.x versions. You should use one of Python's 2.x versions to be able to successfuly run HARMAN. Therefore especially Windows users should be careful about which version of Python is invoked when they issue the command "python".

What can you do with HARMAN?

You can use HARMAN to accomplish these tasks:

Merging PDF documents

In order to merge PDF documents using HARMAN;

  1. On the main window, press "add file to list" button within the "list operations" button group.
  2. A new window will pop up that asks you to open a file.
  3. Choose a pdf document and double click on it.
  4. If the file you chose is not in PDF format, or if the PDF file is corrupt or encrypted, HARMAN will warn you.
  5. Double-clicking the PDF file will add this document to the listbox on the main window.
  6. To merge this file with another PDF document, press once more on "add file to list" button.
  7. Choose another PDF document.
  8. This second PDF document will also be added to the listbox on the main window.
  9. Note that Harman has "drag-and-drop" support. Therefore you can drag and drop one or multiple PDF files in your computer to the listbox on the main window at once.
  10. All the PDF documents listed in the listbox will be merged in the order as they appear in the listbox.
  11. If all you want is to merge two PDF documents, then press on the button named "merge files" in the "file operations" button group.
  12. Pressing this button will invoke a "Save as..." dialog.
  13. In this dialog, we choose a name for the new PDF document that will be created after merging the PDF documents in the listbox.
  14. After giving a new name for the PDF document that will be created, we press on the "save" button to start the merging process.
  15. There is no hard limit to the number of PDF documents that HARMAN can merge concurrently. You can add as much PDF documents as you wish to the listbox to merge them into one single document.

Inserting one page or multiple pages to another PDF document

Suppose that we have a PDF document of 100 pages. What we would like to do is to insert another PDF document to page 40 of this document. To achieve this;

  1. Either use the "add file to list" button or just drag and drop the PDF document of 100 pages in order to add the PDF file into the listbox. And then add the other PDF that you will insert to 40th page of the first PDF in the same manner you added the first PDF document.
  2. Press the "insert page(s)" button on the main window.
  3. If there are more than two PDF files in the listbox, HARMAN will warn you to remove the extra PDF documents from the list. You can remove un-needed PDF files using the "remove file from list" button or the "delete" key on your keyboard.
  4. On pressing the "insert page(s)" button, a new window will pop up.
  5. In the new window you will see that the 100-page document is added to the box as the "first PDF" and the other document that you will insert to the 40th page of the first PDF is added as the "second PDF".
  6. We type "40" (without quotes) into the small box where it reads "insert second pdf to page .... of the first pdf".
  7. When we press the "save as" button, a window will appear that asks us under what name we would like to save the resulting document.
  8. After setting the name and location of the new PDF document, second PDF will be inserted into page 40 of the initial document.

Deleting one page or multiple pages from a PDF document

Suppose again that we would like to delete page 35 of a 100-page PDF document. To achieve this;

  1. Either use the "add file to list" button or just drag and drop the PDF document of 100 pages in order to add the PDF file into the listbox.
  2. Press the "delete page(s)" button on the main window.
  3. If there are more than one PDF file in the listbox, HARMAN will warn you to remove the extra PDF documents from the list. You can remove un-needed PDF files using the "remove file from list" button or the "delete" key on your keyboard.
  4. On pressing the "delete page(s)" button, a new window will pop up.
  5. In this new window you will find that the 100-page document is added to the box as the "first PDF".
  6. Now we type "35" (without quotes) into the small box where it reads "delete page .... of the first pdf".
  7. When we press the "save as" button, a window will appear that asks us under what name we would like to save the resulting document.
  8. After setting the name and location of the new PDF document, page 35 of the first PDF will be deleted.

If you wish to delete multiple pages at once, then type the page numbers to delete by separating them with a "-" sign. For instance, if you want to delete pages 30, 31, 32, 33, 34 and 35 of that 100-page PDF document, you should type "30-35" (without quotes and with no spaces) into that little entry box where we type the page numbers we would like to delete.

If you would like to delete nonconsequtive pages, then type the page numbers to delete by separating them with a "," sign. For instance, if you want to delete pages 30, 34 and 55 of that 100-page pdf document, you should type "30,34,55" (without quotes and with no spaces) into that little entry box where we type the page numbers we would like to delete.

Extracting one page or multiple pages from a PDF document

Let us base our example on the previously mentioned 100-page PDF document. Suppose that we would like to cut page 15 of this 100-page pdf document and save it as a separate document. To achieve this task;

  1. Either use the "add file to list" button or just drag and drop the PDF document of 100 pages in order to add the PDF file into the listbox.
  2. Press the "extract page(s)" button on the main window.
  3. If there are more than one PDF file in the listbox, HARMAN will warn you to remove the extra PDF documents from the list. You can remove un-needed PDF files using the "remove file from list" button or the "delete" key on your keyboard.
  4. On pressing the "extract page(s)" button, a new window will pop up.
  5. In the new window you will see that the 100-page document is added to the box as the "first PDF".
  6. We type "15" (without quotes) into the small box where it reads "extract page .... of the first pdf".
  7. When we press the "save as" button, a window will appear that asks us under what name we would like to save the resulting document.
  8. After setting the name and location of the new pdf document, page 15 of the first PDF will be extracted.

If you wish to extract multiple pages at once, then type the page numbers to extract by separating them with a "-" sign. For instance, if you want to cut pages 30, 31, 32, 33, 34 and 35 of that 100-page pdf document, you should type "30-35" (without quotes and with no spaces) into that little entry box where we type the page numbers we would like to extract.

If you would like to extract nonconsequtive pages, then type the page numbers to extract by separating them with a "," sign. For instance, if you want to extract pages 30, 34 and 55 of that 100-page pdf document, you should type "30,34,55" (without quotes and with no spaces) into that little entry box where we type the page numbers we would like to extract.

Miscellaneous

The button named "remove from list" within the "list operations" button group is meant to remove the files we added to the listbox on the main window.

Following is what those little icons on the main window do:

You can open up the "User's Guide to HARMAN" by pressing the kılavuz icon on the main window. The hakkında icon will pop up HARMAN's "About" box. Use the kapat button to exit HARMAN.

Please e-mail to kistihza {at} yahoo {dot} com to report bugs, or just to tell me what you think about this software...