WEBPMUX(1)                              General Commands Manual                              WEBPMUX(1)

NAME
       webpmux - create animated WebP files from non-animated WebP images, extract frames from animated
       WebP images, and manage XMP/EXIF metadata and ICC profile.

SYNOPSIS
       webpmux -get GET_OPTIONS INPUT -o OUTPUT
       webpmux -set SET_OPTIONS INPUT -o OUTPUT
       webpmux -strip STRIP_OPTIONS INPUT -o OUTPUT
       webpmux -frame FRAME_OPTIONS [ -frame ... ] [ -loop LOOP_COUNT ]
               [ -bgcolor BACKGROUND_COLOR ] -o OUTPUT
       webpmux -duration DURATION OPTIONS [ -duration ... ] INPUT -o OUTPUT
       webpmux -info INPUT
       webpmux [-h|-help]
       webpmux -version

DESCRIPTION
       This manual page documents the webpmux command.

       webpmux can be used to create/extract from animated WebP files, as well as to  add/extract/strip
       XMP/EXIF metadata and ICC profile.

OPTIONS
   GET_OPTIONS (-get):
       icc    Get ICC profile.

       exif   Get EXIF metadata.

       xmp    Get XMP metadata.

       frame n
              Get nth frame from an animated image. (n = 0 has a special meaning: last frame).

   SET_OPTIONS (-set)
       icc file.icc
              Set ICC profile.

       Where: 'file.icc' contains the ICC profile to be set.

       exif file.exif
              Set EXIF metadata.

       Where: 'file.exif' contains the EXIF metadata to be set.

       xmp file.xmp
              Set XMP metadata.

       Where: 'file.xmp' contains the XMP metadata to be set.

   STRIP_OPTIONS (-strip)
       icc    Strip ICC profile.

       exif   Strip EXIF metadata.

       xmp    Strip XMP metadata.

   DURATION_OPTIONS (-duration)
       Amend  the  duration of a specific interval of frames. This option is only effective on animated
       WebP and has no effect on a single-frame file.

       duration[,start[,end]]
              Where:
              duration is the duration for the interval in milliseconds (mandatory).  Must be non-nega‐
              tive.
              start is the starting frame index of the interval (optional).
              end is the ending frame index (inclusive) of the interval (optional).

       The three typical usages of this option are:
              -duration d
                   set the duration to 'd' for the whole animation.
              -duration d,f
                   set the duration of frame 'f' to 'd'.
              -duration d,start,end
                   set the duration to 'd' for the whole [start,end] interval.

              Note that the frames outside of the [start, end] interval will remain untouched.
              The 'end' value '0' has the special meaning 'last frame of the animation'.

       Reminder:
              frame indexing starts at '1'.

   FRAME_OPTIONS (-frame)
       Create an animated WebP file from multiple (non-animated) WebP images.

       file_i +di[+xi+yi[+mi[bi]]]
              Where:  'file_i'  is the i'th frame (WebP format), 'xi','yi' specify the image offset for
              this frame, 'di' is the pause duration before next frame, 'mi' is the dispose method  for
              this  frame  (0  for  NONE  or 1 for BACKGROUND) and 'bi' is the blending method for this
              frame (+b for BLEND or -b for NO_BLEND).  Argument 'bi' can be omitted and  will  default
              to  +b  (BLEND).   Also,  'mi'  can  be  omitted if 'bi' is omitted and will default to 0
              (NONE).  Finally, if 'mi' and 'bi' are omitted then 'xi' and 'yi' can be omitted and will
              default to +0+0.

       -loop n
              Loop  the  frames  n  number of times. 0 indicates the frames should loop forever.  Valid
              range is 0 to 65535 [Default: 0 (infinite)].

       -bgcolor A,R,G,B
              Background color of the canvas.
              where: 'A', 'R', 'G' and 'B' are integers in the range 0 to  255  specifying  the  Alpha,
              Red, Green and Blue component values respectively [Default: 255,255,255,255].

   INPUT
       Input file in WebP format.

   OUTPUT (-o)
       Output file in WebP format.

   Note:
       The nature of EXIF, XMP and ICC data is not checked and is assumed to be valid.

BUGS
       Please report all bugs to the issue tracker: https://bugs.chromium.org/p/webp
       Patches  welcome!  See this page to get started: http://www.webmproject.org/code/contribute/sub‐
       mitting-patches/

EXAMPLES
       Add ICC profile:
       webpmux -set icc image_profile.icc in.webp -o icc_container.webp

       Extract ICC profile:
       webpmux -get icc icc_container.webp -o image_profile.icc

       Strip ICC profile:
       webpmux -strip icc icc_container.webp -o without_icc.webp

       Add XMP metadata:
       webpmux -set xmp image_metadata.xmp in.webp -o xmp_container.webp

       Extract XMP metadata:
       webpmux -get xmp xmp_container.webp -o image_metadata.xmp

       Strip XMP metadata:
       webpmux -strip xmp xmp_container.webp -o without_xmp.webp

       Add EXIF metadata:
       webpmux -set exif image_metadata.exif in.webp -o exif_container.webp

       Extract EXIF metadata:
       webpmux -get exif exif_container.webp -o image_metadata.exif

       Strip EXIF metadata:
       webpmux -strip exif exif_container.webp -o without_exif.webp

       Create an animated WebP file from 3 (non-animated) WebP images:
       webpmux -frame 1.webp +100 -frame 2.webp +100+50+50
               -frame 3.webp +100+50+50+1+b -loop 10 -bgcolor 255,255,255,255
               -o anim_container.webp

       Get the 2nd frame from an animated WebP file:
       webpmux -get frame 2 anim_container.webp -o frame_2.webp

       Using -get/-set/-strip with input file name starting with '-':
       webpmux -set icc image_profile.icc -o icc_container.webp -- ---in.webp
       webpmux -get icc -o image_profile.icc -- ---icc_container.webp
       webpmux -strip icc -o without_icc.webp -- ---icc_container.webp

AUTHORS
       webpmux is a part of libwebp and was written by the WebP team.
       The latest source tree is available at https://chromium.googlesource.com/webm/libwebp

       This manual page was written by Vikas Arora <vikaas.arora@gmail.com>,  for  the  Debian  project
       (and may be used by others).

SEE ALSO
       cwebp(1), dwebp(1), gif2webp(1)
       Please refer to http://developers.google.com/speed/webp/ for additional information.

                                           November 10, 2016                                 WEBPMUX(1)

Usage: webpmux -get GET_OPTIONS INPUT -o OUTPUT
       webpmux -set SET_OPTIONS INPUT -o OUTPUT
       webpmux -duration DURATION_OPTIONS [-duration ...]
               INPUT -o OUTPUT
       webpmux -strip STRIP_OPTIONS INPUT -o OUTPUT
       webpmux -frame FRAME_OPTIONS [-frame...] [-loop LOOP_COUNT]
               [-bgcolor BACKGROUND_COLOR] -o OUTPUT
       webpmux -info INPUT
       webpmux [-h|-help]
       webpmux -version

GET_OPTIONS:
 Extract relevant data:
   icc       get ICC profile
   exif      get EXIF metadata
   xmp       get XMP metadata
   frame n   get nth frame

SET_OPTIONS:
 Set color profile/metadata:
   icc  file.icc     set ICC profile
   exif file.exif    set EXIF metadata
   xmp  file.xmp     set XMP metadata
   where:    'file.icc' contains the ICC profile to be set,
             'file.exif' contains the EXIF metadata to be set
             'file.xmp' contains the XMP metadata to be set

DURATION_OPTIONS:
 Set duration of selected frames:
   duration            set duration for each frames
   duration,frame      set duration of a particular frame
   duration,start,end  set duration of frames in the
                        interval [start,end])
   where: 'duration' is the duration in milliseconds
          'start' is the start frame index
          'end' is the inclusive end frame index
           The special 'end' value '0' means: last frame.

STRIP_OPTIONS:
 Strip color profile/metadata:
   icc       strip ICC profile
   exif      strip EXIF metadata
   xmp       strip XMP metadata

FRAME_OPTIONS(i):
 Create animation:
   file_i +di+[xi+yi[+mi[bi]]]
   where:    'file_i' is the i'th animation frame (WebP format),
             'di' is the pause duration before next frame,
             'xi','yi' specify the image offset for this frame,
             'mi' is the dispose method for this frame (0 or 1),
             'bi' is the blending method for this frame (+b or -b)

LOOP_COUNT:
 Number of times to repeat the animation.
 Valid range is 0 to 65535 [Default: 0 (infinite)].

BACKGROUND_COLOR:
 Background color of the canvas.
  A,R,G,B
  where:    'A', 'R', 'G' and 'B' are integers in the range 0 to 255 specifying
            the Alpha, Red, Green and Blue component values respectively
            [Default: 255,255,255,255]

INPUT & OUTPUT are in WebP format.

Note: The nature of EXIF, XMP and ICC data is not checked and is assumed to be
valid.