Installation

For your convenience, there is an installer available to help you download and setup JoyDX up using the following.

/bin/bash -c "$(curl -fsSL https://joydx.com/installer.sh)"

Download Details

The following table describes the various types of package available from the JoyDX Releases repository. Assets are packaged within zip format to save bandwidth. Checksums and GPG signatures are available for verifying release integrity.

Platform Architecture Note Download Link
MacOS Apple Silicon (M1, M2, etc.) joydx-darwin-arm64.zip
MacOS Apple Silicon (M1, M2, etc.) Command Line Interface only joydx-darwin-arm64-cli.zip
MacOS Intel Silicon joydx-darwin-amd64.zip
MacOS Intel Silicon Command Line Interface only joydx-darwin-amd64-cli.zip
Linux AMD64 Webkit Version 4 (legacy) joydx-linux-amd64.zip
Linux AMD64 Webkit Version ^4.1 joydx-linux-amd64-webkit241.zip
Linux AMD64 Command Line Interface only joydx-linux-amd64-cli.zip
Linux ARM64 Webkit Version 4 (legacy) joydx-linux-arm64.zip
Linux ARM64 Version 4.1 joydx-linux-arm64-webkit241.zip
Linux ARM64 Command Line Interface only joydx-linux-arm64-cli.zip
Windows AMD64 Installer joydx-windows-amd64-installer.exe
Windows AMD64 joydx-windows-amd64.zip
Windows AMD64 Command Line Interface only joydx-windows-amd64-cli.zip
Windows AMD64 Installer joydx-windows-arm64-installer.exe
Windows ARM64 joydx-windows-arm64.zip
Windows ARM64 Command Line Interface only joydx-windows-arm64-cli.zip

Note for Windows users

If you are a Windows user installing manually and want to use JoyDX from both the GUI and CLI, it is recommended to use the installer. You will need to download both versions independently or use the GUI version and activate the system environment which will automatically download and setup the CLI version.

Note for Linux GUI users

For the graphical variants on Linux, there are two builds for each architecture due to some of the underlying system libraries used for managing window behaviour. Unless you are running a distribution released before 2024, you will likely want to use the webkit241 version

Download Integrity

If you would like to verify the authenticity of your downloads, checksums and PGP signatures are available on the Github releases page. The built in update function will automatically verify integrity using a built-in public key and the checksum from the releases page.

To retrieve a copy of the public PGP key used to sign compiled apps identified by simon@joydx.com, click here. If your PGP client supports Web Key Directory, this site is also configured to expose the key appropriately.

Podman

If you use JoyDX to manage Podman, there may be some prerequisites

Distribution Note
Ubuntu 24.04 Install qemu-utils qemu-system-x86
Windows Not yet available due to only recently targeting Windows. Needs testing

If instructions for your setup have are not included above, please get in contact