Skip to content

Releases: iglpm/hyprcross

hyprcross v2027.0.0-rc.1 (Beta / Pre-release)

Choose a tag to compare

@runified runified released this 18 Oct 01:39

Added

  • Native macOS Cross-Compilation: Zero-Docker cross-compilation pipeline on Linux and
    Windows hosts for aarch64-apple-darwin and x86_64-apple-darwin. Automatically fetches,
    verifies, and caches minimal macOS SDK stubs (MacOSX26.1.sdk from joseluisq/macosx-sdks)
    into ~/.local/share/hyprcross/sdks/MacOSX.sdk (Linux) or %LOCALAPPDATA%\hyprcross\sdks\MacOSX.sdk
    (Windows), overridable with HYPRCROSS_MACOS_SDK_PATH or SDKROOT. Links Mach-O binaries
    directly via hyprlnk with -C linker-flavor=ld64.lld and -isysroot.
  • Searchable targets Command: hyprcross targets [query] supports searching by natural
    keywords (e.g. hyprcross targets "windows arm", hyprcross targets macos, hyprcross targets musl).
    Lists all supported targets, standard library installation status, build engine, and test runners.
  • Crates.io Publishing & cargo-hyprcross Crate: Added standalone cargo-hyprcross crate
    in crates/cargo-hyprcross to support cargo install cargo-hyprcross directly from crates.io.
  • Pre-Release Workflow: Release workflow automatically differentiates -rc.x pre-releases
    from stable releases, tagging GitHub Releases as beta / pre-release and publishing to crates.io.

Changed

  • Cleaner Image Pull UI: Replaced raw, noisy container engine logs during podman pull and
    docker pull with custom hyprcross progress bars and layer download phase indicators.
  • Smarter Auto Engine: engine = "auto" automatically chooses direct host execution for
    host targets, macOS targets, targets without C dependencies (Wasm, bare metal), and targets
    with local cross-compilers installed, using container images only when needed.

How to Upgrade & Install hyprcross

Option 1: Upgrade via Cargo (Recommended for Rust Developers)

To upgrade your existing installation (or install fresh) with Cargo, use the --force flag so Cargo overwrites previous binaries:

# Upgrade hyprcross and the cargo-hyprcross subcommand plugin:
cargo install --locked hyprcross cargo-hyprcross --version 2027.0.0-rc.1 --force

After updating, verify that you are running the new version:

hyprcross --version
cargo hyprcross --version

Option 2: Pre-compiled Binaries (No Rust Toolchain Needed)

Download and extract the ready-to-run binary package for your operating system and architecture directly:

Linux & macOS (Shell)

# 1. Download and extract the archive for your architecture (example: Linux x86_64):
curl -fsSL "https://github.com/runepm/hyprcross/releases/download/v2027.0.0-rc.1/hyprcross-x86_64-unknown-linux-gnu.tar.gz" | tar -xz

# 2. Move hyprcross and cargo-hyprcross into your system PATH:
sudo install -m 755 hyprcross cargo-hyprcross /usr/local/bin/

# 3. Verify the upgrade:
hyprcross --version
cargo hyprcross --version

Windows (PowerShell)

# 1. Download the archive for 64-bit Windows:
Invoke-WebRequest -Uri "https://github.com/runepm/hyprcross/releases/download/v2027.0.0-rc.1/hyprcross-x86_64-pc-windows-gnu.zip" -OutFile "hyprcross.zip"

# 2. Extract the binaries to your user Cargo bin directory (or any directory in your PATH):
Expand-Archive -Path "hyprcross.zip" -DestinationPath "$HOME\.cargo\bin" -Force

# 3. Verify the upgrade:
hyprcross --version

Download Binaries

Click any link in the Direct Download column to immediately download the pre-compiled archive. Each package contains standalone hyprcross and cargo-hyprcross binaries.

Platform Target Triple Direct Download Link Checksum Description
Linux (glibc) x86_64-unknown-linux-gnu Download hyprcross-x86_64-unknown-linux-gnu.tar.gz SHA-256 Standard 64-bit Linux (Ubuntu, Debian, Fedora, Arch, CentOS)
Linux (musl static) x86_64-unknown-linux-musl Download hyprcross-x86_64-unknown-linux-musl.tar.gz SHA-256 Statically linked Linux binary (Alpine Linux, scratch containers)
Linux ARM64 (glibc) aarch64-unknown-linux-gnu Download hyprcross-aarch64-unknown-linux-gnu.tar.gz SHA-256 64-bit ARM Linux (Raspberry Pi 4/5 64-bit, AWS Graviton, server ARM)
Linux ARM64 (musl static) aarch64-unknown-linux-musl Download hyprcross-aarch64-unknown-linux-musl.tar.gz SHA-256 Statically linked 64-bit ARM Linux (Alpine ARM64)
macOS Apple Silicon aarch64-apple-darwin Download hyprcross-aarch64-apple-darwin.tar.gz SHA-256 Apple Silicon Macs (arm64) running macOS 11+
macOS Intel x86_64-apple-darwin Download hyprcross-x86_64-apple-darwin.tar.gz SHA-256 Intel-based Macs (x86_64) running macOS 10.12+
Windows (64-bit) x86_64-pc-windows-gnu Download hyprcross-x86_64-pc-windows-gnu.zip SHA-256 64-bit Windows standalone executable (Windows 10/11, Server)
Windows (32-bit) i686-pc-windows-gnu Download hyprcross-i686-pc-windows-gnu.zip SHA-256 32-bit Windows standalone executable (x86)

Tip

To verify an archive's integrity after downloading:

  • Linux: sha256sum -c hyprcross-<target>.tar.gz.sha256
  • macOS: shasum -a 256 -c hyprcross-<target>.tar.gz.sha256
  • Windows (PowerShell): Get-FileHash hyprcross-<target>.zip -Algorithm SHA256