Skip to content

realgarit/PKHeX-Avalonia

Repository files navigation

PKHeX Avalonia

License CI Release

PKHeX Avalonia is the cross-platform PKHeX port built with the Avalonia UI framework, bringing the classic Pokémon save editor to Windows, macOS, and Linux with a native look and feel.


Download

Grab the latest release for your platform from the Releases page:

Platform File
Windows (x64) PKHeX-Avalonia-win-x64.zip
Linux (x64) PKHeX-Avalonia-linux-x64.zip
macOS Apple Silicon PKHeX-Avalonia-osx-arm64.zip
macOS Intel PKHeX-Avalonia-osx-x64.zip

All releases are self-contained — no .NET runtime installation required.

macOS Note: The app is ad-hoc signed but not notarized, so on first launch macOS will warn "unidentified developer". To open it:

  1. Right-click the app → select Open → click Open in the dialog
  2. Or in Terminal: xattr -d com.apple.quarantine ~/Downloads/PKHeX.Avalonia.app

Project Structure

  • PKHeX.Avalonia: The main application (cross-platform).
  • Legacy/PKHeX.WinForms: The original Windows Forms application, kept as a reference archive.
  • PKHeX.Core: Shared logic library (synced from upstream PKHeX).

Features

  • Save Editing: Core series save files (.sav, .dsv, .dat, .gci, .bin).
  • Entity Files: Import and export .pk*, .ck3, .xk3, .pb7, and more.
  • Mystery Gifts: Support for .pgt, .pcd, .pgf, and .wc* files.
  • Transferring: Move Pokémon between generations while converting formats automatically.

Building from Source

Requirements

Run

dotnet run --project PKHeX.Avalonia

Build

dotnet build PKHeX.sln -c Release

Test

dotnet test PKHeX.sln

Publish (example: macOS ARM)

dotnet publish PKHeX.Avalonia -c Release -r osx-arm64 --self-contained -p:PublishSingleFile=true

Versioning

PKHeX Avalonia uses semantic versioning (1.0.0, 1.1.0, etc.) for the UI application. PKHeX.Core follows the upstream date-based versioning scheme.

To create a release, bump the <UIVersion> value in Directory.Build.props and push to main. The release workflow detects the new version, creates the git tag, builds all 4 platforms, and publishes a GitHub release — no manual tagging required.

Screenshots

Work in progress — the UI is changing fast. Screenshot 2026-01-21 at 20 46 16 Screenshot 2026-01-21 at 20 46 36 Screenshot 2026-01-21 at 20 46 48 Screenshot 2026-01-21 at 20 47 06 Screenshot 2026-01-21 at 20 47 32

Credits

This fork is built on the incredible work of the PKHeX team.

  • Logic & Research: PKHeX
  • QR Codes: QRCoder (MIT)
  • Sprites: pokesprite (MIT)
  • Arceus Sprites: National Pokédex - Icon Dex project and contributors.

About

A cross-platform fork of the Pokémon save file editor "PKHeX" built with .NET 10 and Avalonia.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages