Watch xpdfrc - Configuration File for All Xpdf Utilities

Posted on
12,322 Points
1 Endorsement
Last Modified:
Experience Level: Intermediate
Joe Winograd
50+ years in computers
CIO•Document Imaging
EE — FELLOW 2017
MVE 2015,2016,2018
RENOWNED 2018,2019
This is the eleventh — and final — video of my Experts Exchange Micro Tutorials on the Xpdf utilities. The first video is an overview of the command line tools. The next nine videos are tutorials on all them:

PDFimages - Extract Images from PDF Files
PDFtoText - Convert PDF Files to Plain Text Files
PDFinfo - Retrieve Page Count and Other Information from PDF Files
PDFdetach - Detach Attachments from PDF Files
PDFtoPNG - Convert a Multi-page PDF File into Separate PNG Files
PDFfonts - List Fonts Used in a PDF File
PDFtoHTML - Convert a PDF File to HTML
PDFtoPPM - Convert a PDF File to PPM, PGM, PBM
PDFtoPS - Convert a PDF File to PS (PostScript)

This last video in the series discusses xpdfrc, which is the single configuration file that Xpdf uses for all nine utilities. It provides an enormous number of options, allowing extensive control of the tools, such as character mapping, font configuration, PostScript control, rasterizer settings, text control, and much more.

Video Steps

1. Download the software and fonts

You may have already downloaded the Xpdf tools while watching one of my earlier videos in the series, but there has since been an upgrade from Version 3 to Version 4 and there is a new download site:


Visit that site and download the pre-compiled Windows binary ZIP archive, then unzip it.

Download the Symbol and Zapf Dingbats fonts from the same page.


2. Locate the documentation folder for the Xpdf utilities

Go to the folder where you unzipped the downloaded ZIP file and find the doc folder.


3. Read the documentation for the configuration file - xpdfrc

Go into the doc folder and find the plain text file called xpdfrc.txt.

Open it with any text editor, such as Notepad, and read it. This is the documentation for the configuration file.


4. Review the sample configuration file

Go into the doc folder and find the plain text file called sample-xpdfrc.

Open it with any text editor, such as Notepad, and review it. This is a sample configuration file.


5. Set up a test folder

Create a test folder.

Copy these files into your test folder:

Copy a sample PDF file into your test folder.


6. Create the xpdfrc file

Using any text editor, such as Notepad, create a plain text file in your test folder and name it xpdfrc (without the .txt file extension) and put these two lines in it:

fontFile Symbol "s050000l.pfb"
fontFile ZapfDingbats "d050000l.pfb"


7. Run the PDFtoPPM and PDFtoPS utilities

Run the same commands as shown in my PDFtoPPM and PDFtoPS videos, which produced these font errors:
Config Error: No display font for 'Symbol'
Config Error: No display font for 'ZapfDingbats'

Confirm that the errors no longer occur — due to the fixes in the xpdfrc file.


8. Experiment with other features in the configuration file

That completes your first test of the xpdfrc configuration file. I encourage you to experiment with its many capabilities.

If you find this video to be helpful, please click the thumbs-up icon below.

Thank you for completing my Experts Exchange video Micro Tutorial series on the Xpdf utilities. I hope you've enjoyed watching it as much as I've enjoyed creating it. Regards, Joe
Many programming languages have a Switch–Case capability. Since its first beta in 2003, AutoHotkey has not had one. Finally, in the recent 28-Sep-2019 release of Version, it now has Switch–Case. This article discusses it and shows a sample…
The Get & Transform Data Wizard in Excel is a powerful tool. It allows the users to extract the data from the connected sources. But by delegating the privilege to users to access the connected sources, how could we ensure there is at least some deg…

Keep in touch with Experts Exchange

Tech news and trends delivered to your inbox every month