WPF HexEditor is a powerful, high-performance hex editor control for .NET applications. Built with modern MVVM architecture and optimized for files from bytes to gigabytes, it delivers professional-grade binary editing with 99% faster rendering and 10-100x faster search than legacy versions.
Perfect for: binary file analysis, game ROM modding, data recovery, protocol debugging, security research, and any application requiring low-level data inspection.
1. Install via NuGet (V1 only):
dotnet add package WPFHexaEditor2. Add to your XAML:
<Window xmlns:hex="clr-namespace:WpfHexaEditor;assembly=WPFHexaEditor">
<hex:HexEditor FileName="data.bin" />
</Window>3. Done! 🎉
💡 JetBrains Rider Users: No visual toolbox? No problem! See the Rider Guide for IntelliSense tips, Live Templates, and sample projects.
👉 Complete Tutorial | 7+ Sample Apps | API Docs
|
|
|
|
|
|
Upgrading from V1? → Migration Guide (zero code changes required!)
| Metric | V1 Legacy | V2 Modern | Improvement |
|---|---|---|---|
| Rendering | ItemsControl | DrawingContext | ⚡ 99% faster |
| Search | Standard | LRU + Parallel + SIMD | ⚡ 10-100x faster |
| Memory | High | Span<T> + Pooling | ⚡ 80-90% less |
| Architecture | Monolithic | MVVM + 15 Services | 🏗️ Service-based |
| Bugs | Insert Mode Save loss |
All fixed ✅ | ✅ Production ready |
→ See complete feature comparison (163 features)
Note: The screenshots below are from V1 (Legacy). V2 screenshots will be added soon.
|
📝 Standard ASCII View Clean interface with hex/ASCII side-by-side 
|
🎮 Custom TBL (Final Fantasy II) Game ROM editing with custom character tables 
|
|
🔍 Find & Replace Advanced search with pattern matching 
|
📊 BarChart View ⭐ Visual data representation for analysis 
|
🔧 Advanced Features - Click to see more screenshots
|
⚙️ ByteShift + Fixed Table Editing Advanced table editing with byte shifting 
|
🖥️ AvalonDock Integration ⭐ Dockable panels for complex workflows 
|
|
🎨 Custom Background Blocks Visual diff and data highlighting 
|
|
| Document | Description |
|---|---|
| GETTING_STARTED.md | 👨💻 Complete tutorial with code examples |
| FEATURES.md | 📊 Full V1 vs V2 comparison (163 features) |
| MIGRATION.md | 🔄 V1→V2 migration guide (zero code changes) |
| CHANGELOG.md | 📝 Version history and changes |
| Document | Description |
|---|---|
| Architecture Overview | 🏗️ Complete system architecture with diagrams |
| Core Systems | ⚙️ ByteProvider, Position Mapping, Edit Tracking, Undo/Redo, Rendering, Services |
| Data Flow | 🔄 File operations, Edit operations, Search, Save sequences |
| API Reference | 📖 Complete API documentation with examples |
| Folder | Description |
|---|---|
| PartialClasses/ | 📂 HexEditor organized by functionality (Core, Features, Search, UI) |
| Services/ | 🔧 15 specialized services (Search, Clipboard, Bookmarks, etc.) |
| Core/Bytes/ | 💾 ByteProvider system and data management |
| Sample | Description |
|---|---|
| C# WPF Sample | Main comprehensive demo with all features |
| AvalonDock Sample | IDE-like dockable interface |
| BarChart Sample | Visual data analysis |
| WinForms Sample | Windows Forms integration |
| Binary Diff Sample | File comparison tool |
| Insert Anywhere Sample | Dynamic insert/delete operations |
| Service Usage Sample | Console app (headless usage) |
→ Browse all samples with documentation
- ✅ Multi-format editing - Hex, Decimal, Binary, Octal
- ✅ Multi-byte support - 8/16/32-bit values with endianness control
- ✅ Insert/Overwrite modes - Full insert mode support (Issue #145 fixed)
- ✅ Unlimited Undo/Redo - Complete history management
- ✅ Copy as code - Generate byte arrays for C#, VB, Java, Python, etc.
- 🔍 LRU Search Cache - 10-100x faster repeated searches
- ⚡ SIMD Vectorization - Hardware-accelerated search (AVX2/SSE2)
- 🔄 Parallel Multi-Core - Automatic for files > 100MB
- 📍 Scrollbar Markers - Visual indicators for search/bookmarks/changes and selection!
- 📊 BarChart View - Byte frequency visualization
- 🪟 AvalonDock Support - Professional IDE integration
- 🌍 9 Languages - English, Spanish, French, Polish, Portuguese, Russian, Chinese
- 🏗️ MVVM Architecture - ViewModel, RelayCommand, INotifyPropertyChanged
- ⏱️ Async Operations - Progress reporting + cancellation
- 🎨 Fully Customizable - Colors, fonts, themes, display modes
- 🎮 TBL File Support - Custom character tables for ROM hacking
- 📋 Rich Events - 21+ events for fine-grained control
→ See complete feature matrix (163 features)
WPF HexEditor uses multi-targeting for maximum compatibility:
| Framework | Version | Performance Level |
|---|---|---|
| .NET Framework | 4.8 | ⚡ Fast (99% rendering, LRU cache, parallel) |
| .NET | 8.0-windows | ⚡⚡⚡ Blazing (+ Span<T>, SIMD, PGO) |
Single NuGet package works for both! The correct binary is automatically selected based on your project's target framework.
Recommendation: Use .NET 8.0 for maximum performance (Span<T>, SIMD, Profile-Guided Optimization).
| Bug | V1 Status | V2 Status |
|---|---|---|
| Issue #145: Insert Mode | ✅ FIXED (commit 405b164) | |
| Save Data Loss | ✅ FIXED (multi-MB corruption resolved) | |
| Search Cache Invalidation | ✅ FIXED (all 11 modification points) | |
| Binary Search O(m)→O(log m) | ✅ FIXED (100-5,882x faster) |
All production-critical bugs resolved. V2 is production-ready. ✅
→ See detailed bug fix documentation
WPF HexEditor is 100% free and open source (Apache 2.0). It can be used in personal projects, commercial applications, and everything in between.
This project is developed in free time by passionate contributors. If you find it useful:
- ⭐ Star this repository - It helps others discover the project!
- 🍴 Fork and contribute - Pull requests are always welcome
- 💬 Share feedback - Report bugs or suggest features
- 📖 Improve documentation - Help others get started
Every star motivates us to keep improving! 🙏
We welcome contributions! The comprehensive documentation makes it easy to understand the codebase:
- Architecture Guide - Service-based design overview
- 19 READMEs - Every component documented
- ByteProvider Tests - Core functionality tested
- 7+ Samples - Working examples
How to contribute:
- Fork the repository
- Create a feature branch
- Make your changes (see Architecture Guide for design patterns)
- Test your changes
- Submit a pull request
Apache License 2.0 - Free for personal and commercial use.
See LICENSE file for details.
- 🐛 Bug Reports: GitHub Issues
- 💡 Feature Requests: GitHub Discussions
- 📚 Documentation: Complete Documentation Map
- 📧 Email: [email protected]
✨ WPF HexEditor V2 ✨
A powerful, well-documented hex editor control for .NET
Created by Derek Tremblay (abbaye)
V2 Contributor: Claude Sonnet 4.5
V1 (Legacy) Contributors: ehsan69h, Janus Tida
Coded with ❤️ for the community! 😊🤟 (with a touch of AI magic ✨)
🚀 Quick Start • 📖 Tutorial • 📊 Features • 🔄 Migration • ⭐ Star Us