A native macOS application that embeds Epsilon (NumWorks’ open-source calculator firmware) as a real .app, with menu bar integration, keyboard shortcuts and automatic updates (using Sparkle).
This is an independent project and is not affiliated with, endorsed by, or sponsored by NumWorks.
The purpose of this project is to provide a native macOS shell around Epsilon, with desktop integration and update management.
Looking for the previous generation of this app (embedded HTML NumWorks simulator)? See release 1.3.1 — the last version based on the web simulator. Current releases (2.x) use a compiled Epsilon build from github.com/numworks/epsilon instead.
No official Numworks app really exists so I made my own.
- Runs as a real macOS app (Dock, menu bar, global shortcuts, Settings)
- Embeds a compiled Epsilon simulator (same engine as the physical calculator)
- App updates via Sparkle and a GitHub bot automatically updates when epsilon repository publishes a new version
- macOS 15.5 or later (I mean... it should work on older version I guess)
-
Open the latest release:
https://github.com/EllandeVED/NumworksApplication/releases/latest -
Download
NumWorks-LATESTVERSION.zip -
Unzip, then drag NumWorks into Applications.
-
Because the app is not notarized with a paid Developer ID, macOS can show a security warning:
-
Open System Settings → Privacy & Security, then choose Open Anyway:
git clone https://github.com/EllandeVED/NumworksApplication.git
cd NumworksApplication
# Prepare & build the linked Epsilon static library, then open in Xcode:
./NumWorks/Scripts/prepare-epsilon.sh latest # or a specific ref, e.g. version-25
./NumWorks/Scripts/build-epsilon-lib.sh
open NumWorks.xcodeprojApp updates (Sparkle)
- The app can check for updates automatically (toggle in Settings → General).
- You can also use Check for Updates… from the menu or Settings.
- Release notes appear in the Sparkle UI.
Updates only install when the app is in the Applications folder.
- Directly retrieved from Epsilon and slightly modified to embed it into an app window
- Show / hide calculator (menu bar or global shortcut)
- Always on top (pin)
- Menubar icon
- ⌘, to open Settings is not always reliable.
This project is licensed under the GNU General Public License v3.0 (GPLv3).
Copyright (c) 2025–2026 EllandeVED
See the LICENSE file in this repository for the full text.
The app embeds Epsilon (also GPLv3) and uses other third-party components (for example Sparkle) under their respective licenses. Combining this shell with Epsilon means redistributed binaries of the app are covered by GPLv3: you may use, study, share, and modify the software, and derivative works must remain under GPLv3 with appropriate attribution and source availability.
This project is not affiliated with, endorsed by, or sponsored by NumWorks.
NumWorks for Mac does not collect, store, or send personal data about your usage.
- The calculator runs locally and only connects to internet for update checks (can be disabled)
Issues, feature requests, and pull requests are welcome.
If you find this project useful, feel free to star the repository and share it with others.