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 a 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 loop loop_count
47 Set loop count on an animated file.
48 Where: 'loop_count' must be in range [0, 65535].
50 icc file.icc
52 Set ICC profile.
53 Where: 'file.icc' contains the ICC profile to be set.
55 exif file.exif
57 Set EXIF metadata.
58 Where: 'file.exif' contains the EXIF metadata to be set.
60 xmp file.xmp
62 Set XMP metadata.
63 Where: 'file.xmp' contains the XMP metadata to be set.
65 STRIP_OPTIONS (-strip)
68 icc Strip ICC profile.
69 exif Strip EXIF metadata.
71 xmp Strip XMP metadata.
73 DURATION_OPTIONS (-duration)
76 Amend the duration of a specific interval of frames. This option is
77 only effective on animated WebP and has no effect on a single-frame
78 file.
79 duration[,start[,end]]
81 Where:
82 duration is the duration for the interval in milliseconds
83 (mandatory). Must be non-negative.
84 start is the starting frame index of the interval (optional).
85 end is the ending frame index (inclusive) of the interval
86 (optional).
87 The three typical usages of this option are:
89 -duration d
90 set the duration to 'd' for the whole animation.
91 -duration d,f
92 set the duration of frame 'f' to 'd'.
93 -duration d,start,end
94 set the duration to 'd' for the whole [start,end] interval.
95 Note that the frames outside of the [start, end] interval will
98 remain untouched.
99 The 'end' value '0' has the special meaning 'last frame of the
100 animation'.
101 Reminder:
103 frame indexing starts at '1'.
104 FRAME_OPTIONS (-frame)
107 Create an animated WebP file from multiple (non-animated) WebP images.
108 file_i +di[+xi+yi[+mi[bi]]]
110 Where: 'file_i' is the i'th frame (WebP format), 'xi','yi' spec‐
111 ify the image offset for this frame, 'di' is the pause duration
112 before next frame, 'mi' is the dispose method for this frame (0
113 for NONE or 1 for BACKGROUND) and 'bi' is the blending method
114 for this frame (+b for BLEND or -b for NO_BLEND). Argument 'bi'
115 can be omitted and will default to +b (BLEND). Also, 'mi' can
116 be omitted if 'bi' is omitted and will default to 0 (NONE).
117 Finally, if 'mi' and 'bi' are omitted then 'xi' and 'yi' can be
118 omitted and will default to +0+0.
119 -loop n
121 Loop the frames n number of times. 0 indicates the frames should
122 loop forever. Valid range is 0 to 65535 [Default: 0 (infi‐
123 nite)].
124 -bgcolor A,R,G,B
126 Background color of the canvas.
127 where: 'A', 'R', 'G' and 'B' are integers in the range 0 to 255
128 specifying the Alpha, Red, Green and Blue component values
129 respectively [Default: 255,255,255,255].
130 INPUT
133 Input file in WebP format.
134 OUTPUT (-o)
137 Output file in WebP format.
138 Note:
141 The nature of EXIF, XMP and ICC data is not checked and is assumed to
142 be valid.
143
146 Please report all bugs to the issue tracker:
147 https://bugs.chromium.org/p/webp
148 Patches welcome! See this page to get started: http://www.webmpro‐
149 ject.org/code/contribute/submitting-patches/
150
153 Add ICC profile:
154 webpmux -set icc image_profile.icc in.webp -o icc_container.webp
155 Extract ICC profile:
157 webpmux -get icc icc_container.webp -o image_profile.icc
158 Strip ICC profile:
160 webpmux -strip icc icc_container.webp -o without_icc.webp
161 Add XMP metadata:
163 webpmux -set xmp image_metadata.xmp in.webp -o xmp_container.webp
164 Extract XMP metadata:
166 webpmux -get xmp xmp_container.webp -o image_metadata.xmp
167 Strip XMP metadata:
169 webpmux -strip xmp xmp_container.webp -o without_xmp.webp
170 Add EXIF metadata:
172 webpmux -set exif image_metadata.exif in.webp -o exif_container.webp
173 Extract EXIF metadata:
175 webpmux -get exif exif_container.webp -o image_metadata.exif
176 Strip EXIF metadata:
178 webpmux -strip exif exif_container.webp -o without_exif.webp
179 Create an animated WebP file from 3 (non-animated) WebP images:
181 webpmux -frame 1.webp +100 -frame 2.webp +100+50+50
182 -frame 3.webp +100+50+50+1+b -loop 10 -bgcolor 255,255,255,255
183 -o anim_container.webp
184 Get the 2nd frame from an animated WebP file:
186 webpmux -get frame 2 anim_container.webp -o frame_2.webp
187 Using -get/-set/-strip with input file name starting with '-':
189 webpmux -set icc image_profile.icc -o icc_container.webp -- ---in.webp
190 webpmux -get icc -o image_profile.icc -- ---icc_container.webp
191 webpmux -strip icc -o without_icc.webp -- ---icc_container.webp
192
195 webpmux is a part of libwebp and was written by the WebP team.
196 The latest source tree is available at https://chromium.google‐
197 source.com/webm/libwebp
198 This manual page was written by Vikas Arora <vikaas.arora@gmail.com>,
200 for the Debian project (and may be used by others).
201
204 cwebp(1), dwebp(1), gif2webp(1)
205 Please refer to http://developers.google.com/speed/webp/ for additional
206 information.
207 December 12, 2020 WEBPMUX(1)