Skip to content
Gearlynx

Gearlynx

ATARI LYNX EMULATOR CORE

Gearlynx

Gearlynx is the libretro/standalone port of the GearLynx Atari Lynx emulator — a modern, accurate Lynx implementation with debugger and optional MCP server. It is distributed as an open-source libretro core and as standalone binaries for desktop platforms.

Atari LynxPRIMARY SYSTEM
History documentedPROJECT BEGAN
Open sourcePROJECT MODEL

WHY IT MATTERS

Why Gearlynx matters

Gearlynx provides one of the most accurate Atari Lynx emulation experiences available, with wide platform coverage via a libretro core and a feature-rich standalone build (debugger, MCP server, run-ahead, ComLynx multiplayer). It targets preservation and development workflows as well as casual play.

BEST FOR

Best for

Users who want high-accuracy Atari Lynx emulation inside RetroArch (libretro) or as a desktop application with advanced debugging, multiplayer ComLynx support, and modern conveniences like save states, run-ahead and shader chains.

The people behind Gearlynx

History and upstream

Gearlynx is the libretro-portable and standalone distribution of the GearLynx emulator authored and maintained in the drhelius/Gearlynx repository. The project has a long commit history and is actively packaged as both a libretro core and standalone binaries for Windows, macOS and Linux. The GitHub repository documents desktop downloads, packaged installers, and a libretro core page in the official Libretro documentation. The project README and core-info entries identify Gearlynx as a GPLv3-licensed, actively maintained core with features targeted at accuracy and developer tooling (embedded MCP server, debugger, symbol support).

What Gearlynx supports

  • Atari Lynx (commercial catalog and homebrew formats)
  • Libretro/RetroArch via Gearlynx core
  • Standalone desktop builds for Windows, macOS, Linux, BSD
  • ComLynx multiplayer (networked emulator instances)
  • Save states, run-ahead, rewind, VGM recording

Download and availability

OFFICIAL DOWNLOADS

Get Gearlynx

Official core documentation and download instructions live in the Libretro docs core list and the Gearlynx project releases page on GitHub. Libretro users typically obtain the core through RetroArch's Online Updater (Core Downloader) or by following the Gearlynx entry in the Libretro documentation. Standalone prebuilt binaries and platform-specific install instructions are provided in the Gearlynx GitHub repository releases and README.

Get Gearlynx ↗

DOCUMENTATION

Official documentation

Read the official configuration, compatibility, and troubleshooting material before changing advanced options.

Read official documentation ↗
Broken or missing download? Emulator projects move and official links sometimes change. Please contact Retro Replay so the source can be verified and updated.

Gearlynx setup guide

Setup note: Below are practical setup steps for both using the Gearlynx libretro core in RetroArch and running the standalone Gearlynx application. Gearlynx requires a Lynx BIOS to emulate official hardware behavior; the guide shows how to configure BIOS placement for both frontend and standalone usage, how to install the libretro core, and important core options and runtime tips.

  1. 1) Obtain Gearlynx libretro core: Open RetroArch, go to Online Updater → Core Updater, and download the 'Gearlynx' core. Alternatively, follow the Libretro docs core list entry for Gearlynx to confirm the core name and location. If RetroArch does not list Gearlynx for your platform, download the core manually from the Libretro core repository or use the standalone GitHub releases (see sources).
  2. 2) Place BIOS for RetroArch and standalone: Gearlynx requires an Atari Lynx BIOS file for correct operation. Obtain the legal BIOS image (you must source this yourself). For RetroArch: put the BIOS file in RetroArch's system directory (Frontend settings → Directory → System/BIOS directory) or the platform-specific system folder RetroArch expects. For standalone Gearlynx: place the BIOS in the same directory as the executable or configure the standalone app's BIOS path via its GUI or command line as documented in the repository README. Use the exact BIOS recommended by the project if you want best compatibility; the repository README references the original BIOS checksum as the recommended file.
  3. 3) Supported ROM formats and loading: Gearlynx accepts common Lynx ROM formats (lnx, lyx, o, bin) and ZIP archives. In RetroArch, use Load Core → select Gearlynx → Load Content and choose a ROM file. For the standalone app, either drag-and-drop a ROM onto the executable or run `gearlynx path/to/game.rom` from a terminal/command prompt. The standalone build also supports command-line options for fullscreen, portable mode and auto-starting the MCP server.
  4. 4) Important core options and runtime behavior: Configure core options through RetroArch's Quick Menu → Options or through the standalone GUI: select Lynx I or Lynx II hardware profile, enable/disable run-ahead, configure audio low-pass filter and ComLynx network parameters. Gearlynx reports a dynamic refresh rate based on each game's timer configuration; allow RetroArch to use the core's refresh if you want correct timing. If you enable run-ahead or rewind, be aware of the increased CPU usage.
  5. 5) Multiplayer (ComLynx) setup: Gearlynx supports ComLynx multiplayer across multiple emulator instances. For RetroArch, launch multiple instances on the same machine (or separate machines if supported) and configure the core networking options to use the same ComLynx channel or IP/port as documented. For standalone builds, the README describes ComLynx and GameDrive/ElCheapoSD cartridge APIs and how to enable them. Test with known two-player ROMs and ensure firewall rules do not block local connections if instances are on different machines.
  6. 6) Debugging and developer features (standalone): The standalone Gearlynx build includes a full debugger and an MCP server for tooling and AI-assisted debugging. Use the GUI debugger for breakpoints, CPU and memory inspection, and Suzy/Mikey register viewers. To use the MCP server, follow the MCP README in the repository to start the server with stdio or HTTP transports and interact with the exposed endpoints. These features are especially useful for homebrew development and reverse engineering.
  7. 7) Platform-specific notes: Standalone packages are provided for Windows (may require Visual C++ redistributable and OpenGL compatibility components), macOS (Homebrew cask is documented), and Linux (PPAs, RPMs and zipped builds). On Linux, ensure required libraries (for example SDL) are installed. On mobile or console RetroArch ports, availability of the Gearlynx core depends on the platform build and core maintainers; use RetroArch's Online Updater where possible.
  8. 8) Troubleshooting and tips: If games fail to start, verify BIOS file and placement, check that the ROM is a valid Lynx image and not an unsupported format, and confirm the core version. For timing or audio issues, try enabling/disabling the core's dynamic refresh or switching Lynx I/II profiles. For advanced issues, consult the Gearlynx GitHub issues page and the libretro documentation entry for Gearlynx.

Software reminder: Gearlynx does not include commercial Lynx games, firmware, or BIOS images. You must provide legally obtained BIOS and ROM files yourself. Follow all applicable laws and licenses when acquiring BIOS and game images.

Sources and further reading

Detailed guides and tutorials

Explore step-by-step guides for Gearlynx as they are published.

Use Gearlynx on Android

An Android ARM64 Libretro build exists for Gearlynx. Run the core through RetroArch for Android; the standalone desktop download and Android core may have different menus and features.

Emulates: Atari Lynx.

Verified Android core build ↗ · Browse all Android emulators →