# Install zsdx with Homebrew

Zelda Mystery of Solarus DX. Version 1.12.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:zsdx
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install zsdx
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:zsdx
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/zsdx>
- **Version:** 1.12.3
- **Source summary:** Zelda Mystery of Solarus DX
- **Homepage:** <https://www.solarus-games.org/games/the-legend-of-zelda-mystery-of-solarus-dx>
- **Repository:** <https://gitlab.com/solarus-games/games/zsdx>
- **Upstream docs:** <https://www.solarus-games.org/games/the-legend-of-zelda-mystery-of-solarus-dx>
- **License:** CC-BY-SA-4.0 AND GPL-3.0-only
- **Source archive:** <https://gitlab.com/solarus-games/games/zsdx/-/archive/v1.12.3/zsdx-v1.12.3.tar.bz2>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- zsdx (cli)
- zsdx (alias)

## Dependencies

- solarus

## Build dependencies

- cmake

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.12.3
- Local data: ok
- Upstream repository: https://www.solarus-games.org/games/the-legend-of-zelda-mystery-of-solarus-dx
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

The Legend of Zelda: Mystery of Solarus DX is a free Zelda-style action RPG built with the Solarus engine. As a package, zsdx is both a playable fangame and a reference-sized example of a Solarus quest distributed through Unix package managers.

### Project history

Mystery of Solarus DX sits in the Solarus project's origin story: Solarus began as a Zelda fangame effort and later became a reusable 2D action-RPG engine. The official Solarus game page presents Mystery of Solarus DX as one of the project's games and links it with Solarus documentation and walkthrough material.

The public GitLab project for solarus-games/games/zsdx was created on 2018-06-07, reflecting the move of the game's data and scripts into the modern Solarus Games source-hosting setup rather than the original early-2000s fan-project distribution path.

### Adoption history

zsdx's audience is narrow but durable: Solarus players, Zelda fangame historians, and engine users who want a complete quest to inspect. Its inclusion in Homebrew makes the game easy to install as a packaged Solarus title instead of asking users to manually pair a quest archive with an engine build.

The game also functions as adoption material for Solarus itself. A complete quest with maps, scripts, assets, and walkthrough documentation is more persuasive for engine users than a minimal demo.

### How it is used

Users launch the packaged `zsdx` command to play the quest. Developers and modders can study the GitLab project as a Solarus quest layout, including data files and Lua scripts used by the engine.

The official walkthrough is the practical user-facing documentation: it treats the package as a full game rather than a library or tool.

### Why package nerds care

zsdx is package-nerd significant because it is game content packaged like a command-line program. It shows the awkward but useful boundary between an engine package and a quest/game-data package.

It is also a preservation case: package managers can keep a historically important open-source fangame installable even when its audience is much smaller than mainstream desktop games.

### Timeline

- 2010s: Solarus grows from a Zelda fangame project into a reusable 2D action-RPG engine and game ecosystem.
- 2018-06-07: The solarus-games/games/zsdx GitLab project is created.
- 2020s: The official Solarus site continues to publish the game page and walkthrough for Mystery of Solarus DX.

### Related projects

- Related projects include Solarus, Solarus Launcher, Zelda: Mystery of Solarus XD, Zelda: Return of the Hylian, and other Solarus quest projects.

### Sources

- <https://gitlab.com/api/v4/projects/solarus-games%2Fgames%2Fzsdx>
- <https://gitlab.com/solarus-games/games/zsdx>
- <https://www.solarus-games.org/games/the-legend-of-zelda-mystery-of-solarus-dx>
- <https://www.solarus-games.org/walkthroughs/the-legend-of-zelda-mystery-of-solarus-dx>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** zsdx
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Game and emulation packages](https://www.automicvault.com/pkg/game-emulation-tools/) - Matched game or emulation metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [solarus](https://www.automicvault.com/pkg/brew/solarus/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [zsxd](https://www.automicvault.com/pkg/brew/zsxd/) - Shares av.db curated category or tags: action-rpg, adventure, cli, game, games.
- [zelda-roth-se](https://www.automicvault.com/pkg/brew/zelda-roth-se/) - Shares av.db curated category or tags: cli, game, games, solarus, zelda-fangame.
- [pioneer](https://www.automicvault.com/pkg/brew/pioneer/) - Shares av.db curated category or tags: adventure, cli, game, games.
- [allureofthestars](https://www.automicvault.com/pkg/brew/allureofthestars/) - Shares av.db curated category or tags: cli, game, games.
- [angband](https://www.automicvault.com/pkg/brew/angband/) - Shares av.db curated category or tags: cli, game, games.
- [avanor](https://www.automicvault.com/pkg/brew/avanor/) - Shares av.db curated category or tags: cli, game, games.
- [ballerburg](https://www.automicvault.com/pkg/brew/ballerburg/) - Shares av.db curated category or tags: cli, game, games.
- [bastet](https://www.automicvault.com/pkg/brew/bastet/) - Shares av.db curated category or tags: cli, game, games.

## Combined YAML source

View the package source record on GitHub. [combined/zsdx.yml](https://github.com/automic-vault/db/blob/main/combined/zsdx.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
