This guide walks you through running the IDE and embedding the HexEditor control in your own project.

git clone https://github.com/abbaye/WpfHexEditorIDE.git

Open WpfHexEditorControl.sln.

Right-click WpfHexEditor.App → Set as Startup Project.

Press F5. The IDE opens with the Welcome Panel.

flowchart LR
    Clone["git clone"] --> Open["Open .sln\nVisual Studio 2022"]
    Open --> Startup["Set WpfHexEditor.App\nas Startup Project"]
    Startup --> Run["F5 → IDE launches"]
    Run --> Welcome["Welcome Panel\nwith recent files and changelog"]

File → Open File (Ctrl+O) or drag any binary file onto the editor area.

The IDE auto-detects the format from 690+ .whfmt definitions and routes it to the best editor:

• Binary / unknown → Hex Editor
• JSON / XML / source code → Code Editor
• .xaml files → XAML Visual Designer (split-pane: code + live canvas)
• Image (PNG, BMP, JPEG…) → Image Viewer
• ZIP / archive → Structure Editor
• .rtf / .docx / .odt → Document Editor (WYSIWYG canvas)
• .hxscript / .csx → Script Editor (CodeEditorSplitHost)

File → Open Project / Solution supports:

• .whsln / .whproj — native WpfHexEditor format
• .sln / .csproj — Visual Studio solutions (via SolutionLoader.VS)
• Any folder → creates a .whfolder marker (open-folder mode)

The Solution Explorer populates with the project tree. You can also drag files directly onto the IDE.

File → Workspace → Open Workspace (.whidews) restores a complete session snapshot: theme, docking layout, active solution, and all open files. Save the current session at any time via File → Workspace → Save Workspace.

File → New File → choose a template (Binary, TBL, JSON, XAML, Text).

┌────────────────────────────────────────────────────────────────┐
│  Menu bar  │  Toolbar  │                               │ Status │
├────────────┴───────────┴───────────────────────────────┴───────┤
│ Solution   │                                                     │
│ Explorer   │           Document / Editor Area                    │
│  (left)    │         (tabs, floating windows)                    │
│            │                                                     │
├────────────┤─────────────────────────────────────────────────────┤
│ Properties │    Terminal / Output / Error / Plugin panels        │
│  (bottom)  │              (bottom dock group)                    │
└────────────┴─────────────────────────────────────────────────────┘

All panels can be dragged, floated, auto-hidden, or tabbed anywhere in the layout.

<ItemGroup>
  <ProjectReference Include="..\WpfHexEditor.Core\WpfHexEditor.Core.csproj" />
  <ProjectReference Include="..\WpfHexEditor.HexEditor\WpfHexEditor.HexEditor.csproj" />
</ItemGroup>

<Window xmlns:hex="clr-namespace:WpfHexEditor.HexEditor;assembly=WpfHexEditor.HexEditor">
  <hex:HexEditor x:Name="HexEdit" FileName="data.bin" />
</Window>

// Open file
HexEdit.FileName = @"C:\data\myfile.bin";

// Read a byte
byte value = HexEdit.GetByte(0x100);

// Modify a byte
HexEdit.ModifyByte(0xFF, 0x100);

// Save
HexEdit.Save();

// Undo
if (HexEdit.CanUndo) HexEdit.Undo();

var progress = new Progress<double>(p => progressBar.Value = p);
await HexEdit.OpenAsync("large.bin", progress);

dotnet new classlib -n MyPlugin -f net8.0-windows

<ProjectReference Include="..\WpfHexEditor.SDK\WpfHexEditor.SDK.csproj" />

using WpfHexEditor.SDK;

public class MyPlugin : IWpfHexEditorPluginV2
{
    public string Id          => "com.example.myplugin";
    public string Name        => "My Plugin";
    public string Version     => "1.0.0";
    public string? Description => "My first plugin";
    public int    LoadPriority => 50;

    private IIDEHostContext? _ctx;

    public void Init(IIDEHostContext context)
    {
        _ctx = context;
        context.UIRegistry.RegisterPanel("my-panel", "My Panel", () => new MyPanelView());
        context.OutputService.WriteLine("My Plugin loaded.");
    }

    public void Activate()   => _ctx?.UIRegistry.ShowDockablePanel("my-panel");
    public void Deactivate() => _ctx?.UIRegistry.HideDockablePanel("my-panel");
    public void Dispose()    { }
}

{
  "id":           "com.example.myplugin",
  "name":         "My Plugin",
  "version":      "1.0.0",
  "entryPoint":   "MyPlugin.dll",
  "loadPriority": 50
}

Copy the output folder to %AppData%\WpfHexEditor\Plugins\com.example.myplugin\ and restart the IDE.

👉 See Plugin System for full packaging with whxpack CLI.

Open the terminal (Ctrl+`` ) and try:

help                        # list all commands
list-files                  # list files in current directory
open-file C:\data\test.bin  # open a file
search DE AD BE EF          # search in active HexEditor
read-hex 0x0 16             # read 16 bytes at offset 0
plugin-list                 # list loaded plugins
status                      # IDE status summary

👉 See Terminal for the full command reference.

1. Open a .xaml file — the IDE auto-routes to the XAML Designer
2. The split-pane shows: code editor (one side) + live canvas (other side)
3. Edit code → canvas updates in real-time (150 ms debounce)
4. Drag/resize elements on canvas → code updates automatically
5. Toggle views: F7 (code only / split / design only)
6. Change layout: Ctrl+Shift+L cycles through 4 split modes
7. Undo/Redo: Ctrl+Z / Ctrl+Y — up to 200 steps

• Architecture — understand how the IDE is built
• Plugin System — build and package plugins
• Terminal — commands, scripting, plugin API
• Plugin Monitoring — monitor plugin performance
• API Reference — complete HexEditor control API
• FAQ — common questions and troubleshooting