Skip to content

Commit 78e3560

Browse files
GhostKellzclaude
GhostKellz
and
claude
committed
Add Dell Optiplex support, driver injection, and production-ready packaging
Major Features: - Full Intel VMD/RST driver injection for Dell Optiplex 15th Gen systems - Automatic NVMe driver loading (Micron 3400, Samsung 980/990 PRO) - Comprehensive VMD bypass guide (disable in BIOS - no drivers needed) - Production-ready InnoSetup installer with VC++ bundling - Pre-flight validation script for system readiness Driver System: - Priority-based driver loading (Intel VMD/RST first, then NVMe) - Support for Intel 11th-15th Gen (Arrow Lake) with VROC - Micron 3400/2300/7450 NVMe driver detection - Samsung NVMe driver support - Automatic driver download script (Intel RST, Samsung) - Live driver injection in WinPE via AutoLoad-Drivers.cmd Documentation: - Reorganized all docs to docs/ directory - Added VMD_BYPASS_GUIDE.md - BIOS settings for Dell/Lenovo/HP - Added DRIVER_GUIDE.md - Complete driver setup for Dell systems - Added STATUS.md - Project status tracker (90% complete) - Dell Optiplex-specific config: ghostwin-dell-optiplex.toml Build System: - Fixed all 11 compilation warnings - clean build (0 warnings) - Added --verify flag to validate ISO integrity after creation - Pre-flight check script validates ADK, 7-Zip, drivers, disk space - InnoSetup installer script for one-click Windows installation Code Quality: - Removed unused imports and variables - Fixed unreachable code with proper cfg attributes - Added comprehensive error handling - Detailed logging for troubleshooting New Files: - src/drivers/mod.rs - Driver injection manager (450+ lines) - scripts/Download-Drivers.ps1 - Auto-download Intel/Samsung drivers - scripts/Preflight-Check.ps1 - System validation before build - pe_autorun/drivers/Load-Drivers.ps1 - WinPE driver loader - pe_autorun/drivers/AutoLoad-Drivers.cmd - Boot entry point - docs/VMD_BYPASS_GUIDE.md - BIOS configuration guide - ghostwin-dell-optiplex.toml - Production config template - installer.iss - InnoSetup installer script - build-installer.ps1 - Automated installer build Breaking Changes: None 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 0a9ae05 commit 78e3560

29 files changed

Lines changed: 3087 additions & 33 deletions

‎.github/workflows/release.yml‎

Lines changed: 248 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,248 @@
1+
name: Release Build
2+
3+
on:
4+
push:
5+
tags:
6+
- 'v*'
7+
workflow_dispatch:
8+
inputs:
9+
version:
10+
description: 'Version number (e.g., 0.3.3)'
11+
required: true
12+
default: '0.3.3'
13+
14+
env:
15+
CARGO_TERM_COLOR: always
16+
RUST_BACKTRACE: 1
17+
18+
jobs:
19+
build-windows:
20+
name: Build Windows Installer
21+
runs-on: windows-latest
22+
23+
steps:
24+
- name: Checkout code
25+
uses: actions/checkout@v4
26+
with:
27+
fetch-depth: 0
28+
29+
- name: Setup Rust toolchain
30+
uses: dtolnay/rust-toolchain@stable
31+
with:
32+
toolchain: stable
33+
targets: x86_64-pc-windows-msvc
34+
35+
- name: Cache cargo registry
36+
uses: actions/cache@v4
37+
with:
38+
path: |
39+
~/.cargo/bin/
40+
~/.cargo/registry/index/
41+
~/.cargo/registry/cache/
42+
~/.cargo/git/db/
43+
target/
44+
key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
45+
restore-keys: |
46+
${{ runner.os }}-cargo-
47+
48+
- name: Build release binary
49+
run: cargo build --release --verbose
50+
51+
- name: Run tests
52+
run: cargo test --release --verbose
53+
continue-on-error: true
54+
55+
- name: Download Visual C++ Redistributables
56+
run: |
57+
New-Item -ItemType Directory -Force dependencies
58+
Invoke-WebRequest -Uri "https://aka.ms/vs/17/release/vc_redist.x64.exe" -OutFile "dependencies\vcredist_x64.exe"
59+
60+
- name: Install InnoSetup
61+
run: |
62+
choco install innosetup -y
63+
$env:PATH = "C:\Program Files (x86)\Inno Setup 6;$env:PATH"
64+
echo "C:\Program Files (x86)\Inno Setup 6" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
65+
66+
- name: Get version from tag
67+
id: get_version
68+
shell: pwsh
69+
run: |
70+
if ($env:GITHUB_REF -match 'refs/tags/v(.*)') {
71+
$version = $matches[1]
72+
} else {
73+
$version = "${{ github.event.inputs.version }}"
74+
}
75+
if ([string]::IsNullOrEmpty($version)) {
76+
$version = "0.3.3"
77+
}
78+
echo "VERSION=$version" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
79+
echo "Version: $version"
80+
81+
- name: Build InnoSetup installer
82+
run: |
83+
$version = "${{ steps.get_version.outputs.VERSION }}"
84+
# Update version in installer script
85+
$issContent = Get-Content installer.iss -Raw
86+
$issContent = $issContent -replace '#define MyAppVersion ".*"', "#define MyAppVersion ""$version"""
87+
Set-Content -Path installer.iss -Value $issContent
88+
89+
# Compile installer
90+
& "C:\Program Files (x86)\Inno Setup 6\ISCC.exe" installer.iss
91+
92+
- name: Create portable ZIP
93+
run: |
94+
$version = "${{ steps.get_version.outputs.VERSION }}"
95+
New-Item -ItemType Directory -Force -Path "GhostWin-Portable"
96+
97+
# Copy files
98+
Copy-Item "target\release\ghostwin.exe" "GhostWin-Portable\"
99+
Copy-Item "ghostwin.toml" "GhostWin-Portable\"
100+
Copy-Item "README.md" "GhostWin-Portable\"
101+
Copy-Item "LICENSE" "GhostWin-Portable\"
102+
Copy-Item -Recurse "tools" "GhostWin-Portable\"
103+
Copy-Item -Recurse "scripts" "GhostWin-Portable\"
104+
Copy-Item -Recurse "pe_autorun" "GhostWin-Portable\"
105+
Copy-Item -Recurse "resources" "GhostWin-Portable\"
106+
Copy-Item -Recurse "config" "GhostWin-Portable\"
107+
108+
# Create README for portable version
109+
@"
110+
# GhostWin Portable v$version
111+
112+
This is the portable version of GhostWin. No installation required!
113+
114+
## Quick Start
115+
1. Extract this ZIP to any location
116+
2. Run ghostwin.exe --help for usage
117+
3. Place tools in the 'tools' directory
118+
4. Place scripts in the 'scripts' directory
119+
120+
## Requirements
121+
- Windows 10 or later
122+
- Administrator privileges for ISO building
123+
- Windows ADK (for WinPE building)
124+
125+
For full documentation, see README.md
126+
"@ | Out-File "GhostWin-Portable\PORTABLE-README.txt"
127+
128+
# Compress to ZIP
129+
Compress-Archive -Path "GhostWin-Portable\*" -DestinationPath "dist\GhostWin-Portable-v$version.zip" -Force
130+
131+
- name: Calculate checksums
132+
run: |
133+
$version = "${{ steps.get_version.outputs.VERSION }}"
134+
cd dist
135+
136+
# Calculate SHA256 for installer
137+
$installerHash = (Get-FileHash "GhostWin-Setup-v$version.exe" -Algorithm SHA256).Hash
138+
echo "$installerHash GhostWin-Setup-v$version.exe" | Out-File "GhostWin-Setup-v$version.exe.sha256" -Encoding ASCII
139+
140+
# Calculate SHA256 for portable ZIP
141+
$zipHash = (Get-FileHash "GhostWin-Portable-v$version.zip" -Algorithm SHA256).Hash
142+
echo "$zipHash GhostWin-Portable-v$version.zip" | Out-File "GhostWin-Portable-v$version.zip.sha256" -Encoding ASCII
143+
144+
# Create combined checksums file
145+
@"
146+
# GhostWin v$version Checksums (SHA256)
147+
148+
## Installer
149+
$installerHash GhostWin-Setup-v$version.exe
150+
151+
## Portable ZIP
152+
$zipHash GhostWin-Portable-v$version.zip
153+
"@ | Out-File "checksums.txt" -Encoding ASCII
154+
155+
- name: Upload installer artifact
156+
uses: actions/upload-artifact@v4
157+
with:
158+
name: GhostWin-Installer-${{ steps.get_version.outputs.VERSION }}
159+
path: dist/GhostWin-Setup-v${{ steps.get_version.outputs.VERSION }}.exe
160+
161+
- name: Upload portable ZIP artifact
162+
uses: actions/upload-artifact@v4
163+
with:
164+
name: GhostWin-Portable-${{ steps.get_version.outputs.VERSION }}
165+
path: dist/GhostWin-Portable-v${{ steps.get_version.outputs.VERSION }}.zip
166+
167+
- name: Upload checksums
168+
uses: actions/upload-artifact@v4
169+
with:
170+
name: checksums
171+
path: dist/checksums.txt
172+
173+
- name: Create GitHub Release
174+
if: startsWith(github.ref, 'refs/tags/')
175+
uses: softprops/action-gh-release@v1
176+
with:
177+
files: |
178+
dist/GhostWin-Setup-v${{ steps.get_version.outputs.VERSION }}.exe
179+
dist/GhostWin-Setup-v${{ steps.get_version.outputs.VERSION }}.exe.sha256
180+
dist/GhostWin-Portable-v${{ steps.get_version.outputs.VERSION }}.zip
181+
dist/GhostWin-Portable-v${{ steps.get_version.outputs.VERSION }}.zip.sha256
182+
dist/checksums.txt
183+
draft: true
184+
prerelease: false
185+
generate_release_notes: true
186+
body: |
187+
# GhostWin v${{ steps.get_version.outputs.VERSION }}
188+
189+
## 📦 Downloads
190+
191+
- **Windows Installer**: `GhostWin-Setup-v${{ steps.get_version.outputs.VERSION }}.exe`
192+
- **Portable ZIP**: `GhostWin-Portable-v${{ steps.get_version.outputs.VERSION }}.zip`
193+
194+
## 🔒 SHA256 Checksums
195+
196+
See `checksums.txt` for file verification hashes.
197+
198+
## 📝 What's New
199+
200+
[Release notes will be auto-generated]
201+
202+
## 📖 Documentation
203+
204+
- [README](https://github.com/${{ github.repository }}/blob/main/README.md)
205+
- [Documentation](https://github.com/${{ github.repository }}/blob/main/DOCS.md)
206+
- [Commands Reference](https://github.com/${{ github.repository }}/blob/main/COMMANDS.md)
207+
208+
## 🐛 Known Issues
209+
210+
- ISO creation only supported on Windows
211+
- Requires Windows ADK for full functionality
212+
213+
---
214+
215+
**Full Changelog**: https://github.com/${{ github.repository }}/compare/${{ github.event.before }}...${{ github.ref_name }}
216+
env:
217+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
218+
219+
build-portable-linux:
220+
name: Build Linux Binary (for cross-platform development)
221+
runs-on: ubuntu-latest
222+
223+
steps:
224+
- name: Checkout code
225+
uses: actions/checkout@v4
226+
227+
- name: Setup Rust toolchain
228+
uses: dtolnay/rust-toolchain@stable
229+
with:
230+
toolchain: stable
231+
232+
- name: Install system dependencies
233+
run: |
234+
sudo apt-get update
235+
sudo apt-get install -y libgtk-3-dev
236+
237+
- name: Build release binary
238+
run: cargo build --release --verbose
239+
240+
- name: Run tests
241+
run: cargo test --release --verbose
242+
continue-on-error: true
243+
244+
- name: Upload Linux binary
245+
uses: actions/upload-artifact@v4
246+
with:
247+
name: ghostwin-linux-x86_64
248+
path: target/release/ghostwin

‎ENVIRONMENT_OPTIMIZATION.md‎

Whitespace-only changes.

‎README.md‎

Lines changed: 48 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -159,17 +159,54 @@ GhostWin includes:
159159
GhostWin's `ghostwin build` CLI tool will:
160160

161161
1. Mount the Windows boot.wim image
162-
2. Inject GhostWin helper + user scripts/tools
163-
3. Inject WinPE packages from ADK
164-
4. Modify registry if needed (e.g., DPI fix)
165-
5. Unmount and commit WIM changes
166-
6. Rebuild a bootable ISO using `oscdimg`
162+
2. **🔥 Auto-inject storage drivers (Intel VMD/RST, NVMe)**
163+
3. Inject GhostWin helper + user scripts/tools
164+
4. Inject WinPE packages from ADK
165+
5. Modify registry if needed (e.g., DPI fix)
166+
6. Unmount and commit WIM changes
167+
7. Rebuild a bootable ISO using `oscdimg`
168+
169+
### 🚀 Two Options for Dell/Lenovo NVMe Systems:
170+
171+
#### **Option 1: Disable Intel VMD in BIOS (Recommended - No Drivers Needed!)**
172+
173+
**For fresh Windows installs, just change one BIOS setting:**
174+
175+
**Dell:** BIOS → System Configuration → SATA Operation → **AHCI**
176+
**Lenovo:** BIOS → Devices → SATA Controller Mode → **AHCI**
177+
178+
✅ **No drivers needed**
179+
✅ **Drives visible immediately**
180+
✅ **Simplest solution**
181+
182+
See [**VMD Bypass Guide**](docs/VMD_BYPASS_GUIDE.md) for step-by-step instructions.
183+
184+
#### **Option 2: Keep VMD Enabled + Auto-Load Drivers**
185+
186+
**For systems requiring RAID or Intel Optane:**
187+
188+
```powershell
189+
# Download Intel RST drivers automatically
190+
.\scripts\Download-Drivers.ps1 -IntelRST
191+
192+
# Download all supported drivers
193+
.\scripts\Download-Drivers.ps1 -All
194+
```
195+
196+
**Supported Hardware:**
197+
- ✅ Intel 15th Gen (Arrow Lake) with VMD
198+
- ✅ Micron 3400 NVMe (common in Dell 2024+ systems)
199+
- ✅ Samsung 980 PRO / 990 PRO / 970 EVO Plus
200+
- ✅ Dell Optiplex 3000/5000/7000/9000 series
201+
202+
See [**Driver Guide**](docs/DRIVER_GUIDE.md) for driver setup details.
167203

168204
### Requirements:
169205

170206
* Windows ADK + WinPE Add-on
171207
* Rust (1.78+) + `ghostwin` CLI
172208
* Base Windows 11 ISO
209+
* **Storage drivers** (auto-downloaded or manual)
173210

174211
---
175212

@@ -234,9 +271,12 @@ The audit scripts and WinPE functionality in GhostWin were inspired by **[Window
234271
## 🔗 Links & Resources
235272

236273
**📖 Documentation**
237-
- [Setup Guide (GUNPOWDER.md)](GUNPOWDER.md) - Step-by-step setup with personality
238-
- [Technical Documentation (DOCS.md)](DOCS.md) - Complete technical reference
239-
- [Command Reference (COMMANDS.md)](COMMANDS.md) - CLI command documentation
274+
- [Setup Guide](docs/GUNPOWDER.md) - Step-by-step setup with personality
275+
- [Technical Documentation](docs/DOCS.md) - Complete technical reference
276+
- [Command Reference](docs/COMMANDS.md) - CLI command documentation
277+
- [**VMD Bypass Guide**](docs/VMD_BYPASS_GUIDE.md) - **Disable Intel VMD (no drivers needed!)** 🔥
278+
- [**Driver Guide**](docs/DRIVER_GUIDE.md) - **Auto-download drivers for Dell/Lenovo 15th Gen** ⚡
279+
- [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions
240280

241281
**🌐 Online**
242282
- [CK Technology](https://cktechx.com) - Professional IT services

0 commit comments

Comments
 (0)