Skip to content
port of PDF fdfgen library for filling in PDF forms to Python
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
fdfgen Small modification to alter the encoding of data_field keynames, to a… Jul 6, 2019
tests fixed tests Feb 17, 2017
.gitignore ignore dist/build directories Feb 22, 2017
.travis.yml Test on python 3.7 Jun 25, 2019
LICENSE Fix license file formatting Oct 10, 2018 Added step 2 command to separate line Oct 10, 2018
requirements-tests.txt Update tox from 3.14.5 to 3.14.6 Mar 25, 2020
setup.cfg release 0.13.0 Apr 22, 2016
tox.ini Add python 3.6 and 3.7 to tox Oct 9, 2019


Build Status

Python port of the PHP forge_fdf library by Sid Steward

PDF forms work with FDF data. I ported a PHP FDF library to Python a while back when I had to do this and released it as fdfgen. I use that to generate an fdf file with the data for the form, then use pdftk to push the fdf into a PDF form and generate the output.


pip install fdfgen


  1. You (or a designer) design the form.pdf in Acrobat.

  2. Mark the form fields and take note of the field names. This can be done either through Acrobat or by installing pdftk and entering the command line

     pdftk [pdf name] dump_data_fields
  3. Let's say your form has fields "name" and "telephone".

    Use fdfgen to create a FDF file:

     #!/usr/bin/env python
     from fdfgen import forge_fdf
     fields = [('name', 'John Smith'), ('telephone', '555-1234')]
     fdf = forge_fdf("",fields,[],[],[])
     with open("data.fdf", "wb") as fdf_file:
  4. Then you run pdftk to merge and flatten:

    pdftk form.pdf fill_form data.fdf output output.pdf flatten

    and a filled out, flattened (meaning that there are no longer editable form fields) pdf will be in output.pdf.


  • 0.16.1 -- 2017-11-21 -- Fix TypeError in python 3.6 by Tom Grundy (@caver456)
  • 0.16.0 -- 2017-02-22 -- Allow for different values for each checkbox by
  • 0.15.0 -- 2016-09-23 -- Encode field names as UTF-16 fix by Andreas Pelme
  • 0.14.0 -- 2016-08-09 -- Adobe FDF Compatibility added by Cooper Stimson (@6C1)
  • 0.13.0 -- 2016-04-22 -- python 3 bugfix from Julien Enselme
  • 0.12.1 -- 2015-11-01 -- handle alternative checkbox values fix from Bil Bas
  • 0.12.0 -- 2015-07-29 -- python 3 bugfixes
  • 0.11.0 -- 2013-12-07 -- python 3 port from Evan Fredericksen
  • 0.10.2 -- 2013-06-16 -- minor code refactor and added command line options from Robert Stewart
  • 0.10.1 -- 2013-04-22 -- unbalanced paren bugfix from Brandon Rhodes
  • 0.10.0 -- 2012-06-14 -- support checkbox fields and parenthesis in strings from Guangcong Luo
  • 0.9.2 -- 2011-01-12 -- merged unicode fix from Sébastien Fievet


  • Create a virtual environment
  • tox is required to run the tests. You can install the correct version with pip install -r requirements-tests.txt
  • Run tox to run tests for all Python versions.
  • To run a specific test and specific Python versions, you may use tox -e py27 -- tests/
You can’t perform that action at this time.