# Install solarus with Homebrew, Nix, zypper

Action-RPG game engine. Version 2.0.4 via Homebrew; verified 2026-06-25.

## Install

```sh
sudo av install brew:solarus
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install solarus
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#solarus
```

  Evidence: nixpkgs package indexes: pkgs/by-name/so/solarus/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install libsolarus-gui1
```

  Evidence: openSUSE Tumbleweed package metadata: libsolarus-gui1 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:solarus
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/solarus>
- **Version:** 2.0.4
- **Source summary:** Action-RPG game engine
- **Homepage:** <https://www.solarus-games.org/>
- **Repository:** <https://gitlab.com/solarus-games/solarus>
- **Upstream docs:** <https://docs.solarus-games.org/>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://gitlab.com/solarus-games/solarus.git>
- **Last updated:** 2026-06-25T13:38:08+02:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- solarus-run (cli)
- solarus-run (alias)

## Dependencies

- glm
- libmodplug
- libogg
- libvorbis
- luajit
- openal-soft
- physfs
- sdl2-compat
- sdl2_image
- sdl2_ttf

## Build dependencies

- cmake

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.0.4
- Package-manager updated: 2026-06-25
- Local data: ok
- Upstream repository: https://www.solarus-games.org/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Solarus is a free and open-source 2D game engine and toolchain for making Lua-scripted action-RPG games, distributed to package-manager users primarily through the `solarus-run` command-line runner and companion graphical tools.

### Project history

The official project describes Solarus as a C++ engine designed with 16-bit classic action-RPGs in mind and able to run games scripted in Lua. Its current GitLab project describes the wider distribution as a 2D game engine with a game editor and game launcher.

Solarus moved through a long 1.x release series before the 2.x line. The official changelog records Solarus 1.6.5 in 2021 and Solarus 2.0.0 on April 1, 2025, with the 2.0 release adding multiplayer-oriented engine changes such as multiple maps, cameras, heroes, and game controllers.

### Adoption history

Solarus has remained a niche but recognizable open-source game-engine package: the supplied package-manager facts list it in Homebrew, Nix, and openSUSE/zypper, while the official site publishes games, downloads, documentation, and release news.

For package users, Solarus is most often interesting as a runtime for packaged quests and as a reproducible engine dependency for game projects that script gameplay in Lua.

### How it is used

The repository identifies `solarus-run` as the CLI used to play Solarus games, alongside the Solarus Launcher for playing and Solarus Editor for creating games. Documentation and tutorials live on the official Solarus docs site.

### Why package nerds care

Solarus matters to package maintainers because it sits at the intersection of game engines, Lua scripting, SDL-style native dependencies, desktop launchers, and content runtimes. It is the sort of package where ABI compatibility, asset paths, and platform support can matter as much as the executable itself.

### Timeline

- 2015: Solarus 1.4.5 appears in the official GitLab tag history.
- 2018: Solarus 1.6.0 appears in the official GitLab tag history.
- 2021: Solarus 1.6.5 is recorded in the official changelog.
- 2025: Solarus 2.0.0 is released with multiplayer-oriented engine changes.
- 2026: Solarus 2.0.4 is listed by the official site as the stable version.

### Related projects

- Solarus Launcher and Solarus Editor are companion applications named in the official repository README. Solarus games, or quests, are the content packages run by the engine.

### Sources

- Input package-manager facts: source_facts.package-manager
- Official changelog: https://gitlab.com/solarus-games/solarus/-/blob/dev/changelog.md
- Official documentation: https://docs.solarus-games.org/
- Official repository README: https://gitlab.com/solarus-games/solarus
- Official site: https://www.solarus-games.org/


## 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:** solarus
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - solarus: normalized package name match | nixpkgs package indexes: pkgs/by-name/so/solarus/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- zypper - libsolarus-gui1 - 1.6.5-3.3: normalized package name match | openSUSE Tumbleweed package metadata: libsolarus-gui1 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Solarus game engine shared library (GUI parts) | https://www.solarus-games.org/
- zypper - libsolarus1 - 1.6.5-3.3: normalized package name match | openSUSE Tumbleweed package metadata: libsolarus1 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Solarus game engine shared library | https://www.solarus-games.org/
- zypper - solarus - 1.6.5-3.3: normalized package name match | openSUSE Tumbleweed package metadata: solarus from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Game engine for action RPGs | https://www.solarus-games.org/
- zypper - solarus-devel - 1.6.5-3.3: normalized package name match | openSUSE Tumbleweed package metadata: solarus-devel from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Development files for solarus | https://www.solarus-games.org/
- zypper - solarus-gui - 1.6.5-3.3: normalized package name match | openSUSE Tumbleweed package metadata: solarus-gui from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Graphical user interface to launch Solarus games | https://www.solarus-games.org/
- zypper - solarus-gui-lang - 1.6.5-3.3: normalized package name match | openSUSE Tumbleweed package metadata: solarus-gui-lang from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Translations for package solarus-gui | https://www.solarus-games.org/


## 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.
- [luajit](https://www.automicvault.com/pkg/brew/luajit/) - Runtime dependency declared by Homebrew.
- [openal-soft](https://www.automicvault.com/pkg/brew/openal-soft/) - Runtime dependency declared by Homebrew.
- [physfs](https://www.automicvault.com/pkg/brew/physfs/) - Runtime dependency declared by Homebrew.
- [sdl2-compat](https://www.automicvault.com/pkg/brew/sdl2-compat/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [zelda-roth-se](https://www.automicvault.com/pkg/brew/zelda-roth-se/) - Popular package that depends on this formula.
- [zsdx](https://www.automicvault.com/pkg/brew/zsdx/) - Popular package that depends on this formula.
- [zsxd](https://www.automicvault.com/pkg/brew/zsxd/) - Popular package that depends on this formula.
- [corsixth](https://www.automicvault.com/pkg/brew/corsixth/) - Shares av.db curated category or tags: cli, game-engine, games, lua.
- [arx-libertatis](https://www.automicvault.com/pkg/brew/arx-libertatis/) - Shares av.db curated category or tags: cli, game-engine, games.
- [crispy-doom](https://www.automicvault.com/pkg/brew/crispy-doom/) - Shares av.db curated category or tags: cli, game-engine, games.
- [exult](https://www.automicvault.com/pkg/brew/exult/) - Shares av.db curated category or tags: cli, game-engine, games.
- [freedink](https://www.automicvault.com/pkg/brew/freedink/) - Shares av.db curated category or tags: cli, game-engine, games.
- [openjazz](https://www.automicvault.com/pkg/brew/openjazz/) - Shares av.db curated category or tags: cli, game-engine, games.
- [dsda-doom](https://www.automicvault.com/pkg/brew/dsda-doom/) - Shares av.db curated category or tags: cli, game-engine, games.
- [easyrpg-player](https://www.automicvault.com/pkg/brew/easyrpg-player/) - Shares av.db curated category or tags: cli, game-engine, games.

## Combined YAML source

View the package source record on GitHub. [combined/solarus.yml](https://github.com/automic-vault/db/blob/main/combined/solarus.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
- external package-manager database matches
- cross-ecosystem install command graph
