gitwtfhub

wtf is osxeql?

sowoky/osxeql — explained in plain English

Analysis updated 2026-05-18

7ShellAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

A Mac app that lets Apple Silicon users play EverQuest Legends using only open-source Wine and DXMT, without CrossOver or Apple's proprietary D3DMetal.

Mindmap

mindmap
  root((repo))
    What it does
      Runs Windows game on Mac
      Wine plus DXMT translation
      Bundled runtime app
    Tech stack
      Shell
      Wine
      DXMT
      Metal
    Use cases
      Play EverQuest Legends on Apple Silicon
      Build custom Wine runtime
      Use headless CLI for setup
    Audience
      Gamers
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Play EverQuest Legends on an Apple Silicon Mac without installing CrossOver.

REASON 2

Download a signed-looking DMG, clear the quarantine flag, and let the app walk through installing the game.

REASON 3

Build the Wine and DXMT runtime from source for development or customization.

REASON 4

Use the headless osxeql CLI to script setup, install, and status checks.

What's in the stack?

ShellWineDXMTMetalPython

How it stacks up

sowoky/osxeqlcrokily/herdr-lazygitdavorpa/shell-utils
Stars777
LanguageShellShellShell
Last pushed2021-09-18
MaintenanceDormant
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencegeneraldeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Building from source needs an x86_64 Homebrew install and several specific formulas, the released DMG needs none of that.

osxEQL's own code can be used, modified, and redistributed freely, including commercially, as long as you keep the copyright notice, the bundled Wine and DXMT components carry their own LGPL terms.

Wtf does this do

osxEQL is a compatibility tool that lets you run the game EverQuest Legends on Apple Silicon Macs, using only open-source pieces. It combines a version of Wine, which is software that lets Windows programs run on other operating systems, with a project called DXMT that translates DirectX 11 graphics calls into Apple's Metal graphics system. This avoids needing CrossOver or Apple's own proprietary D3DMetal translator. The tool is unofficial and made by a fan, not affiliated with Daybreak Game Company, Game Jawn, CodeWeavers, or Apple, and it does not include the game itself, you still need your own copy from the official installer. For players, using osxEQL is straightforward: download a DMG file from the releases page, drag the app into Applications, clear a security quarantine flag with one Terminal command since the app is not signed by Apple, then download the official game installer file from the EverQuest Legends site. Launching osxEQL walks you through installing the game, and after that first setup, every launch goes straight to the game's own launcher. Nothing else needs to be installed on the player's side, since the Wine and DXMT runtime is bundled inside the app itself. Under the hood, the game is a 64-bit Direct3D 11 program, so it needs both Wine to run the Windows executable and a translator to turn its graphics calls into something macOS can render. osxEQL's Wine build comes from CodeWeavers' own published source code and includes a bridge that DXMT needs to attach to Apple's Metal system, which standard Wine builds lack. Developers who want to build osxEQL from source can do so with a series of shell scripts that compile Wine, stage DXMT, build the app icon, and assemble the final app and DMG. This path requires an x86_64 build of Homebrew and several specific formulas, since Wine itself is an x86_64 program. A command line tool called osxeql is also included as a headless equivalent to the graphical app, useful during development. osxEQL's own code is released under the MIT license. The bundled Wine and DXMT components carry their own LGPL licenses, with details on obtaining and rebuilding their source kept in a separate notices file.

Yoink these prompts

Prompt 1
Walk me through installing osxEQL and clearing the macOS quarantine flag.
Prompt 2
Explain how Wine and DXMT work together to run a Direct3D 11 game on Apple Silicon.
Prompt 3
Show me the steps to build osxEQL from source, including the x86_64 Homebrew requirement.
Prompt 4
What does the engine/osxeql CLI's backend and doctor commands do?

Frequently asked questions

wtf is osxeql?

A Mac app that lets Apple Silicon users play EverQuest Legends using only open-source Wine and DXMT, without CrossOver or Apple's proprietary D3DMetal.

What language is osxeql written in?

Mainly Shell. The stack also includes Shell, Wine, DXMT.

What license does osxeql use?

osxEQL's own code can be used, modified, and redistributed freely, including commercially, as long as you keep the copyright notice, the bundled Wine and DXMT components carry their own LGPL terms.

How hard is osxeql to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is osxeql for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.