# Install chocolate-doom with Homebrew, apk, apt, dnf, Nix, zypper Accurate source port of Doom. Version 3.1.1 via Homebrew; verified 2026-06-18. ## Install ```sh sudo av install brew:chocolate-doom ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install chocolate-doom ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add chocolate-doom ``` Evidence: Alpine Linux edge package indexes: chocolate-doom from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install chocolate-doom ``` Evidence: Debian stable package indexes: chocolate-doom from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install chocolate-doom ``` Evidence: Fedora Rawhide package metadata: chocolate-doom from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#chocolate-doom ``` Evidence: nixpkgs package indexes: pkgs/by-name/ch/chocolate-doom/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install chocolate-doom ``` Evidence: openSUSE Tumbleweed package metadata: chocolate-doom from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:chocolate-doom - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.1.1 - **Source summary:** Accurate source port of Doom - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-2.0-or-later - **Source archive:** - **Last updated:** 2026-06-18T02:28:55-04:00 - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - chocolate-doom (cli) - chocolate-doom-setup (cli) - chocolate-heretic (cli) - chocolate-heretic-setup (cli) - chocolate-hexen (cli) - chocolate-hexen-setup (cli) - chocolate-server (cli) - chocolate-strife (cli) - chocolate-strife-setup (cli) - chocolate-doom (alias) - chocolate-doom-setup (alias) - chocolate-heretic (alias) - chocolate-heretic-setup (alias) - chocolate-hexen (alias) - chocolate-hexen-setup (alias) - chocolate-server (alias) - chocolate-strife (alias) - chocolate-strife-setup (alias) ## Dependencies - fluid-synth - libpng - libsamplerate - sdl2-compat - sdl2_mixer - sdl2_net ## Build dependencies - autoconf - automake - pkgconf ## Install behavior - Post-install hook: not defined - Caveats: Note that this formula only installs a Doom game engine, and no actual levels. The original Doom levels are still under copyright, so you can copy them over and play them if you already own them. Otherwise, there are tons of free levels available online. Try starting here: https://www.chocolate-doom.org/ - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 3.1.1 - Package-manager updated: 2026-06-18 - Local data: ok - Upstream repository: https://github.com/chocolate-doom/chocolate-doom - Upstream latest detected: chocolate-doom-3.1.1 (current) ## Project history and usage Chocolate Doom is a Doom source port focused on accurately reproducing the original DOS Doom experience on modern systems. ### Project history The official repository begins in July 2005, and the README says the project originally targeted Doom before expanding to include Heretic, Hexen, and Strife. Its stated goals are free software, portability, accurate DOS behavior including bugs, demo/config/save compatibility, and a retro feel. ### Adoption history The official wiki presents Chocolate Doom as an actively developed source port with downloads, a user guide, source code, and related forks. The input package facts show broad package-manager availability across Homebrew, Alpine, Debian, Fedora, Nix, Ubuntu, and openSUSE. ### How it is used Players use the chocolate-doom family of executables with original IWAD files and DOS-compatible configuration. The README documents default.cfg compatibility, the separate chocolate-doom.cfg file for extra settings, setup tools, command-line options, and -merge for total conversions that expected DOS-era IWAD merging. ### Why package nerds care Chocolate Doom is important in package-manager culture because it is a reference-quality, portability-minded Doom source port: small enough to ship widely, strict enough to preserve vanilla behavior, and useful as a baseline for forks such as Crispy Doom. ### Timeline - 2005: Initial public repository history and chocolate-doom 0.0.1 tags. - 2015: 2.2.0 release line appears in official tags. - 2017: 3.0.0 release arrives after beta tags. - 2024: 3.1.0 release appears in official tags. - 2025: 3.1.1 release appears in official tags and Homebrew tracks 3.1.1. ### Related projects - The README names Doom, Heretic, Hexen, and Strife support. The official wiki links Crispy Doom as a friendly fork that adds extra features. ### Sources - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: SDL_GetPrefPath("", "chocolate-doom")/default.cfg, SDL_GetPrefPath("", "chocolate-doom")/chocolate-doom.cfg - Windows: ./default.cfg, ./chocolate-doom.cfg ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** chocolate-doom - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - chocolate-doom - 3.1.0-1: normalized package name match | Debian stable package indexes: chocolate-doom from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Doom engines closely-compatible with Vanilla Doom | https://www.chocolate-doom.org - Nix - chocolate-doom: normalized package name match | nixpkgs package indexes: pkgs/by-name/ch/chocolate-doom/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - chocolate-doom - 3.0.1+really3.0.0+git1548-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: chocolate-doom from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Doom engines closely-compatible with Vanilla Doom | https://chocolate-doom.org/ - apk - chocolate-doom - 3.1.1-r0: normalized package name match | Alpine Linux edge package indexes: chocolate-doom from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Portable release of Doom, Heretic, Hexen, and Strife | https://www.chocolate-doom.org - apk - chocolate-doom-doc - 3.1.1-r0: normalized package name match | Alpine Linux edge package indexes: chocolate-doom-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Portable release of Doom, Heretic, Hexen, and Strife (documentation) | https://www.chocolate-doom.org - dnf - chocolate-doom - 3.1.1-1.fc44: normalized package name match | Fedora Rawhide package metadata: chocolate-doom from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Historically compatible Doom engine | http://chocolate-doom.org/ - zypper - chocolate-doom - 3.1.1-1.4: normalized package name match | openSUSE Tumbleweed package metadata: chocolate-doom from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Conservative DOOM/Heretic/Hexen/Strife source port | http://chocolate-doom.org/ ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [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. - [fluid-synth](https://www.automicvault.com/pkg/brew/fluid-synth/) - Runtime dependency declared by Homebrew. - [libpng](https://www.automicvault.com/pkg/brew/libpng/) - Runtime dependency declared by Homebrew. - [sdl2-compat](https://www.automicvault.com/pkg/brew/sdl2-compat/) - Runtime dependency declared by Homebrew. - [autoconf](https://www.automicvault.com/pkg/brew/autoconf/) - Build dependency declared by Homebrew. - [automake](https://www.automicvault.com/pkg/brew/automake/) - Build dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [crispy-doom](https://www.automicvault.com/pkg/brew/crispy-doom/) - Shares av.db curated category or tags: cli, doom, game-engine, games, retro-gaming. - [openjazz](https://www.automicvault.com/pkg/brew/openjazz/) - Shares av.db curated category or tags: cli, game-engine, games, retro-gaming, sdl. - [woof-doom](https://www.automicvault.com/pkg/brew/woof-doom/) - Shares av.db curated category or tags: cli, doom, game-engine, games, retro-gaming. - [dsda-doom](https://www.automicvault.com/pkg/brew/dsda-doom/) - Shares av.db curated category or tags: cli, doom, game-engine, games, source-port. - [exult](https://www.automicvault.com/pkg/brew/exult/) - Shares av.db curated category or tags: cli, game-engine, games, sdl. - [freedink](https://www.automicvault.com/pkg/brew/freedink/) - Shares av.db curated category or tags: cli, game-engine, games, sdl. - [arx-libertatis](https://www.automicvault.com/pkg/brew/arx-libertatis/) - Shares av.db curated category or tags: cli, game-engine, games. - [blastem](https://www.automicvault.com/pkg/brew/blastem/) - Shares av.db curated category or tags: cli, games, retro-gaming. ## Combined YAML source View the package source record on GitHub. [combined/chocolate-doom.yml](https://github.com/automic-vault/db/blob/main/combined/chocolate-doom.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - 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