# Install joyce with Homebrew

Emulates the Amstrad PCW on Unix, Windows and macOS. Version 2.4.2 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:joyce
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install joyce
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:joyce
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/joyce>
- **Version:** 2.4.2
- **Source summary:** Emulates the Amstrad PCW on Unix, Windows and macOS
- **Homepage:** <https://www.seasip.info/Unix/Joyce/index.html>
- **Upstream docs:** <https://www.seasip.info/Unix/Joyce/faq.html>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://www.seasip.info/Unix/Joyce/joyce-2.4.2.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- dskconv (cli)
- dsklabel (cli)
- lsgotek (cli)
- xanne (cli)
- xjoyce (cli)
- dskconv (alias)
- dsklabel (alias)
- lsgotek (alias)
- xanne (alias)
- xjoyce (alias)

## Dependencies

- libdsk
- libpng
- sdl12-compat

## Uses from macOS

- libxml2

## 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.4.2
- Local data: ok
- Upstream repository: https://www.seasip.info/Unix/Joyce/index.html
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

JOYCE is John Elliott's Amstrad PCW emulator for Unix, Windows, and macOS. It emulates the PCW family and incorporates ANNE for the PcW16, preserving a British word-processor/computer line whose original development codename, Joyce, became the emulator's name.

### Project history

The official JOYCE page describes an SDL-based emulator for the Amstrad PCW on Unix, Windows, and Mac OS X, with possible portability to other SDL-supported platforms. The FAQ documents emulation of the Z80 CPU, screen, keyboard, floppy controller, Centronics ports, serial interface, built-in PCW printers, mice, light pen, beeper, and LocoLink.

The update history reaches at least December 2002 with JOYCE v2.0.2 and continues through the 2.2 stable series, 2.4 stable series, and 2.5 development series. Later entries added or repaired hard-drive emulation, host-directory drive support, PcW16 acceleration, joystick support, disk-format support, Mac OS X build support, printer output, PCW-Linkit, and PDF/PNG output paths.

### Adoption history

JOYCE is niche by normal package-manager standards, but valuable in retrocomputing because it packages PCW and PcW16 emulation for modern systems. Homebrew packaging makes xjoyce and companion disk utilities available to macOS users without manually building an older SDL-based emulator stack.

### How it is used

JOYCE is used to boot and run Amstrad PCW software from disk images, use emulated printers and ports, share files through emulated drives, and preserve workflows around CP/M, LocoScript, PCW games, and PcW16 software. The FAQ is careful about boot disk legality, noting that copyrighted boot disks cannot simply be redistributed.

### Why package nerds care

JOYCE matters to package nerds because it is the sort of emulator that keeps historically specific hardware usable from a standard package manager. Its formula bundles not just a main emulator but disk and utility commands, which is typical of preservation-oriented emulator packages.

### Timeline

- 2002-12: JOYCE v2.0.2 stable was released.
- 2007-12: JOYCE v2.2.0 stable was released.
- 2021-12: JOYCE v2.4.0 stable was released.
- 2023-05: JOYCE v2.4.2 stable was released with C++17 compilation fixes.
- 2026-03: JOYCE v2.5.5 development was released.

### Related projects

- JOYCE is paired with ANNE for PcW16 emulation and is related to the Amstrad PCW, CP/M, LocoScript, DSK disk-image tooling, LocoLink, PCW public-domain software archives, and other PCW emulators and preservation projects.

### Sources

- <https://formulae.brew.sh/formula/joyce>
- <https://www.seasip.info/Unix/Joyce/download.html>
- <https://www.seasip.info/Unix/Joyce/faq.html>
- <https://www.seasip.info/Unix/Joyce/index.html>


## 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:** joyce
- **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


## 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.
- [Web development packages](https://www.automicvault.com/pkg/web-dev-tools/) - Matched web development metadata.
- [libdsk](https://www.automicvault.com/pkg/brew/libdsk/) - Runtime dependency declared by Homebrew.
- [libpng](https://www.automicvault.com/pkg/brew/libpng/) - Runtime dependency declared by Homebrew.
- [sdl12-compat](https://www.automicvault.com/pkg/brew/sdl12-compat/) - Runtime dependency declared by Homebrew.
- [blastem](https://www.automicvault.com/pkg/brew/blastem/) - Shares av.db curated category or tags: cli, emulation, emulator, games.
- [dosbox-staging](https://www.automicvault.com/pkg/brew/dosbox-staging/) - Shares av.db curated category or tags: cli, emulation, emulator, games.
- [dosbox-x](https://www.automicvault.com/pkg/brew/dosbox-x/) - Shares av.db curated category or tags: cli, emulation, emulator, games.
- [fceux](https://www.automicvault.com/pkg/brew/fceux/) - Shares av.db curated category or tags: cli, emulation, emulator, games.
- [huexpress](https://www.automicvault.com/pkg/brew/huexpress/) - Shares av.db curated category or tags: cli, emulation, emulator, games.
- [mame](https://www.automicvault.com/pkg/brew/mame/) - Shares av.db curated category or tags: cli, emulation, emulator, games.
- [mednafen](https://www.automicvault.com/pkg/brew/mednafen/) - Shares av.db curated category or tags: cli, emulation, emulator, games.
- [mupen64plus](https://www.automicvault.com/pkg/brew/mupen64plus/) - Shares av.db curated category or tags: cli, emulation, emulator, games.

## Combined YAML source

View the package source record on GitHub. [combined/joyce.yml](https://github.com/automic-vault/db/blob/main/combined/joyce.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
