OctoMacLauncher: a native OctoWoW launcher for Apple Silicon Macs

Custom client modifications and resources.
Miami
Posts: 15
Forum Reputation: +0 / -0

OctoMacLauncher: a native OctoWoW launcher for Apple Silicon Macs

Post#1 » Wed Nov 11, 2026 11:33 am

Hi all! I (ofc, with the help of AI hehe) made a native launcher for playing OctoWoW on Apple Silicon Macs, and I'd like to share it. It installs and updates the client, starts the game through Wine, and keeps your addons, mods and HD patches in one place.

Image

How it works
  • Choose your OctoWoW folder, or an empty one, and press Install. The client comes from Octo's own servers; every file is checked, and an interrupted download picks up where it stopped.
  • Press Play. The first time, it sets up Wine with what the game needs on a Mac (about a minute). After that, the game just starts.
  • Addons from Octo's catalog, DLL mods (nampower, UnitXP SP3, VanillaHelpers), Octo's raid visuals and Project Reforged's HD textures, and tweaks such as view distance and field of view. Some fancy textures are looking weird on Mac, but it is a question to Project Reforged team.
  • Realm status and Octo's announcements on the Play page, which also tells you when the launcher, your addons or patches have updates. The launcher updates itself.
On an M3 Max it runs at about 90 FPS in Stormwind at peak hours. More app screenshots are in repository description.

Requirements: a Mac with Apple Silicon, macOS 15 or later, and Rosetta 2.

Download: the Releases page. Unzip it and move OctoMacLauncher.app to Applications. It isn't notarized by Apple, so the first time, open it, then click Open Anyway in System Settings → Privacy & Security.

Source code: gitlab.com/noinstances/octomac (open source, MIT)

It's a fan-made project, not an official Octo tool. Feedback and bug reports are welcome in this thread or as issues on GitLab.

You can send you thanks via ingame mail to "Smellsfunny" on PVE server :)
+1 / -0

Miami
Posts: 15
Forum Reputation: +0 / -0

Re: OctoMacLauncher: a native OctoWoW launcher for Apple Silicon Macs

Post#2 » Thu Nov 12, 2026 6:43 pm

3 new versions since the original post. Now the launcher is on 0.1.9 version. Thanks for everyone who tried and reported issues!

What's new:
  • Lexara, sharp text at any size: Mods → Optional → Install adds Lexara 1.0.9 by Nobus & Aethus, a renderer that draws the game's text from its letter outlines, so names over heads, damage numbers, chat and zone text stay sharp however large they are. The launcher uses the download only if it matches the release's SHA-256, puts it next to WoW.exe and loads it after the other mods in dlls.txt. It needs the Rosetta 2 runtime (Settings → Runs on): under FEX it can't finish hooking the game, which then crashes at start, so the launcher leaves it out there and says so. While Lexara is on, Tweaks' letter size limit isn't applied, since Lexara draws the text itself.
  • Two crash fixes, in Tweaks → Fixes and on by default:
    • HD character textures: a character texture from an HD pack with more detail levels than the game expects made it write through a stray pointer while dressing characters (ERROR #132 at 0x0047801D).
    • Missing textures: the game crashed a moment after an addon showed a texture whose file doesn't exist (ERROR #132 at 0x00448955).
    Both rest on what the lexara112 project found in the client; the launcher's fixes are its own.
  • Crash reports you can read and copy: when the game crashes, the Play page shows what WoW's crash report says (the error, the exception and what the failing instruction did) instead of, at times, the unreadable dump written beside it.
  • A copy button at the message's top right puts it on the clipboard for a bug report.
  • OctoWoW's client update of November 12: checked, and every tweak still applies.
  • Frame-rate limit: Display → Performance can hold the game to 30, 40, 60, 90 or 120 frames a second, for less heat, fan noise and battery use, all the time or only when the game starts while your Mac runs on its battery. It works with both renderers, DXVK and MTLd3D.
  • The Metal HUD where you want it: its position is a choice now, and it starts at the top center instead of macOS's top right, where it covered the minimap.
  • Accurate colors: Display → Colors offers Accurate, like retail, which converts the game's colors for your display as retail WoW does. Vivid, the default, sends them as they are, which a wide-gamut display shows more saturated (blue names lighter). This is for MTLd3D.
  • Sharper names and damage numbers (experimental): the game draws letters at most 32 pixels tall and stretches anything bigger, which is why names over heads and damage numbers look soft on large screens. Tweaks → View can raise that limit to 48 or 64 pixels. Off by default.
  • Collect Logs: Help → Collect Logs… (or Settings → Logs for a bug report) saves one zip with what a bug report needs: the logs of your last five game starts, the game's and macOS's crash reports and the client's settings files. Your home folder, user, Mac, game account and character names and e-mail addresses are taken out first, and a file that still holds one is left out. Help → Report a Problem… opens a new issue here, ready to fill in.
  • More crashes recognized: a crash in Wine's own code, in the renderer for example, left no trace the launcher read, so after the first seconds it passed for a normal quit. The launcher now reads macOS's crash report and says what crashed and where.
  • Downloads that don't depend on GitHub alone: the Wine runtime and three small support files come from WoWSilicon's releases on GitHub. When GitHub can't deliver them, the launcher now uses identical copies kept in this project's package registry, checked against the same SHA-256. If nothing gets through, the error links the file so you can download it yourself, and Show opens the folder to put it in. The FEX runtime has no copy yet.
  • OctoLogin: the Mods page names the OctoLogin mod when you've installed it.
  • Uninstall: the README now says what the launcher keeps outside the app and how to remove it.
  • No false alarm when you quit early: closing the game at the login screen no longer shows "The game closed right after starting" with a page of log lines. The launcher now recognises a real crash by its signs (Wine's report of an unhandled exception, or the game's own crash report in the client's Errors folder) at any point in a session, and says "The game crashed" with the details. Without such signs, only a game that's gone within a few seconds counts as a failed start.
  • Clearer error messages: the log lines shown with an error leave out the Metal HUD's routine warnings.
  • Your DLL mods under FEX: with Settings → Runs on → FEX (macOS 26.5 or later), the game now starts through VanillaFixes with your mods (nampower, UnitXP SP3 and the rest), just as with Rosetta 2. FEX runs the game without Rosetta 2 and draws straight to the screen: in a crowded Stormwind on an M3 Max it ran at about 110–130 FPS, where Rosetta 2 ran at about 90. It's still marked experimental, so tell us how it plays for you.
  • Ready for the end of Rosetta 2: Apple keeps only part of Rosetta 2 after macOS 27. If it isn't on your Mac, Play now switches to FEX by itself (macOS 26.5 or later).
  • nampower loads again after WoWSilicon: libSiliconPatch, a speed patch WoWSilicon leaves in the client folder, kept nampower from loading at all. It's now left out while nampower is on, and the Mods page says why.
+1 / -0

Miami
Posts: 15
Forum Reputation: +0 / -0

Re: OctoMacLauncher: a native OctoWoW launcher for Apple Silicon Macs

Post#3 » Fri Nov 13, 2026 10:38 am

Version 0.1.10:
Download here: https://gitlab.com/noinstances/octomac/ ... es/v0.1.10

Image

What's new
Favorite addons: Addons has a new Favorites tab for the addons you like, installed or not.
  • The heart next to an addon in Installed or Browse, or in its details, adds it or takes it out.
  • Add to Favorites from URL… keeps any addon's git repository there without installing it, also one that isn't in Octo's list.
  • Each favorite shows whether it's installed, and you can install or update it right there.
  • Favorites are kept with the launcher's settings on your Mac.
+1 / -0

Miami
Posts: 15
Forum Reputation: +0 / -0

Re: OctoMacLauncher: a native OctoWoW launcher for Apple Silicon Macs

Post#4 » Fri Nov 13, 2026 7:10 pm

Version 0.1.11
Download: https://gitlab.com/noinstances/octomac/ ... es/v0.1.11 or selfupdate in updater.

What's new
  • Clients on an external drive: installing or updating a client on an external drive, such as a USB SSD, stopped with "Not enough disk space" and 0 available, however much room the drive had. The launcher now reads the drive's real free space. And when space really is short, the amount that message says is needed includes the 256 MB the launcher keeps to spare.
+1 / -0

Miami
Posts: 15
Forum Reputation: +0 / -0

Re: OctoMacLauncher: a native OctoWoW launcher for Apple Silicon Macs

Post#5 » Sat Nov 14, 2026 12:19 pm

Version 0.1.12:
Download: https://gitlab.com/noinstances/octomac/ ... es/v0.1.12 or self-update via updater

What's new
  • wow_turbo, a faster game: Mods → Optional has a new one-click mod by athei (athei/wow-mods). It rewrites about 330 of the game's busiest functions without the old floating-point math that Rosetta 2 translates slowly. In Stormwind on an M3 Max:
    - Rosetta 2: 50 → 105 FPS
    - FEX: 90 → 120 FPS
    It also stops names jittering in crowds and speeds up addons and loading screens. It answers addons' UnitXP calls itself, so UnitXP SP3 is off while wow_turbo is on, and comes back on when you switch wow_turbo off.
  • Lexara under FEX: Lexara's authors fixed the crash at start under FEX that we reported, and the launcher now installs their 1.1.0. If you have an earlier Lexara, Mods offers Update to 1.1.0. Under FEX only 1.1.0 loads.
  • Patch notes on the Play page: next to the latest build, Patch notes opens Octo's notes for that build, or the Patch Notes board until they're posted.
+1 / -0

Miami
Posts: 15
Forum Reputation: +0 / -0

Re: OctoMacLauncher: a native OctoWoW launcher for Apple Silicon Macs

Post#6 » Sun Nov 15, 2026 2:01 pm

Version 0.1.13:
Download: https://gitlab.com/noinstances/octomac/ ... es/v0.1.13 or self-update via updater

What's new
  • Quit the launcher and keep playing: after you quit the launcher during a game, macOS kept listing it as "Running in Background", and that entry's Stop froze the game. Now quitting while you play asks first:
    - Quit Launcher Only: the launcher closes and leaves the Dock, uses less memory, and quits by itself when you leave the game. Open it again any time to bring it back.
    - Quit Game and Launcher: ends both.
    - Closing the launcher's window while you play no longer quits it.
  • Lexara under FEX: no more thin lines beside letters: with Lexara on, a thin vertical line could show after letters such as "s" in chat. Until Lexara's own release has the fix, the launcher writes a small one into Lexara 1.1.0: Lexara now clears each new page of letters. A Lexara you already have gets it the next time you press Play.
+1 / -0

Miami
Posts: 15
Forum Reputation: +0 / -0

Re: OctoMacLauncher: a native OctoWoW launcher for Apple Silicon Macs

Post#7 » Mon Nov 16, 2026 12:29 am

Version 0.1.14 is available!
Download: https://gitlab.com/noinstances/octomac/ ... es/v0.1.14 or self-update via updater

What's new
  • Faster client downloads: installing or updating the game now downloads four files at a time, the largest first. Octo's server gives each connection 3 to 5 MB a second; four of them brought 8 to 13 MB a second in our tests, about three times as fast as before. The Play page names the file that has been in work longest, says how many more are in work with it, and counts the files done. If the server says it's busy, the launcher goes on one file at a time by itself.
  • Safer addon updates: an addon's folder can come from anywhere (a zip someone shared, say), and git obeys the settings and hooks it finds in a folder's `.git`. The launcher no longer runs git inside addon folders. It reads the folder's own record, asks the addon's repository whether there is a newer version, and updates with a fresh copy that takes the old one's place.
    • -- Files you added to an addon's folder go along into the new copy.
    • -- Files of the addon you edited are copied to the Trash first, in " (your edits)", as before.
    • -- If the launcher can't tell what you changed, or the old copy is a full clone that may hold commits of your own, the whole old copy goes to the Trash, and the launcher says so.
    • -- Addons are downloaded over https only, as everything in Octo's catalog is. A copy you cloned by hand from another kind of address (SSH, say) stays listed, and stays yours to update.
  • "Clear your WDB folder": Octo's staff ask players to clear the game's WDB folder before they report a bug. The launcher has cleared it at every Play since its first version; now it says so. Each launch log has a line for it (WDB folder: cleared before this start), and so does the zip from Help → Collect Logs. If the folder can't be cleared, the Play page tells you.
+1 / -0

Miami
Posts: 15
Forum Reputation: +0 / -0

Re: OctoMacLauncher: a native OctoWoW launcher for Apple Silicon Macs

Post#8 » Mon Nov 16, 2026 12:43 pm

Version 0.1.15 is available!
Download: https://gitlab.com/noinstances/octomac/ ... es/v0.1.15 or self-update via updater

What's new
  • ClassicAPI: Mods → Optional has a new one-click mod, ClassicAPI by brues-code (brues-code/ClassicAPI), which Octo's own launcher offers too. It brings much of the modern WoW API (over 950 functions, 80 events and much of Lua 5.1) to the 1.12 client, so addons written for later versions of the game run with little or no change. If you put it in by hand, the launcher now knows it and shows its version.
  • Mod updates on the Play page: ClassicAPI, Lexara and wow_turbo now come from their authors' newest releases on GitHub. The launcher looks for new ones as soon as it opens and every six hours, and the Play page offers them beside your addon updates: Update, or Update All when there are several. Mods shows which version you have and links each new release's notes.
    • -- A download is used only if it matches the size and SHA-256 that GitHub published for it, and only if it's a 32-bit Windows DLL. ClassicAPI's must also name the release it comes from.
    • -- New releases come straight from their authors, and no one checks them before they're offered. If one causes trouble, Go back on the Mods page puts back the copy the update replaced, and the Play page stops offering that release.
    • -- Lexara 1.1.0 keeps the launcher's fix for the thin lines beside letters under FEX; a later Lexara is used as its authors release it. Under FEX, Lexara loads from 1.1.0 on.
  • Collect Logs lists each mod's version.
+1 / -0

Who is online

Users browsing this forum: No registered users and 1 guest