1WEBPMUX(1) General Commands Manual WEBPMUX(1)
2
6 webpmux - create animated WebP files from non-animated WebP images,
7 extract frames from animated WebP images, and manage XMP/EXIF metadata
8 and ICC profile.
9
11 webpmux -get GET_OPTIONS INPUT -o OUTPUT
12 webpmux -set SET_OPTIONS INPUT -o OUTPUT
13 webpmux -strip STRIP_OPTIONS INPUT -o OUTPUT
14 webpmux -frame FRAME_OPTIONS [ -frame ... ] [ -loop LOOP_COUNT ]
15 [ -bgcolor BACKGROUND_COLOR ] -o OUTPUT
16 webpmux -duration DURATION OPTIONS [ -duration ... ] INPUT -o OUTPUT
17 webpmux -info INPUT
18 webpmux [-h|-help]
19 webpmux -version
20 webpmux argument_file_name
21
23 This manual page documents the webpmux command.
24 webpmux can be used to create/extract from animated WebP files, as well
26 as to add/extract/strip XMP/EXIF metadata and ICC profile. If a single
27 file name (not starting with the character '-') is supplied as the
28 argument, the command line arguments are actually tokenized from this
29 file. This allows for easy scripting or using large number of argu‐
30 ments.
31
33 GET_OPTIONS (-get):
34 icc Get ICC profile.
35 exif Get EXIF metadata.
37 xmp Get XMP metadata.
39 frame n
41 Get nth frame from an animated image. (n = 0 has a special mean‐
42 ing: last frame).
43 SET_OPTIONS (-set)
46 icc file.icc
47 Set ICC profile.
48 Where: 'file.icc' contains the ICC profile to be set.
50 exif file.exif
52 Set EXIF metadata.
53 Where: 'file.exif' contains the EXIF metadata to be set.
55 xmp file.xmp
57 Set XMP metadata.
58 Where: 'file.xmp' contains the XMP metadata to be set.
60 STRIP_OPTIONS (-strip)
63 icc Strip ICC profile.
64 exif Strip EXIF metadata.
66 xmp Strip XMP metadata.
68 DURATION_OPTIONS (-duration)
71 Amend the duration of a specific interval of frames. This option is
72 only effective on animated WebP and has no effect on a single-frame
73 file.
74 duration[,start[,end]]
76 Where:
77 duration is the duration for the interval in milliseconds
78 (mandatory). Must be non-negative.
79 start is the starting frame index of the interval (optional).
80 end is the ending frame index (inclusive) of the interval
81 (optional).
82 The three typical usages of this option are:
84 -duration d
85 set the duration to 'd' for the whole animation.
86 -duration d,f
87 set the duration of frame 'f' to 'd'.
88 -duration d,start,end
89 set the duration to 'd' for the whole [start,end] interval.
90 Note that the frames outside of the [start, end] interval will
93 remain untouched.
94 The 'end' value '0' has the special meaning 'last frame of the
95 animation'.
96 Reminder:
98 frame indexing starts at '1'.
99 FRAME_OPTIONS (-frame)
102 Create an animated WebP file from multiple (non-animated) WebP images.
103 file_i +di[+xi+yi[+mi[bi]]]
105 Where: 'file_i' is the i'th frame (WebP format), 'xi','yi' spec‐
106 ify the image offset for this frame, 'di' is the pause duration
107 before next frame, 'mi' is the dispose method for this frame (0
108 for NONE or 1 for BACKGROUND) and 'bi' is the blending method
109 for this frame (+b for BLEND or -b for NO_BLEND). Argument 'bi'
110 can be omitted and will default to +b (BLEND). Also, 'mi' can
111 be omitted if 'bi' is omitted and will default to 0 (NONE).
112 Finally, if 'mi' and 'bi' are omitted then 'xi' and 'yi' can be
113 omitted and will default to +0+0.
114 -loop n
116 Loop the frames n number of times. 0 indicates the frames should
117 loop forever. Valid range is 0 to 65535 [Default: 0 (infi‐
118 nite)].
119 -bgcolor A,R,G,B
121 Background color of the canvas.
122 where: 'A', 'R', 'G' and 'B' are integers in the range 0 to 255
123 specifying the Alpha, Red, Green and Blue component values
124 respectively [Default: 255,255,255,255].
125 INPUT
128 Input file in WebP format.
129 OUTPUT (-o)
132 Output file in WebP format.
133 Note:
136 The nature of EXIF, XMP and ICC data is not checked and is assumed to
137 be valid.
138
141 Please report all bugs to the issue tracker:
142 https://bugs.chromium.org/p/webp
143 Patches welcome! See this page to get started: http://www.webmpro‐
144 ject.org/code/contribute/submitting-patches/
145
148 Add ICC profile:
149 webpmux -set icc image_profile.icc in.webp -o icc_container.webp
150 Extract ICC profile:
152 webpmux -get icc icc_container.webp -o image_profile.icc
153 Strip ICC profile:
155 webpmux -strip icc icc_container.webp -o without_icc.webp
156 Add XMP metadata:
158 webpmux -set xmp image_metadata.xmp in.webp -o xmp_container.webp
159 Extract XMP metadata:
161 webpmux -get xmp xmp_container.webp -o image_metadata.xmp
162 Strip XMP metadata:
164 webpmux -strip xmp xmp_container.webp -o without_xmp.webp
165 Add EXIF metadata:
167 webpmux -set exif image_metadata.exif in.webp -o exif_container.webp
168 Extract EXIF metadata:
170 webpmux -get exif exif_container.webp -o image_metadata.exif
171 Strip EXIF metadata:
173 webpmux -strip exif exif_container.webp -o without_exif.webp
174 Create an animated WebP file from 3 (non-animated) WebP images:
176 webpmux -frame 1.webp +100 -frame 2.webp +100+50+50
177 -frame 3.webp +100+50+50+1+b -loop 10 -bgcolor 255,255,255,255
178 -o anim_container.webp
179 Get the 2nd frame from an animated WebP file:
181 webpmux -get frame 2 anim_container.webp -o frame_2.webp
182 Using -get/-set/-strip with input file name starting with '-':
184 webpmux -set icc image_profile.icc -o icc_container.webp -- ---in.webp
185 webpmux -get icc -o image_profile.icc -- ---icc_container.webp
186 webpmux -strip icc -o without_icc.webp -- ---icc_container.webp
187
190 webpmux is a part of libwebp and was written by the WebP team.
191 The latest source tree is available at https://chromium.google‐
192 source.com/webm/libwebp
193 This manual page was written by Vikas Arora <vikaas.arora@gmail.com>,
195 for the Debian project (and may be used by others).
196
199 cwebp(1), dwebp(1), gif2webp(1)
200 Please refer to http://developers.google.com/speed/webp/ for additional
201 information.
202 April 23, 2018 WEBPMUX(1)