wimlib.net Git - wimlib/blob - README.WINDOWS

   1
   2                                   INTRODUCTION
   3
   4 wimlib is free and open source software that is available on both UNIX-like
   5 systems and Windows.  This file provides additional information specifically
   6 about the Windows version of wimlib and the command line tool "wimlib-imagex"
   7 that is distributed with it.  It does not obsolete the generic README.txt, which
   8 you should read too.
   9
  10                               WINDOWS DISTRIBUTION
  11
  12 For the convenience of Windows users, the Windows distribution of wimlib is a
  13 ZIP file containing the following items:
  14
  15   * wimlib-imagex.exe, a command-line tool to deal with WIM (.wim) and split WIM
  16     (.swm) files that is similar to Microsoft's ImageX.  This is a ready-to-run
  17     executable and not an installer.
  18
  19   * Very short batch scripts (e.g. wimapply.cmd) which are shortcuts to the
  20     corresponding wimlib-imagex commands (e.g. `wimlib-imagex apply').
  21
  22   * The documentation, including this file, the generic README.txt, and
  23     PDF documentation for wimlib-imagex in the 'doc' directory.
  24
  25   * Various DLL (.dll) files, including the wimlib library itself
  26     (libwim-9.dll).  The C header wimlib.h is not included; download the source
  27     if you want it.
  28
  29   * License files for all software included.  These are all free software
  30     licenses.
  31
  32                                  WIMLIB-IMAGEX
  33
  34 wimlib-imagex provides most features of Microsoft's ImageX, plus additional
  35 features.  First, the main limitations of wimlib-imagex compared to Microsoft's
  36 ImageX are the following:
  37
  38   * Mounting images from a WIM file is not supported on Windows.
  39
  40   * The LZX ("maximum") compression ratio is several percent worse than
  41     Microsoft's implementation.
  42
  43 However, wimlib-imagex provides a number of advantages compared to Microsoft's
  44 ImageX, including but not limited to the following:
  45
  46   * wimlib-imagex provides "extract" and "update" commands that can be used to
  47     work around the lack of mount support.  These commands are very fast
  48     compared to mounting and unmounting images with Microsoft's ImageX, so you
  49     may prefer them anyway.
  50
  51   * wimlib-imagex offers fast multithreaded compression, so making WIM images
  52     can be much faster.
  53
  54   * wimlib-imagex provides a better XPRESS ("fast") compression ratio than
  55     Microsoft's ImageX.
  56
  57   * wimlib-imagex provides an easy-to-use "optimize" command to remove wasted
  58     space from WIM files.
  59
  60   * In some cases, wimlib-imagex uses simpler command-line syntax.  For
  61     example, `wimlib-imagex capture' (or simply `wimcapture') defaults to
  62     maximum compression by default, integrity tables are treated as persistent,
  63     and in some cases image names need not be explicitly specified.
  64
  65   * Whenever possible, wimlib-imagex includes improved documentation and
  66     informational output compared to Microsoft's software.
  67
  68   * On Windows, wimlib-imagex can correctly save and restore some combinations
  69     of data that Microsoft's ImageX runs into bugs on --- for example,
  70     uncompressed files in compressed directories, or files with alternate data
  71     streams and multiple hard links.
  72
  73   * wimlib and wimlib-imagex are free software, so you can modify and/or audit
  74     the source code.
  75
  76                                 ADDITIONAL NOTES
  77
  78 Currently there is no graphical user interface available for wimlib or
  79 wimlib-imagex.  It's recommended to use wimlib-imagex in scripts to avoid having
  80 to interactively enter commands.  However, note that wimlib-imagex is largely
  81 just a command-line front-end for wimlib, and it's possible to use wimlib's API
  82 in other front-ends or applications.