From 1b33b8440a4e846d51ff65230d0e1c9d6e172955 Mon Sep 17 00:00:00 2001 From: chris1111 Date: Mon, 11 Nov 2024 20:38:19 -0500 Subject: [PATCH] Update site --- README | 142 +++++++++++++++++++++++++++---------------------------- index.md | 12 ++--- 2 files changed, 75 insertions(+), 79 deletions(-) diff --git a/README b/README index 57a8ddb..49b6f62 100644 --- a/README +++ b/README @@ -1,6 +1,6 @@ # Introduction -This is wimlib version 1.14.1 (April 2023). wimlib is a C library for +This is wimlib version 1.14.4 (February 2024). wimlib is a C library for creating, modifying, extracting, and mounting files in the Windows Imaging Format (WIM files). wimlib and its command-line frontend `wimlib-imagex` provide a free and cross-platform alternative to Microsoft's WIMGAPI, ImageX, @@ -11,13 +11,15 @@ For the release notes, see the [NEWS file](NEWS.md). # Table of Contents - [Installation](#installation) + - [Windows](#windows) + - [UNIX-like systems](#unix-like-systems) + - [Installing distro package](#installing-distro-package) + - [Building from source](#building-from-source) - [WIM files](#wim-files) - [ImageX implementation](#imagex-implementation) - [Compression](#compression) - [NTFS support](#ntfs-support) - [Windows PE](#windows-pe) -- [Dependencies](#dependencies) -- [Configuration](#configuration) - [Portability](#portability) - [References](#references) - [History](#history) @@ -25,16 +27,75 @@ For the release notes, see the [NEWS file](NEWS.md). # Installation -To install wimlib and `wimlib-imagex` on UNIX-like systems, you can compile from -source (e.g. `./configure && make && sudo make install`). Alternatively, check -if a package has already been prepared for your operating system. +## Windows To install wimlib and `wimlib-imagex` on Windows, just download and extract the -ZIP file containing the latest binaries. For more details, see -[README.WINDOWS.md](README.WINDOWS.md). +ZIP file containing the latest binaries. All official releases are available +from [wimlib.net](https://wimlib.net). -All official wimlib releases are available from -[wimlib.net](https://wimlib.net). +For more details, including directions for how to build from source on Windows +if desired, see [README.WINDOWS.md](README.WINDOWS.md). + +## UNIX-like systems + +### Installing distro package + +To install wimlib and `wimlib-imagex` on UNIX-like systems, first consider just +installing the package provided by your operating system, if there is one. + +For example, on Ubuntu and other Debian based systems, run: + + sudo apt install wimtools + +On Fedora and other Red Hat based systems, run: + + sudo dnf install wimlib-utils + +On Arch Linux, run: + + sudo pacman -S wimlib + +### Building from source + +To build from source instead, first install the development files for libfuse3 +and libntfs-3g, if they're available for your operating system. For example, on +Ubuntu, run: + + sudo apt install libfuse3-dev ntfs-3g-dev + +Then, if you're building from the git repository instead of from a release +tarball, install additional build dependencies and run the bootstrap script: + + sudo apt install autoconf automake libtool pkgconf + ./bootstrap + +Finally, configure, build, and install the software: + + ./configure + make + sudo make install + +In addition to the standard options, the configure script accepts the following +options: + +- `--without-fuse`: Disables support for mounting WIM images. The `wimmount`, + `wimmountrw`, and `wimunmount` commands won't work. This removes the + dependency on libfuse3. + +- `--without-ntfs-3g`: Disables support for capturing or applying WIM images + directly from/to NTFS volumes. This removes the dependency on libntfs-3g. + +The `mkwinpeimg` shell script also has some optional dependencies that you can +choose to install: + +- `cdrkit` (for making ISO filesystems) +- `mtools` (for making disk images) +- `syslinux` (for making disk images) +- `cabextract` (for extracting files from the Windows Automated Installation Kit) + +Mounting WIM images also requires the FUSE kernel module. When you try to mount +a WIM image, the FUSE kernel module should be automatically loaded. Mounting +WIM images is only supported on Linux. # WIM files @@ -135,67 +196,6 @@ A shell script `mkwinpeimg` is provided with wimlib on UNIX-like systems to simplify the process of creating and customizing a bootable Windows PE image, sourcing the needed files from the Windows installation media or from the WAIK. -# Dependencies - -This section documents the dependencies of wimlib and the programs distributed -with it, when building for a UNIX-like system from source. If you have -downloaded the Windows binary distribution of wimlib and `wimlib-imagex` then -all dependencies were already included and this section is irrelevant. - -- `libfuse3` (optional but recommended) - - Unless configured `--without-fuse`, wimlib requires `libfuse3`, for mounting - WIM images using [FUSE](https://github.com/libfuse/libfuse). Most Linux - distributions already include this, but make sure you have the `fuse3` package - installed, and also `libfuse3-dev` if your distribution distributes - development files separately. FUSE also requires a kernel module. If the - kernel module is available it should automatically be loaded if you try to - mount a WIM image. - -- `libntfs-3g` (optional but recommended) - - Unless configured `--without-ntfs-3g`, wimlib requires the library and headers - for libntfs-3g to be installed. The minimum required version is 2011-4-12, - but newer versions contain important bug fixes. - -- `cdrkit` (optional) -- `mtools` (optional) -- `syslinux` (optional) -- `cabextract` (optional) - - The `mkwinpeimg` shell script will look for several other programs depending - on what options are given to it. Depending on your Linux distribution, you - may already have these programs installed, or they may be in the software - repository. Making an ISO filesystem requires `mkisofs` from - [`cdrkit`](https://www.cdrkit.org). Making a disk image requires - [`mtools`](https://www.gnu.org/software/mtools) and - [`syslinux`](https://www.syslinux.org). Retrieving files from the Windows - Automated Installation Kit requires - [`cabextract`](https://www.cabextract.org.uk). - -# Configuration - -This section documents the most important options that may be passed to the -"configure" script when building from source: - -- `--without-ntfs-3g` - - If libntfs-3g is not available or is not version 2011-4-12 or later, wimlib - can be built without it, in which case it will not be possible to capture or - apply WIM images directly from/to NTFS volumes. - - The default is `--with-ntfs-3g` when building for any UNIX-like system, and - `--without-ntfs-3g` when building for Windows. - -- `--without-fuse` - - The `--without-fuse` option disables support for mounting WIM images. This - removes dependencies on libfuse and librt. The `wimmount`, `wimmountrw`, and - `wimunmount` commands will not work. - - The default is `--with-fuse` when building for Linux, and `--without-fuse` - otherwise. - # Portability wimlib works on both UNIX-like systems (Linux, Mac OS X, FreeBSD, etc.) and diff --git a/index.md b/index.md index 7ddd1d2..ff56330 100644 --- a/index.md +++ b/index.md @@ -14,9 +14,9 @@ Wimlib-Imagex-Package|Cross-platform Library wimlib to built it in macos ## We use cross-platform Library wimlib to built it in macos. #### Important do not mix this program with that of Homebrew! Use Wimlib-Imagex-Package alone. -The files in this repository are from the [Official wimlib site Release-v-1.14.1](https://wimlib.net/index.html) +The files in this repository are from the [Official wimlib site Release-v-1.14.4](https://wimlib.net/index.html) -- Wimlib-Imagex for macOS, working from macOS Mojave 10.14 to macOS Ventura 13 +- Wimlib-Imagex for macOS, working from macOS Mojave 10.14 to macOS Sequoia 15 - Working for Hackintosh and real Mac - This program will built then install wimlib in `/usr/local/` @@ -39,18 +39,14 @@ Usage ➤ [Usage: wimlib-imagex](https://github.com/chris1111/Wimlib-Imagex-Pack - [x] `Installation` ```bash -mkdir -p WimlibDev -cd WimlibDev -git clone https://github.com/chris1111/Wimlib-Imagex-Package.git -./Wimlib-Imagex-Package/Build-Package.tool +mkdir -p WimlibDev && cd WimlibDev && git clone https://github.com/chris1111/Wimlib-Imagex-Package.git && ./Wimlib-Imagex-Package/Build-Package.tool ``` See Video Demonstartion ➤ [![Modular Image Creation](https://user-images.githubusercontent.com/6248794/211171949-884b17a1-8edc-435d-a2b0-272334068365.png)](https://github.com/chris1111/Wimlib-Imagex-Package/blob/main/Video%20Page.md) ### Credit: - Special thanks to ➤ [Wimlib](https://wimlib.net/) for Wimlib -- Special thanks to ➤ [Homebrew](https://github.com/homebrew) for the build: libxml2, openssl@3 Library - Special thanks to ➤ [Tester djams](https://github.com/djams2904) -- Apple for the Command Line Tools (CLT) +- Apple for the Command Line Tools (CLT) and Xcode ### SIP Security and Gatekeeper must be disable - WINUSB is bootable only in UEFI ( 🚫 Not working in Legacy booting )