Optimize

Optimize inFile by getting rid of redundant page resources like embedded fonts and images and write the result to outFile maxing out PDF compression. Have a look at some examples.

Usage

  1. pdfcpu optimize [-v(erbose)|vv] [-stats csvFile] [-upw userpw] [-opw ownerpw] inFile [outFile]

Flags

namedescriptionrequired
verboseturn on loggingno
vvverbose loggingno
statsCSV output fileno
upwuser passwordno
opwowner passwordno

Arguments

namedescriptionrequireddefault
inFilePDF input fileyes
outFilePDF output filenoinFile_new.pdf

Stats

The name of a CSV file name.This command appends one CSV line with stats about memory usage, PDF object usage and other useful information for debugging.Optimize a group of PDF input files and consolidate stats into the same CSV file for comparison.

The following shows a stats file with its header line and a single stats line:

  1. cat stats.csv
  2. name;version;author;creator;producer;src_size (bin|text);src_bin:imgs|fonts|other;dest_size (bin|text);dest_bin:imgs|fonts|other;linearized;hybrid;xrefstr;objstr;pages;objs;missing;garbage;R_Version;R_Extensions;R_PageLabels;R_Names;R_Dests;R_ViewerPrefs;R_PageLayout;R_PageMode;R_Outlines;R_Threads;R_OpenAction;R_AA;R_URI;R_AcroForm;R_Metadata;R_StructTreeRoot;R_MarkInfo;R_Lang;R_SpiderInfo;R_OutputIntents;R_PieceInfo;R_OCProperties;R_Perms;R_Legal;R_Requirements;R_Collection;R_NeedsRendering;P_LastModified;P_Resources;P_MediaBox;P_CropBox;P_BleedBox;P_TrimBox;P_ArtBox;P_BoxColorInfo;P_Contents;P_Rotate;P_Group;P_Thumb;P_B;P_Dur;P_Trans;P_Annots;P_AA;P_Metadata;P_PieceInfo;P_StructParents;P_ID;P_PZ;P_SeparationInfo;P_Tabs;P_TemplateInstantiated;P_PresSteps;P_UserUnit;P_VP;
  3. test.pdf;1.2;;;;6 KB (67.4% | 32.6%); 0.0% |  0.0% | 100.0%;5 KB (86.6% | 13.4%); 0.0% |  0.0% | 100.0%;false;false;false;false;2;15;;;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;true;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false;false

Examples

Optimize test.pdf and write the result to test_new.pdf:

  1. pdfcpu optimize test.pdf
  2. writing test_new.pdf ...

Optimize test.pdf and write the result to test_opt.pdf:

  1. pdfcpu optimize test.pdf test_opt.pdf
  2. writing test_opt.pdf ...

Optimize test.pdf, write the result to test_opt.pdf, append stats to stats.csv and produce logging on standard out:

  1. pdfcpu optimize -verbose -stats stats.csv test.pdf test_opt.pdf
  2. stats will be appended to stats.csv
  3.  INFO: 2019/02/20 23:20:12 reading upc.pdf..
  4.  INFO: 2019/02/20 23:20:12 PDF Version 1.5 conforming reader
  5.  INFO: 2019/02/20 23:20:12 validating
  6.  INFO: 2019/02/20 23:20:12 optimizing fonts & images
  7. STATS: 2019/02/20 23:20:12 XRefTable:
  8. *************************************************************************************************
  9. HeaderVersion: 1.2
  10. has 2 pages
  11. XRefTable:
  12.                      Size: 13
  13.               Root object: (11 0 R)
  14.               Info object: (12 0 R)
  15.                 ID object: [<81C4A57DF6A1E411BD62885083B053CD> <81C4A57DF6A1E411BD62885083B053CD>]
  16. XRefTable with 13 entres:
  17.     0: f   next=       0 generation=65535
  18.     1:   offset=      16 generation=0 pdfcpu.Dict type=Page
  19. <<
  20.     <Contents, (2 0 R)>
  21.     <Parent, (3 0 R)>
  22.     <Resources, (4 0 R)>
  23.     <Type, Page>
  24. >>
  25.     2:   offset=     102 generation=0 pdfcpu.StreamDict
  26. <<
  27.     <Filter, LZWDecode>
  28.     <Length, 2652>
  29. >>
  30.     3:   offset=    5117 generation=0 pdfcpu.Dict type=Pages
  31. <<
  32.     <Count, 2>
  33.     <Kids, [(1 0 R) (8 0 R)]>
  34.     <MediaBox, [0 0 595.27 841.89]>
  35.     <Type, Pages>
  36. >>
  37.     4:   offset=    2828 generation=0 pdfcpu.Dict
  38. <<
  39.     <ColorSpace, <<
  40.         <CS1, DeviceRGB>
  41.     >>>
  42.     <Font, <<
  43.         <G1F18, (6 0 R)>
  44.         <G1F3, (5 0 R)>
  45.         <G1F6, (7 0 R)>
  46.     >>>
  47.     <ProcSet, [PDF Text]>
  48. >>
  49.     5:   offset=    4942 generation=0 pdfcpu.Dict type=Font subType=Type1
  50. <<
  51.     <BaseFont, Helvetica>
  52.     <Encoding, <<
  53.         <BaseEncoding, WinAnsiEncoding>
  54.         <Differences, [45 minus]>
  55.         <Type, Encoding>
  56.     >>>
  57.     <Name, G1F3>
  58.     <Subtype, Type1>
  59.     <Type, Font>
  60. >>
  61.     6:   offset=    4761 generation=0 pdfcpu.Dict type=Font subType=Type1
  62. <<
  63.     <BaseFont, Helvetica-Bold>
  64.     <Encoding, <<
  65.         <BaseEncoding, WinAnsiEncoding>
  66.         <Differences, [45 minus]>
  67.         <Type, Encoding>
  68.     >>>
  69.     <Name, G1F18>
  70.     <Subtype, Type1>
  71.     <Type, Font>
  72. >>
  73.     7:   offset=    4578 generation=0 pdfcpu.Dict type=Font subType=Type1
  74. <<
  75.     <BaseFont, Helvetica-Oblique>
  76.     <Encoding, <<
  77.         <BaseEncoding, WinAnsiEncoding>
  78.         <Differences, [45 minus]>
  79.         <Type, Encoding>
  80.     >>>
  81.     <Name, G1F6>
  82.     <Subtype, Type1>
  83.     <Type, Font>
  84. >>
  85.     8:   offset=    2964 generation=0 pdfcpu.Dict type=Page
  86. <<
  87.     <Contents, (9 0 R)>
  88.     <Parent, (3 0 R)>
  89.     <Resources, (10 0 R)>
  90.     <Type, Page>
  91. >>
  92.     9:   offset=    3051 generation=0 pdfcpu.StreamDict
  93. <<
  94.     <Filter, LZWDecode>
  95.     <Length, 1316>
  96. >>
  97.    10:   offset=    4441 generation=0 pdfcpu.Dict
  98. <<
  99.     <ColorSpace, <<
  100.         <CS1, DeviceRGB>
  101.     >>>
  102.     <Font, <<
  103.         <G1F18, (6 0 R)>
  104.         <G1F3, (5 0 R)>
  105.         <G1F6, (7 0 R)>
  106.     >>>
  107.     <ProcSet, [PDF Text]>
  108. >>
  109.    11:   offset=    5218 generation=0 pdfcpu.Dict type=Catalog
  110. <<
  111.     <Pages, (3 0 R)>
  112.     <Type, Catalog>
  113. >>
  114.    12:   offset=    5272 generation=0 pdfcpu.Dict
  115. <<
  116.     <Author, ()>
  117.     <CreationDate, (D:20150122062117)>
  118.     <Creator, ()>
  119.     <Keywords, ()>
  120.     <Producer, ()>
  121.     <Subject, ()>
  122.     <Title, (Test)>
  123. >>
  125. Empty free list.
  127. Total pages: 2
  129. Fonts for page 1:
  130. obj     prefix     Fontname                       Subtype    Encoding             Embedded ResourceIds
  131. #5                 Helvetica                      Type1      Custom               false    G1F3
  132. #6                 Helvetica-Bold                 Type1      Custom               false    G1F18
  133. #7                 Helvetica-Oblique              Type1      Custom               false    G1F6
  135. Fonts for page 2:
  136. obj     prefix     Fontname                       Subtype    Encoding             Embedded ResourceIds
  137. #5                 Helvetica                      Type1      Custom               false    G1F3
  138. #6                 Helvetica-Bold                 Type1      Custom               false    G1F18
  139. #7                 Helvetica-Oblique              Type1      Custom               false    G1F6
  141. Fontobjects:
  142. obj     prefix     Fontname                       Subtype    Encoding             Embedded ResourceIds
  143. #5                 Helvetica                      Type1      Custom               false    G1F3
  144. #6                 Helvetica-Bold                 Type1      Custom               false    G1F18
  145. #7                 Helvetica-Oblique              Type1      Custom               false    G1F6
  147. Fonts:
  148. obj     prefix     Fontname                       Subtype    Encoding             Embedded ResourceIds
  149. #5                 Helvetica                      Type1      Custom               false    G1F3
  150. #6                 Helvetica-Bold                 Type1      Custom               false    G1F18
  151. #7                 Helvetica-Oblique              Type1      Custom               false    G1F6
  153. Duplicate Fonts:
  156. No image info available.
  159. writing test_opt.pdf ...
  160.  INFO: 2019/02/20 23:20:12 writing to a.pdf
  161. STATS: 2019/02/20 23:20:12 0 original empty xref entries:
  162. STATS: 2019/02/20 23:20:12 0 original redundant font entries:
  163. STATS: 2019/02/20 23:20:12 0 original redundant image entries:
  164. STATS: 2019/02/20 23:20:12 0 original redundant info entries:
  165. STATS: 2019/02/20 23:20:12 0 original objectStream entries:
  166. STATS: 2019/02/20 23:20:12 0 original xrefStream entries:
  167. STATS: 2019/02/20 23:20:12 0 original linearization entries:
  168. STATS: 2019/02/20 23:20:12 XRefTable:
  169. *************************************************************************************************
  170. HeaderVersion: 1.2
  171. has 2 pages
  172. XRefTable:
  173.                      Size: 15
  174.               Root object: (11 0 R)
  175.               Info object: (12 0 R)
  176.                 ID object: [<81C4A57DF6A1E411BD62885083B053CD> <e4fcab0bb584b4b8d4f5fad43fd63b03>]
  177. XRefTable with 15 entres:
  178.     0: f   next=       0 generation=65535
  179.     1: c => obj:13[0] generation=0
  180. <<
  181.     <Contents, (2 0 R)>
  182.     <Parent, (3 0 R)>
  183.     <Resources, (4 0 R)>
  184.     <Type, Page>
  185. >>
  186.     2:   offset=     102 generation=0 pdfcpu.StreamDict
  187. <<
  188.     <Filter, LZWDecode>
  189.     <Length, 2652>
  190. >>
  191.     3: c => obj:13[7] generation=0
  192. <<
  193.     <Count, 2>
  194.     <Kids, [(1 0 R) (8 0 R)]>
  195.     <MediaBox, [0 0 595.27 841.89]>
  196.     <Type, Pages>
  197. >>
  198.     4: c => obj:13[1] generation=0
  199. <<
  200.     <ColorSpace, <<
  201.         <CS1, DeviceRGB>
  202.     >>>
  203.     <Font, <<
  204.         <G1F18, (6 0 R)>
  205.         <G1F3, (5 0 R)>
  206.         <G1F6, (7 0 R)>
  207.     >>>
  208.     <ProcSet, [PDF Text]>
  209. >>
  210.     5: c => obj:13[2] generation=0
  211. <<
  212.     <BaseFont, Helvetica>
  213.     <Encoding, <<
  214.         <BaseEncoding, WinAnsiEncoding>
  215.         <Differences, [45 minus]>
  216.         <Type, Encoding>
  217.     >>>
  218.     <Name, G1F3>
  219.     <Subtype, Type1>
  220.     <Type, Font>
  221. >>
  222.     6: c => obj:13[4] generation=0
  223. <<
  224.     <BaseFont, Helvetica-Bold>
  225.     <Encoding, <<
  226.         <BaseEncoding, WinAnsiEncoding>
  227.         <Differences, [45 minus]>
  228.         <Type, Encoding>
  229.     >>>
  230.     <Name, G1F18>
  231.     <Subtype, Type1>
  232.     <Type, Font>
  233. >>
  234.     7: c => obj:13[3] generation=0
  235. <<
  236.     <BaseFont, Helvetica-Oblique>
  237.     <Encoding, <<
  238.         <BaseEncoding, WinAnsiEncoding>
  239.         <Differences, [45 minus]>
  240.         <Type, Encoding>
  241.     >>>
  242.     <Name, G1F6>
  243.     <Subtype, Type1>
  244.     <Type, Font>
  245. >>
  246.     8: c => obj:13[5] generation=0
  247. <<
  248.     <Contents, (9 0 R)>
  249.     <Parent, (3 0 R)>
  250.     <Resources, (10 0 R)>
  251.     <Type, Page>
  252. >>
  253.     9:   offset=    3051 generation=0 pdfcpu.StreamDict
  254. <<
  255.     <Filter, LZWDecode>
  256.     <Length, 1316>
  257. >>
  258.    10: c => obj:13[6] generation=0
  259. <<
  260.     <ColorSpace, <<
  261.         <CS1, DeviceRGB>
  262.     >>>
  263.     <Font, <<
  264.         <G1F18, (6 0 R)>
  265.         <G1F3, (5 0 R)>
  266.         <G1F6, (7 0 R)>
  267.     >>>
  268.     <ProcSet, [PDF Text]>
  269. >>
  270.    11:   offset=    5218 generation=0 pdfcpu.Dict type=Catalog
  271. <<
  272.     <Pages, (3 0 R)>
  273.     <Type, Catalog>
  274. >>
  275.    12:   offset=    5272 generation=0 pdfcpu.Dict
  276. <<
  277.     <Author, ()>
  278.     <CreationDate, (D:20190220232012+01'00')>
  279.     <Creator, ()>
  280.     <Keywords, ()>
  281.     <ModDate, (D:20190220232012+01'00')>
  282.     <Producer, (pdfcpu v0.1.21)>
  283.     <Subject, ()>
  284.     <Title, ()>
  285. >>
  286.    13:   offset=nil generation=0 pdfcpu.ObjectStreamDict
  287. <<
  288.     <Filter, FlateDecode>
  289.     <First, 45>
  290.     <Length, 327>
  291.     <N, 8>
  292.     <Type, ObjStm>
  293. >>
  294. object stream count:8 size of objectarray:0
  295.    14:   offset=nil generation=0 pdfcpu.XRefStreamDict
  296. <<
  297.     <Filter, FlateDecode>
  298.     <ID, [<81C4A57DF6A1E411BD62885083B053CD> <e4fcab0bb584b4b8d4f5fad43fd63b03>]>
  299.     <Index, [0 14]>
  300.     <Info, (12 0 R)>
  301.     <Length, 63>
  302.     <Root, (11 0 R)>
  303.     <Size, 15>
  304.     <Type, XRef>
  305.     <W, [1 2 2]>
  306. >>
  308. Empty free list.
  310. Total pages: 2
  312. Fonts for page 1:
  313. obj     prefix     Fontname                       Subtype    Encoding             Embedded ResourceIds
  314. #5                 Helvetica                      Type1      Custom               false    G1F3
  315. #6                 Helvetica-Bold                 Type1      Custom               false    G1F18
  316. #7                 Helvetica-Oblique              Type1      Custom               false    G1F6
  318. Fonts for page 2:
  319. obj     prefix     Fontname                       Subtype    Encoding             Embedded ResourceIds
  320. #5                 Helvetica                      Type1      Custom               false    G1F3
  321. #6                 Helvetica-Bold                 Type1      Custom               false    G1F18
  322. #7                 Helvetica-Oblique              Type1      Custom               false    G1F6
  324. Fontobjects:
  325. obj     prefix     Fontname                       Subtype    Encoding             Embedded ResourceIds
  326. #5                 Helvetica                      Type1      Custom               false    G1F3
  327. #6                 Helvetica-Bold                 Type1      Custom               false    G1F18
  328. #7                 Helvetica-Oblique              Type1      Custom               false    G1F6
  330. Fonts:
  331. obj     prefix     Fontname                       Subtype    Encoding             Embedded ResourceIds
  332. #5                 Helvetica                      Type1      Custom               false    G1F3
  333. #6                 Helvetica-Bold                 Type1      Custom               false    G1F18
  334. #7                 Helvetica-Oblique              Type1      Custom               false    G1F6
  336. Duplicate Fonts:
  339. No image info available.
  342. STATS: 2019/02/20 23:20:12 Timing:
  343. STATS: 2019/02/20 23:20:12 read                 :  0.001s  28.7%
  344. STATS: 2019/02/20 23:20:12 validate             :  0.000s   4.5%
  345. STATS: 2019/02/20 23:20:12 optimize             :  0.000s   1.1%
  346. STATS: 2019/02/20 23:20:12 write                :  0.002s  48.8%
  347. STATS: 2019/02/20 23:20:12 total processing time:  0.003s
  349. STATS: 2019/02/20 23:20:12 Original:
  350. STATS: 2019/02/20 23:20:12 File Size            : 6 KB (5884 bytes)
  351. STATS: 2019/02/20 23:20:12 Total Binary Data    : 4 KB (3968 bytes) 67.4%
  352. STATS: 2019/02/20 23:20:12 Total Text   Data    : 2 KB (1916 bytes) 32.6%
  354. STATS: 2019/02/20 23:20:12 Breakup of binary data:
  355. STATS: 2019/02/20 23:20:12 images               : 0.000000 Bytes (0 bytes)  0.0%
  356. STATS: 2019/02/20 23:20:12 fonts                : 0.000000 Bytes (0 bytes)  0.0%
  357. STATS: 2019/02/20 23:20:12 other                : 4 KB (3968 bytes) 100.0%
  359. STATS: 2019/02/20 23:20:12 Optimized:
  360. STATS: 2019/02/20 23:20:12 File Size            : 5 KB (5034 bytes)
  361. STATS: 2019/02/20 23:20:12 Total Binary Data    : 4 KB (4358 bytes) 86.6%
  362. STATS: 2019/02/20 23:20:12 Total Text   Data    : 676.000000 Bytes (676 bytes) 13.4%
  364. STATS: 2019/02/20 23:20:12 Breakup of binary data:
  365. STATS: 2019/02/20 23:20:12 images               : 0.000000 Bytes (0 bytes)  0.0%
  366. STATS: 2019/02/20 23:20:12 fonts                : 0.000000 Bytes (0 bytes)  0.0%
  367. STATS: 2019/02/20 23:20:12 other                : 4 KB (4358 bytes) 100.0%