Thanks to visit codestin.com
Credit goes to github.com

Skip to content

KilzaNiko/WimExplorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌐 English | Español

WimExplorer

WimExplorer Logo

Visual editor for WIM, ESD and SWM files on Windows
Browse, extract, add, replace and delete content without fighting with the command line.

v1.3 Windows Node.js 18+ wimlib 7-Zip


English (default)

What is WimExplorer

WimExplorer is a visual interface for working with .wim, .esd and .swm images using wimlib-imagex as a backend engine. The idea is simple: make editing these file types fast, clear and comfortable, even if you don't want to remember commands, parameters or manual workflows.

If you've ever found opening, inspecting or modifying a WIM image tedious, this tool aims to eliminate that friction.

Why it stands out

Advantage What it means in practice
Real visual interface Browse folders and files with a tree, table, breadcrumb and direct actions
Common operations in one click Extract, add, replace and delete without writing commands
Built for real work Conflict detection, live logs, image selector and system tray
Reliable engine All operations go through wimlib-imagex, maintaining format compatibility
Smart launcher Automatically verifies requirements before starting the application

Key features

Feature Description
Visual explorer Windows Explorer-style view with folder tree and content table
Multi-image Selector for WIM files with multiple internal images
Selective extraction Export files or folders to any system path
Add content Import files or folders via buttons or drag-and-drop
File replacement Replace existing items directly
Safe deletion Visual confirmation before deleting content
Conflict detection Detects duplicates before importing and lets you decide how to proceed
Real-time logs Console with live streaming to follow every operation
Built-in terminal Run wimlib-imagex commands from the interface itself
7-Zip integration Gets metadata like size and date to enhance the file listing
System tray Quick access and controlled shutdown from the notification area

Quick start

  1. Run WimExplorer-v1.3.exe.
  2. The launcher will automatically verify system requirements.
  3. The application will start the local server and open http://localhost:3000.
  4. Select your .wim, .esd or .swm file.
  5. Start browsing and editing from the interface.

Smart Launcher (v1.3)

WimExplorer-v1.3.exe is the only entry point for the user. When run, it performs these checks before starting:

1. Node.js check

If Node.js is not installed, the launcher shows a dialog with three options:

Option Action
Yes Automatic installation via winget (requests administrator permissions)
No Opens https://nodejs.org for manual installation
Cancel Exits without doing anything

After automatic installation, the launcher re-verifies that Node is available before continuing.

2. Dependency installation

If the node_modules folder doesn't exist (first run after extracting the release), the launcher asks the user and runs npm install automatically at the correct path.

3. Application startup

With all requirements met, it launches node server.js in the background without showing a console window.

The launcher resolves all paths at runtime based on its own location. The entire folder can be moved to any machine or path and it will continue to work.

Recommended workflow

Run WimExplorer-v1.3.exe
-> Launcher checks Node.js (installs if missing)
-> Launcher checks node_modules (installs if missing)
-> Load WIM/ESD/SWM file
-> Choose internal image if applicable
-> Browse folders and files
-> Extract / Add / Replace / Delete
-> Review real-time logs
-> Close from the interface or the system tray

Requirements

  • Windows 7, 10 or 11
  • Node.js 18 or higher (the launcher can install it automatically)
  • 7-Zip installed

Note about 7-Zip

WimExplorer needs 7z.exe to enrich the file listing. If it can't find it, the application tries to help you with an installation via winget or by allowing you to specify the path manually.

Interface and experience

The application is built with a modern dark-style UI, featuring:

  • side tree panel for structure
  • content table with name, size, date and type
  • navigation breadcrumb
  • bottom action bar
  • log console and built-in terminal
  • status indicators for wimlib and 7-Zip
  • EN/ES language toggle

Useful shortcuts

Shortcut Action
Enter Open WIM file when the path field has focus
Delete Delete selected items
Ctrl + A Select all visible files
Esc Close modals and context menus
Double click Enter a folder
Right click Open context menu
Drag and drop Import files or folders

Technologies

  • Backend: Node.js + Express
  • Frontend: HTML, CSS and vanilla JavaScript
  • Image engine: wimlib-imagex
  • Advanced listing support: 7-Zip
  • Notable dependencies: multer, open, systray2, 7zip-bin

Licenses and third parties

WimExplorer uses wimlib as the main engine for working with WIM images.

Important note:

  • wimlib as a whole can be redistributed under GPLv3 or later
  • libwim may offer an LGPL option in some cases, but for wimlib-imagex.exe the main reference you should keep is the wimlib documentation included in LICENSES/
  • if you distribute WimExplorer along with the wimlib binaries, you should always keep these license files in the repository and also in any distribution package

Project structure

WimExplorer/
|-- WimExplorer-v1.3.exe     # Main launcher (only entry point for the user)
|-- README.md                # English documentation
|-- README.es.md             # Spanish documentation
|-- LICENSES/
|   |-- wimlib-COPYING.txt
|   |-- wimlib-COPYING.GPLv3.txt
|   `-- wimlib-COPYING.LGPL.txt
|-- wimlib/
|   |-- wimlib-imagex.exe    # WIM management engine
|   `-- libwim-15.dll
`-- recursos/
    |-- server.js            # Express backend
    |-- start.vbs            # Launcher source (compiled into the .exe)
    |-- start.bat            # Alternative start for development
    |-- package.json
    |-- logo_wme.ico         # Launcher icon
    |-- logo_wme.png
    |-- public/              # Web interface
    |   |-- index.html
    |   |-- app.js
    |   |-- i18n.js          # EN/ES internationalization system
    |   `-- styles.css
    `-- node_modules/        # Automatically installed by the launcher

Important notes

  • The application works on the real format using wimlib-imagex; it doesn't invent an intermediate format.
  • The folder can be moved anywhere. The launcher resolves all paths at runtime.
  • The project is Windows-oriented and runs locally on localhost:3000.
  • If you redistribute the application with wimlib, also include the LICENSES/ folder and keep the corresponding attribution.

Ideal for

  • editing Windows installation images
  • inspecting WIM file contents without using a console
  • quickly replacing or extracting specific files
  • working more comfortably with multi-index images

Español

Qué es WimExplorer

WimExplorer es una interfaz visual para trabajar con imágenes .wim, .esd y .swm usando wimlib-imagex como motor de fondo. La idea es simple: hacer que editar este tipo de archivos sea rápido, claro y cómodo, incluso si no quieres recordar comandos, parámetros o flujos manuales.

Si alguna vez abrir, inspeccionar o modificar una imagen WIM te resultó tedioso, esta herramienta busca eliminar esa fricción.

Por qué destaca

Ventaja Qué significa en la práctica
Interfaz visual real Navegas carpetas y archivos con árbol, tabla, breadcrumb y acciones directas
Operaciones comunes en un clic Extraer, agregar, reemplazar y eliminar sin escribir comandos
Pensado para trabajo real Detección de conflictos, logs en vivo, selector de imagen y bandeja del sistema
Motor confiable Todas las operaciones pasan por wimlib-imagex, manteniendo compatibilidad con el formato
Launcher inteligente Verifica requisitos automáticamente antes de iniciar la aplicación

Características principales

Función Descripción
Explorador visual Vista tipo Explorador de Windows con árbol de carpetas y tabla de contenido
Multi-imagen Selector para WIM con varias imágenes internas
Extracción selectiva Exporta archivos o carpetas a cualquier ruta del sistema
Agregar contenido Importa archivos o carpetas desde botones o arrastrando y soltando
Reemplazo de archivos Sustituye elementos existentes de forma directa
Eliminación segura Confirmación visual antes de borrar contenido
Detección de conflictos Detecta duplicados antes de importar y permite decidir cómo continuar
Logs en tiempo real Consola con streaming en vivo para seguir cada operación
Terminal integrada Ejecuta comandos de wimlib-imagex desde la propia interfaz
Integración con 7-Zip Obtiene metadatos como tamaño y fecha para mejorar el listado
Bandeja del sistema Acceso rápido y cierre controlado desde el área de notificación

Inicio rápido

  1. Ejecuta WimExplorer-v1.3.exe.
  2. El launcher verificará automáticamente los requisitos del sistema.
  3. La aplicación iniciará el servidor local y abrirá http://localhost:3000.
  4. Selecciona tu archivo .wim, .esd o .swm.
  5. Empieza a navegar y editar desde la interfaz.

Launcher inteligente (v1.3)

WimExplorer-v1.3.exe es el único punto de entrada para el usuario. Al ejecutarlo realiza estas verificaciones antes de iniciar:

1. Verificación de Node.js

Si Node.js no está instalado, el launcher muestra un diálogo con tres opciones:

Opción Acción
Instalación automática vía winget (solicita permisos de administrador)
No Abre https://nodejs.org para instalación manual
Cancelar Sale sin hacer nada

Tras la instalación automática, el launcher vuelve a verificar que Node quedó disponible antes de continuar.

2. Instalación de dependencias

Si la carpeta node_modules no existe, el launcher pregunta al usuario y ejecuta npm install automáticamente en la ruta correcta.

3. Inicio de la aplicación

Con todos los requisitos cumplidos, lanza node server.js en segundo plano sin mostrar consola.

El launcher resuelve todas las rutas en tiempo de ejecución a partir de su propia ubicación. La carpeta completa puede moverse a cualquier equipo o ruta sin dejar de funcionar.

Flujo de uso recomendado

Ejecutar WimExplorer-v1.3.exe
-> Launcher verifica Node.js (instala si falta)
-> Launcher verifica node_modules (instala si faltan)
-> Cargar archivo WIM/ESD/SWM
-> Elegir imagen interna si aplica
-> Explorar carpetas y archivos
-> Extraer / Agregar / Reemplazar / Eliminar
-> Revisar logs en tiempo real
-> Cerrar desde la interfaz o la bandeja del sistema

Requisitos

  • Windows 7, 10 u 11
  • Node.js 18 o superior
  • 7-Zip instalado

Nota sobre 7-Zip

WimExplorer necesita 7z.exe para enriquecer el listado de archivos. Si no lo encuentra, la aplicación intenta ayudarte con una instalación vía winget o permitiendo indicar la ruta manualmente.

Interfaz y experiencia

La aplicación incluye:

  • panel de árbol lateral para la estructura
  • tabla de contenido con nombre, tamaño, fecha y tipo
  • breadcrumb de navegación
  • barra de acciones inferior
  • consola de logs y terminal integrada
  • indicadores de estado para wimlib y 7-Zip
  • selector de idioma EN/ES

Atajos útiles

Atajo Acción
Enter Abrir archivo WIM cuando el campo de ruta tiene foco
Delete Eliminar elementos seleccionados
Ctrl + A Seleccionar todos los archivos visibles
Esc Cerrar modales y menús contextuales
Doble clic Entrar en una carpeta
Clic derecho Abrir menú contextual
Arrastrar y soltar Importar archivos o carpetas

Tecnologías

  • Backend: Node.js + Express
  • Frontend: HTML, CSS y JavaScript vanilla
  • Motor de imágenes: wimlib-imagex
  • Soporte de listado avanzado: 7-Zip
  • Dependencias destacadas: multer, open, systray2, 7zip-bin

Licencias y terceros

WimExplorer utiliza wimlib como motor principal para trabajar con imágenes WIM.

Nota importante:

  • wimlib en conjunto puede redistribuirse bajo GPLv3 o posterior
  • libwim puede ofrecer una opción LGPL en algunos casos, pero para wimlib-imagex.exe la referencia principal es la documentación de wimlib incluida en LICENSES/
  • si distribuyes WimExplorer junto con los binarios de wimlib, conserva estos archivos de licencia dentro del repositorio y también en cualquier paquete de distribución

Estructura del proyecto

WimExplorer/
|-- WimExplorer-v1.3.exe     # Launcher principal
|-- README.md                # Documentación bilingüe
|-- LICENSES/
|   |-- wimlib-COPYING.txt
|   |-- wimlib-COPYING.GPLv3.txt
|   `-- wimlib-COPYING.LGPL.txt
|-- wimlib/
|   |-- wimlib-imagex.exe    # Motor de gestión WIM
|   `-- libwim-15.dll
`-- recursos/
    |-- server.js            # Backend Express
    |-- start.vbs            # Fuente del launcher (compilada en el .exe)
    |-- start.bat            # Inicio alternativo para desarrollo
    |-- package.json
    |-- logo_wme.ico         # Icono del launcher
    |-- logo_wme.png
    |-- public/              # Interfaz web
    |   |-- index.html
    |   |-- app.js
    |   |-- i18n.js          # Sistema de internacionalización EN/ES
    |   `-- styles.css
    `-- node_modules/        # Instalado automáticamente por el launcher

Notas importantes

  • La aplicación trabaja sobre el formato real usando wimlib-imagex; no inventa un formato intermedio.
  • La carpeta puede moverse de lugar. El launcher resuelve todas las rutas en tiempo de ejecución.
  • El proyecto está orientado a Windows y a un uso local en localhost:3000.
  • Si redistribuyes la aplicación con wimlib, incluye también la carpeta LICENSES/ y conserva la atribución correspondiente.

Ideal para

  • editar imágenes de instalación de Windows
  • inspeccionar contenido WIM sin usar consola
  • reemplazar o extraer archivos concretos rápidamente
  • trabajar más cómodo con imágenes multiíndice

About

WimExplorer es una aplicacion visual para explorar y editar archivos WIM, ESD y SWM en Windows. Permite extraer, agregar, reemplazar y eliminar contenido facilmente usando wimlib, con interfaz moderna, logs en tiempo real y soporte multi-imagen.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors