pdfcpu
A PDF processor written in Go.
View the Project on GitHub pdfcpu/pdfcpu
Changelog
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
pdfcpu optimize [-stats csvFile] inFile [outFile]
Flags
| name | description | required |
|---|---|---|
| stats | CSV output file | no |
Common Flags
| name | description | values |
|---|---|---|
| v(erbose) | turn on logging | |
| vv | verbose logging | |
| q(uiet) | quiet mode | |
| u(nit) | display unit | po(ints),in(ches),cm,mm |
| c(onf) | config dir | $path, disable |
| upw | user password | |
| opw | owner password |
Arguments
| name | description | required | default |
|---|---|---|---|
| inFile | PDF input file | yes | |
| outFile | PDF output file | no | inFile |
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:
$ cat stats.csv
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;
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:
$ pdfcpu optimize test.pdf
writing test_new.pdf ...
Optimize test.pdf and write the result to test_opt.pdf:
$ pdfcpu optimize test.pdf test_opt.pdf
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:
$ pdfcpu optimize -verbose -stats stats.csv test.pdf test_opt.pdf
stats will be appended to stats.csv
INFO: 2019/02/20 23:20:12 reading upc.pdf..
INFO: 2019/02/20 23:20:12 PDF Version 1.5 conforming reader
INFO: 2019/02/20 23:20:12 validating
INFO: 2019/02/20 23:20:12 optimizing fonts & images
STATS: 2019/02/20 23:20:12 XRefTable:
*************************************************************************************************
HeaderVersion: 1.2
has 2 pages
XRefTable:
Size: 13
Root object: (11 0 R)
Info object: (12 0 R)
ID object: [<81C4A57DF6A1E411BD62885083B053CD> <81C4A57DF6A1E411BD62885083B053CD>]
XRefTable with 13 entres:
0: f next= 0 generation=65535
1: offset= 16 generation=0 pdfcpu.Dict type=Page
<<
<Contents, (2 0 R)>
<Parent, (3 0 R)>
<Resources, (4 0 R)>
<Type, Page>
>>
2: offset= 102 generation=0 pdfcpu.StreamDict
<<
<Filter, LZWDecode>
<Length, 2652>
>>
3: offset= 5117 generation=0 pdfcpu.Dict type=Pages
<<
<Count, 2>
<Kids, [(1 0 R) (8 0 R)]>
<MediaBox, [0 0 595.27 841.89]>
<Type, Pages>
>>
4: offset= 2828 generation=0 pdfcpu.Dict
<<
<ColorSpace, <<
<CS1, DeviceRGB>
>>>
<Font, <<
<G1F18, (6 0 R)>
<G1F3, (5 0 R)>
<G1F6, (7 0 R)>
>>>
<ProcSet, [PDF Text]>
>>
5: offset= 4942 generation=0 pdfcpu.Dict type=Font subType=Type1
<<
<BaseFont, Helvetica>
<Encoding, <<
<BaseEncoding, WinAnsiEncoding>
<Differences, [45 minus]>
<Type, Encoding>
>>>
<Name, G1F3>
<Subtype, Type1>
<Type, Font>
>>
6: offset= 4761 generation=0 pdfcpu.Dict type=Font subType=Type1
<<
<BaseFont, Helvetica-Bold>
<Encoding, <<
<BaseEncoding, WinAnsiEncoding>
<Differences, [45 minus]>
<Type, Encoding>
>>>
<Name, G1F18>
<Subtype, Type1>
<Type, Font>
>>
7: offset= 4578 generation=0 pdfcpu.Dict type=Font subType=Type1
<<
<BaseFont, Helvetica-Oblique>
<Encoding, <<
<BaseEncoding, WinAnsiEncoding>
<Differences, [45 minus]>
<Type, Encoding>
>>>
<Name, G1F6>
<Subtype, Type1>
<Type, Font>
>>
8: offset= 2964 generation=0 pdfcpu.Dict type=Page
<<
<Contents, (9 0 R)>
<Parent, (3 0 R)>
<Resources, (10 0 R)>
<Type, Page>
>>
9: offset= 3051 generation=0 pdfcpu.StreamDict
<<
<Filter, LZWDecode>
<Length, 1316>
>>
10: offset= 4441 generation=0 pdfcpu.Dict
<<
<ColorSpace, <<
<CS1, DeviceRGB>
>>>
<Font, <<
<G1F18, (6 0 R)>
<G1F3, (5 0 R)>
<G1F6, (7 0 R)>
>>>
<ProcSet, [PDF Text]>
>>
11: offset= 5218 generation=0 pdfcpu.Dict type=Catalog
<<
<Pages, (3 0 R)>
<Type, Catalog>
>>
12: offset= 5272 generation=0 pdfcpu.Dict
<<
<Author, ()>
<CreationDate, (D:20150122062117)>
<Creator, ()>
<Keywords, ()>
<Producer, ()>
<Subject, ()>
<Title, (Test)>
>>
Empty free list.
Total pages: 2
Fonts for page 1:
obj prefix Fontname Subtype Encoding Embedded ResourceIds
#5 Helvetica Type1 Custom false G1F3
#6 Helvetica-Bold Type1 Custom false G1F18
#7 Helvetica-Oblique Type1 Custom false G1F6
Fonts for page 2:
obj prefix Fontname Subtype Encoding Embedded ResourceIds
#5 Helvetica Type1 Custom false G1F3
#6 Helvetica-Bold Type1 Custom false G1F18
#7 Helvetica-Oblique Type1 Custom false G1F6
Fontobjects:
obj prefix Fontname Subtype Encoding Embedded ResourceIds
#5 Helvetica Type1 Custom false G1F3
#6 Helvetica-Bold Type1 Custom false G1F18
#7 Helvetica-Oblique Type1 Custom false G1F6
Fonts:
obj prefix Fontname Subtype Encoding Embedded ResourceIds
#5 Helvetica Type1 Custom false G1F3
#6 Helvetica-Bold Type1 Custom false G1F18
#7 Helvetica-Oblique Type1 Custom false G1F6
Duplicate Fonts:
No image info available.
writing test_opt.pdf ...
INFO: 2019/02/20 23:20:12 writing to a.pdf
STATS: 2019/02/20 23:20:12 0 original empty xref entries:
STATS: 2019/02/20 23:20:12 0 original redundant font entries:
STATS: 2019/02/20 23:20:12 0 original redundant image entries:
STATS: 2019/02/20 23:20:12 0 original redundant info entries:
STATS: 2019/02/20 23:20:12 0 original objectStream entries:
STATS: 2019/02/20 23:20:12 0 original xrefStream entries:
STATS: 2019/02/20 23:20:12 0 original linearization entries:
STATS: 2019/02/20 23:20:12 XRefTable:
*************************************************************************************************
HeaderVersion: 1.2
has 2 pages
XRefTable:
Size: 15
Root object: (11 0 R)
Info object: (12 0 R)
ID object: [<81C4A57DF6A1E411BD62885083B053CD> <e4fcab0bb584b4b8d4f5fad43fd63b03>]
XRefTable with 15 entres:
0: f next= 0 generation=65535
1: c => obj:13[0] generation=0
<<
<Contents, (2 0 R)>
<Parent, (3 0 R)>
<Resources, (4 0 R)>
<Type, Page>
>>
2: offset= 102 generation=0 pdfcpu.StreamDict
<<
<Filter, LZWDecode>
<Length, 2652>
>>
3: c => obj:13[7] generation=0
<<
<Count, 2>
<Kids, [(1 0 R) (8 0 R)]>
<MediaBox, [0 0 595.27 841.89]>
<Type, Pages>
>>
4: c => obj:13[1] generation=0
<<
<ColorSpace, <<
<CS1, DeviceRGB>
>>>
<Font, <<
<G1F18, (6 0 R)>
<G1F3, (5 0 R)>
<G1F6, (7 0 R)>
>>>
<ProcSet, [PDF Text]>
>>
5: c => obj:13[2] generation=0
<<
<BaseFont, Helvetica>
<Encoding, <<
<BaseEncoding, WinAnsiEncoding>
<Differences, [45 minus]>
<Type, Encoding>
>>>
<Name, G1F3>
<Subtype, Type1>
<Type, Font>
>>
6: c => obj:13[4] generation=0
<<
<BaseFont, Helvetica-Bold>
<Encoding, <<
<BaseEncoding, WinAnsiEncoding>
<Differences, [45 minus]>
<Type, Encoding>
>>>
<Name, G1F18>
<Subtype, Type1>
<Type, Font>
>>
7: c => obj:13[3] generation=0
<<
<BaseFont, Helvetica-Oblique>
<Encoding, <<
<BaseEncoding, WinAnsiEncoding>
<Differences, [45 minus]>
<Type, Encoding>
>>>
<Name, G1F6>
<Subtype, Type1>
<Type, Font>
>>
8: c => obj:13[5] generation=0
<<
<Contents, (9 0 R)>
<Parent, (3 0 R)>
<Resources, (10 0 R)>
<Type, Page>
>>
9: offset= 3051 generation=0 pdfcpu.StreamDict
<<
<Filter, LZWDecode>
<Length, 1316>
>>
10: c => obj:13[6] generation=0
<<
<ColorSpace, <<
<CS1, DeviceRGB>
>>>
<Font, <<
<G1F18, (6 0 R)>
<G1F3, (5 0 R)>
<G1F6, (7 0 R)>
>>>
<ProcSet, [PDF Text]>
>>
11: offset= 5218 generation=0 pdfcpu.Dict type=Catalog
<<
<Pages, (3 0 R)>
<Type, Catalog>
>>
12: offset= 5272 generation=0 pdfcpu.Dict
<<
<Author, ()>
<CreationDate, (D:20190220232012+01'00')>
<Creator, ()>
<Keywords, ()>
<ModDate, (D:20190220232012+01'00')>
<Producer, (pdfcpu v0.1.21)>
<Subject, ()>
<Title, ()>
>>
13: offset=nil generation=0 pdfcpu.ObjectStreamDict
<<
<Filter, FlateDecode>
<First, 45>
<Length, 327>
<N, 8>
<Type, ObjStm>
>>
object stream count:8 size of objectarray:0
14: offset=nil generation=0 pdfcpu.XRefStreamDict
<<
<Filter, FlateDecode>
<ID, [<81C4A57DF6A1E411BD62885083B053CD> <e4fcab0bb584b4b8d4f5fad43fd63b03>]>
<Index, [0 14]>
<Info, (12 0 R)>
<Length, 63>
<Root, (11 0 R)>
<Size, 15>
<Type, XRef>
<W, [1 2 2]>
>>
Empty free list.
Total pages: 2
Fonts for page 1:
obj prefix Fontname Subtype Encoding Embedded ResourceIds
#5 Helvetica Type1 Custom false G1F3
#6 Helvetica-Bold Type1 Custom false G1F18
#7 Helvetica-Oblique Type1 Custom false G1F6
Fonts for page 2:
obj prefix Fontname Subtype Encoding Embedded ResourceIds
#5 Helvetica Type1 Custom false G1F3
#6 Helvetica-Bold Type1 Custom false G1F18
#7 Helvetica-Oblique Type1 Custom false G1F6
Fontobjects:
obj prefix Fontname Subtype Encoding Embedded ResourceIds
#5 Helvetica Type1 Custom false G1F3
#6 Helvetica-Bold Type1 Custom false G1F18
#7 Helvetica-Oblique Type1 Custom false G1F6
Fonts:
obj prefix Fontname Subtype Encoding Embedded ResourceIds
#5 Helvetica Type1 Custom false G1F3
#6 Helvetica-Bold Type1 Custom false G1F18
#7 Helvetica-Oblique Type1 Custom false G1F6
Duplicate Fonts:
No image info available.
STATS: 2019/02/20 23:20:12 Timing:
STATS: 2019/02/20 23:20:12 read : 0.001s 28.7%
STATS: 2019/02/20 23:20:12 validate : 0.000s 4.5%
STATS: 2019/02/20 23:20:12 optimize : 0.000s 1.1%
STATS: 2019/02/20 23:20:12 write : 0.002s 48.8%
STATS: 2019/02/20 23:20:12 total processing time: 0.003s
STATS: 2019/02/20 23:20:12 Original:
STATS: 2019/02/20 23:20:12 File Size : 6 KB (5884 bytes)
STATS: 2019/02/20 23:20:12 Total Binary Data : 4 KB (3968 bytes) 67.4%
STATS: 2019/02/20 23:20:12 Total Text Data : 2 KB (1916 bytes) 32.6%
STATS: 2019/02/20 23:20:12 Breakup of binary data:
STATS: 2019/02/20 23:20:12 images : 0.000000 Bytes (0 bytes) 0.0%
STATS: 2019/02/20 23:20:12 fonts : 0.000000 Bytes (0 bytes) 0.0%
STATS: 2019/02/20 23:20:12 other : 4 KB (3968 bytes) 100.0%
STATS: 2019/02/20 23:20:12 Optimized:
STATS: 2019/02/20 23:20:12 File Size : 5 KB (5034 bytes)
STATS: 2019/02/20 23:20:12 Total Binary Data : 4 KB (4358 bytes) 86.6%
STATS: 2019/02/20 23:20:12 Total Text Data : 676.000000 Bytes (676 bytes) 13.4%
STATS: 2019/02/20 23:20:12 Breakup of binary data:
STATS: 2019/02/20 23:20:12 images : 0.000000 Bytes (0 bytes) 0.0%
STATS: 2019/02/20 23:20:12 fonts : 0.000000 Bytes (0 bytes) 0.0%
STATS: 2019/02/20 23:20:12 other : 4 KB (4358 bytes) 100.0%