Manual PDF24 Creator 10

Contents

EXE installer

The EXE installer is based on Inno Setup. The installation process can be controlled via command line arguments. Besides the arguments Inno Setup supports, there are other PDF24 specific arguments.

/SP- Disables the This will install... Do you wish to continue? prompt at the beginning of Setup.

/COMPONENTS="comma separated list of component names"

Overrides the default component settings. Using this command line parameter causes the setup to automatically select a custom type. Only the specified components will be selected; the rest will be deselected. If a component name is prefixed with a "!" character, the component will be deselected. This parameter does not change the state of components that include the fixed flag.

Currently, the setup contains the following components:

Examples of use:

pdf24-creator.exe /VERYSILENT /NOUPDATE

Installs default components silently and disables updates

pdf24-creator.exe /SILENT /NOUPDATE

Installs default components without user interaction and disables updates

pdf24-creator.exe /VERYSILENT /NOUPDATE /COMPONENTS=pdfPrinter

Installs only PDF printer component silently and disables updates

MSI installer

PDF24 provides a MSI package of the PDF24 Creator which you can use to distribute the software on computers. The MSI installation can be customized via command line arguments. Currently, the following arguments are available:

AUTOUPDATE=Yes|No

Enables or disables the auto-update feature of the PDF24. Set the public property AUTOUPDATE=No for disabling the auto-update feature. The feature is disabled by default.

DESKTOPICONS=Yes|No

Creates or disables the Windows Desktop icons for PDF24-PDF and PDF24-Fax. Set the public property DESKTOPICONS=No for disabling the Windows Desktop icons. The Windows Desktop icons will be created by default.

FAXPRINTER=Yes|No

Enables or disables the Fax printer feature of PDF24. Set the public property FAXPRINTER=No for disabling the Fax printer feature. The feature is enabled by default.

REGISTERREADER=Yes|No Enables or disables PDF24 Reader registration. The feature is enabled by default.

Example usage of the MSI properties:

pdf24-creator.msi AUTOUPDATE=[Yes|No] DESKTOPICONS=[Yes|No] FAXPRINTER=[Yes|No] /[qr|qb|qn|...]

The user interface, that installer displays, can be controlled with the /q options:

Registry Settings

The PDF24 Creator stores settings into the Windows registry. Since version 10, the user settings are stored under HKCU\SOFTWARE\PDF24. The application settings and settings that apply to all users are stored under HKLM\SOFTWARE\PDF24. Older versions stored the settings under HKCU\SOFTWARE\PDFPrint and HKLM\SOFTWARE\PDFPrint.

The settings under HKCU overwrite the settings from the HKLM area. There is also an option to give more weight to the settings under HKLM. This can be achieved by putting a ! in front of the key name. Then the value from HKLM is always taken in any case, regardless of what is in HKCU.

Most of the settings can be manipulated by the PDF24 Settings GUI. If you make changes in the GUI then these changes will change the registry values.

Common registry settings

Translation of language files

The PDF24 Creator has language files to offer the PDF printer in languages other than German and English. The languages German and English are maintained by the PDF24 team and are made available to every version. If you can translate into another language, we would be pleased if you could translate an existing language file into this language so that we can offer the PDF24 Creator in this language as well.

If you notice an error in one of the existing language files when translating a language file, tell us and we will fix these mistakes.

The language files of the PDF24 Creator can be found in the lang folder in the PDF24 installation directory. The language files end with the extension .lang and can be edited with a text editor. The language files are to be encoded with UTF-8 with BOM. A text editor like Notepad++ recognizes this automatically.

A language file is structured line by line. Lines beginning with # are comments and do not need to be translated. Each line contains the key and the text of a language element. Key and text are separated by a =. Only the text may be translated, the key must remain as it is so that the PDF24 Creator can find a text element. Here is an example:

# # PDF Quality # general/pdf-quality = Quality of PDF general/quality/low = Low quality general/quality/medium = Medium quality general/quality/good = Good quality

In the example above, e.g. general/pdf-quality is a key and Quality of PDF is the text to that key. Only the text Quality of PDF may be translated.

Already translated language files can contain the two characters #! as first characters in a line. This indicates that this line still needs to be translated. If new language elements are added to the PDF24 Creator, we add the missing elements to all language files with the content from the English language file and mark these lines with the characters #!. These lines are not yet translated. Translators can use this method to find elements that have not yet been translated and translate them. After the translation, the #! string must be removed.

Please send your translated or updated language file to team@pdf24.org. We will then integrate your translation into the PDF24 Creator.

PDF Printers

The PDF24 Creator is able to manage multiple PDF printers. Each PDF printer can be configured differently. For example, if you want to save a file automatically, you can easily do this with a dedicated PDF printer. To manage PDF printers, use the settings utility. There you can add, remove or configure PDF printers.

Ports

PDF printers use special ports from the system to receive printer data. The default or first PDF printer created by the installer has the port \\.\pipe\PDFPrint. Additional PDF printers will have ports like \\.\pipe\PDFPrint-1, \\.\pipe\PDFPrint-2 and so on.

If you have problems with your default PDF printer, e.g. if print jobs get stuck in the printer queue, please check the port to which the PDF printer is connected to. Make sure, that the default PDF printer is connected to port \\.\pipe\PDFPrint. If this is not the case, change this manually in the printer properties via the control panel of Windows.

pdf24-Ocr.exe

The pdf24-Ocr.exe is an app, that does optical character recognition on files. The app generates PDF files with text layer. Under the hood, the app uses Tesseract for text recognition. The result of tesseract is then combined with the actual file.

Command line

pdf24-Ocr.exe [OPTIONS] [FILES]

Invoking the application without arguments simply opens a GUI. Invoking the app with files, opens the GUI and loads the files specified on command line.

To apply OCR on a specific file and to save the resulting PDF file with a text layer, invoke the OCR tool like this:

pdf24-Ocr.exe -outputFile output.pdf [-language eng] [-dpi 300] [-applyProfile PROFILE] [-skipFilesWithText] [-skipPagesWithText] "input.pdf"

The -outputFile switch tells the app where to store the produced PDF file with recognized text.

The -language switch sets the language used by the OCR process. Open the list of available language codes to see all language codes you can use.

The -dpi switch sets the DPI value used by the OCR process. In common, 300 is the recommended value.

The -applyProfile switch can be used to apply an output profile to the generated PDF file that contains the recognized text.

-skipFilesWithText tells the app to not process files that already contains text.

-skipPagesWithText tells the app to not process pages of a file that already contains text.

In general, the app downloads language files on demand. Otherwise the installer would be very large and would consume a lot of disk space. If you prefer a local installation of all language files, the read the next chapter.

Local installation of all language file

To install language files locally and to stop downloading language files from the internet, do the following:

  1. Download the language files list for local installation and put the file into the tesseract folder of the PDF24 installation directory. Name the file trainDataList.txt.

  2. Then download the individual language files specified in the language files list for download on demand into the tessdata folder INSTALL_DIR/tesseract/tessdata.

Please make sure that you use the language files that are compatible with Tesseract 4.0. The language files can be downloaded from the tesseract project on GitHub.

Compared to the online list the local list does not contain URLs for download. Please note to rename the file name from local-list.txt to trainDataList.txt.

You can shorten the list if you like. In the list you can only specify the language files that should be displayed in the software.

pdf24-DocTool.exe

Basically, the pdf24-DocTool.exe is invoked like this:

pdf24-DocTool.exe [flags] [file1] [file2] ...

[flags]

Flags are used to tell the DocTool what to do. See below for supported flags of specific commands. There are common flags which apply to mostly all commands of the DocTool. That are the following ones:

[file1] [file2] ...

The DocTool is a file tool and you have to specify one or more files on the command line which are to be processed.


pdf24-DocTool.exe file1 [file2] ...

Converts the files on the command line to PDF and opens an PDF24 assistant to handle the converted files.

file1 [file2] ...

One or more files to process.


pdf24-DocTool.exe -webOptimize [-outputDir dir] [-outputFile file] file1 [file2] ...

Optimizes the files for web. Generates web optimized PDF files.

-webOptimize

The command to tell the DocTool to optimize the input files for web.

[-outputDir dir]

Optional flag to specifiy an output folder where the DocTool should save the generated files. The files are saved under the name of the file inside the specified directory.

[-outputFile file]

Optional flag to specifiy an output file under which the DocTool should save the generated file(s). If more than one file is specified on the command line to be processed then the DocTool modifies the file name and adds a number.

The output file can be the special "-" one. In that case the DocTool saves the processed files into the same directory like the input files.

file1 [file2] ...

The input files to optimize for web


pdf24-DocTool.exe -applyProfile [-profile profileId] [-outputDir dir] [-outputFile file] file1 [file2] ...

Applies a profile on the specified files. A profile can be specified on command line or can be selected via a profile select dialog.

-applyProfile

The command to tell the DocTool to apply a profile on the input files

[-profile profileId]

Optional flag to specify an ID of a profile to use. The ID of default profiles is like "default/xxx" where xxx is the name of a default profile, e.g. "good" or "best". The ID of user profiles is like "user/yyy" where yyy is the name of a user profile.

[-outputDir dir] [-outputFile file] file1 [file2]

@see Documentation of "pdf24-DocTool.exe -webOptimize"


pdf24-DocTool.exe -join [-sort] [-profile profileId] [-outputDir dir] [-outputFile file] file1 [file2] ...

Joins input files to one output file.

-join

Tells the DocTool to join the input files

[-sort]

Optional flag to sort the input files by name before joining.

[-profile profileId]

@see Documentation of "pdf24-DocTool.exe -applyProfile"

[-outputDir dir] [-outputFile file] file1 [file2]

@see Documentation of "pdf24-DocTool.exe -webOptimize"


pdf24-DocTool.exe -extractPages file1 [file2] ...

Opens a page extract dialog for the input files to extract pages from the documents.

-extractPages

Tells the DocTool to open the page extract dialog for the input files

file1 [file2]

The file(s) from which to extract


pdf24-DocTool.exe -splitByPage [-outputDir dir] [-outputFile file] file1 [file2] ...

Splits the documents page by page

-splitByPage

Tells the DocTool to split the input files page by page.

[-outputDir dir] [-outputFile file] file1 [file2]

@see Documentation of "pdf24-DocTool.exe -webOptimize"


pdf24-DocTool.exe -convertTo [-outputDir dir] [-outputFile file] file1 [file2] ...

Converts the input files. Opens the Save As dialog where the user can select a file type and where the user can specify specific output file options.

-convertTo

Tells the DoctTool to convert the input files

[-outputDir dir] [-outputFile file] file1 [file2]

@see Documentation of "pdf24-DocTool.exe -webOptimize"


pdf24-DocTool.exe -convertToPDF [-profile profileId] [-outputDir dir] [-outputFile file] file1 [file2] ...

Converts the input files to PDF. The user can select a profile which is used to save the output file.

-convertToPDF

Tells the DoctTool to convert the input files to PDF

[-profile profileId]

@see Documentation of "pdf24-DocTool.exe -applyProfile"

[-outputDir dir] [-outputFile file] file1 [file2]

@see Documentation of "pdf24-DocTool.exe -webOptimize"


pdf24-DocTool.exe -upload -url url file1 [file2] ...

Upload the input files to a web service, extracts the location header of the response and opens a browser window with the URL from the location header.

-upload

Tells the DocTool to upload the input files to a web service.

-url url

Specifies the URL of a web service to which to upload the input files.

file1 [file2] ...

The files to upload.


pdf24-DocTool.exe -sendAsMail file1 [file2] ...

Opens the send email dialog and attaches the input files so that the user can send the files as an email.

-sendAsMail

Tells the DocTool to send the input files as an email.

file1 [file2] ...

The files to send.


pdf24-DocTool.exe -sendAsFax file1 [file2] ...

Sends the input files as a fax.

-sendAsFax

Tells th DocTool to send the input files as a fax.

file1 [file2] ...

The files to send.


pdf24-DocTool.exe -shellPrint [-printerName nameOfPrinter] file1 [file2] ...

Prints the input files on a printer. Uses the files print command of the windows shell.

-shellPrint

Tells the DocTool to print the files with the windows shell print command.

[-printerName nameOfPrinter]

Optional flag to print on a specific printer.

file1 [file2] ...

The files to print.


pdf24-DocTool.exe "<clipboard>"

Extract files from the windows clipboard and opens a PDF24 assistant to handle the files.

<clipboard>

Special file to tell the DocTool to import from windows clipboard.


pdf24-DocTool.exe "<twain>"

Imports files from the TWAIN interface (scanner or camery) and opens a PDF24 assistant to handle the files.

<twain>

Special file to tell the DocTool to import from TWAN interface


pdf24-DocTool.exe [-mode MODE] [-target TARGET] "<screen>"

Captures the screen. The capture mode and the target can be specified.

[-mode MODE]

Optional flag to set the capture mode. The mode can be one of the following:

[-target TARGET]

Optional flag to specify the target of the capture image. The target can be one of the following options:

FAQ

The PDF printer is not working properly. Print jobs are stuck in the print queue.

Sometimes it can happen, that the PDF printer is not working well. Most of the time it can be fixed by checking the following: