Nitrax Math Keyboard — Full Documentation (macOS)
This page is the complete reference for setup, daily use, troubleshooting, compatibility, and trust details on macOS. If you already tried the Quick Start and still have a question, this page is designed to answer it fast.
Important concept: the keyboard works like a normal keyboard immediately. To type the printed math symbols (blue/gray layers) on macOS, you need the Nitrax companion app together with Karabiner-Elements.
Getting Started (macOS)
The macOS version uses a small Nitrax companion app that lives in the menu bar. The first setup is guided, and the app helps you install or verify everything needed.
1) Welcome screen
When you open the app for the first time, you’re welcomed by a short onboarding flow. It explains what the software does and what will happen during setup.
2) Karabiner-Elements
Karabiner-Elements is a well-known macOS keyboard customization utility. Nitrax uses it to detect the keyboard shortcuts reliably at the system level, so the printed math layers can work consistently across apps.
3) Permissions
macOS asks for a few permissions so the software can work correctly. This is normal on Mac for apps that interact with keyboard input and accessibility features.
4) Applications folder
The app should normally already be in the correct place. This step is mainly here as a safety check.
5) Menu bar & Math Mode
Once setup is complete, the app lives in the menu bar at the top of your screen. This is your day-to-day control center.
• Turn Math Mode ON/OFF
• Enable Start at login
• Open the Quick Guide
• Quit the app completely
Typing math
The keyboard uses a consistent two-layer system on macOS as well. You can keep Ctrl + Option held down and type multiple symbols in a row.
Blue / Gray layers
-
B
Blue symbols = Ctrl + Option + key
Example: Ctrl + Option + T → √ -
G
Gray symbols = Ctrl + Option + Shift + key
Example: Ctrl + Option + Shift + J → ∫
• Keep Ctrl + Option pressed and type several symbols in sequence.
• If a symbol doesn’t appear in a specific app, try the same shortcut in Notes first to confirm your setup.
• If a specific app behaves strangely, check the Troubleshooting section below.
Hardware
Power, sleep, charging
Turn the keyboard ON using the physical switch. It enters auto-sleep after about 10 minutes of inactivity. Charge via USB-C. Typical full charge is around ~2 hours, and typical usage is around ~70 hours.
Dongle storage (travel-safe)
The 2.4G USB receiver stores in a recessed slot under the keyboard so it’s harder to lose in a backpack.
LEDs & buttons
The LEDs help confirm which connection mode is active at a glance, especially when switching between 2.4G and Bluetooth.
Connectivity
The keyboard supports one connection at a time: either 2.4G (USB dongle) or Bluetooth. It typically remembers the last mode used and reconnects when powered on.
2.4G (USB dongle)
-
1
Plug the USB receiver into your Mac
Use a direct USB port or adapter if possible. -
2
Power ON the keyboard
Then press the 2.4G mode button to select 2.4G mode. -
3
If it doesn’t connect: re-enter pairing
Press and hold the 2.4G button for about 3 seconds until the 2.4G indicator flashes rapidly.
Bluetooth pairing (macOS)
-
1
Select Bluetooth mode
Press the Bluetooth mode button once. -
2
Enter pairing mode
Press and hold the Bluetooth button for about 3 seconds until the Bluetooth indicator flashes rapidly. -
3
Pair from macOS Bluetooth settings
The device name may appear as IOP582/583/584.
Keyboard OS mode
The keyboard has an OS mode switch. For macOS, the recommended mode is Mac mode.
-
⌘
Fn + W → Mac mode
Recommended on macOS for correct modifier behavior. -
⊞
Fn + Q → Windows mode
Use this only when you want standard Windows key behavior on a PC.
Best practices
These tips help you get the best experience on macOS right now.
1) Prefer normal text editors and writing apps
Notes, Word, Google Docs, Notion, Obsidian, Gmail, WhatsApp, and similar writing environments are currently the most comfortable places to use the keyboard on Mac.
2) Keep spreadsheets as a secondary use case
Spreadsheets are not the ideal environment on macOS for now. Some spreadsheet apps can still work in simple cases, especially for occasional symbol entry, but the experience is less stable than in writing-oriented apps.
Compatibility
Below is a practical compatibility snapshot based on real tests on macOS.
Apps matrix
| App / context | Environment | Notes |
|---|---|---|
| Notes | App | Perfect. |
| Open Writer | App | Perfect. |
| Open Sheet | App | Can work, but overwrite issues were observed. |
| Open Presentation | App | Works very well. |
| Word | App / Safari / Chrome | Very good overall. Browser versions tested very well. |
| PowerPoint | App / Safari / Chrome | Works very well overall. A small paste notification may appear for each character in some cases. |
| Excel | Safari / Chrome | Not recommended for now on macOS. Spreadsheet behavior can be unstable. |
| Google Docs | Safari / Chrome | Excellent. Symbols look particularly good here. |
| Google Sheets | Safari / Chrome | Can work, but overwrite issues were observed. |
| Notion | App | Very good. |
| App / Safari / Chrome | Very good overall. App version tested perfectly. | |
| Overleaf | Safari / Chrome | Very good overall, with one known limitation: the 𝜑 key did not work in tests. |
| Obsidian | App | Very good. |
| Gmail | Safari / Chrome | Very good. |
| OneNote | Safari / Chrome / App | Browser versions tested very well. Desktop app not fully documented yet. |
Keyboard layouts (QWERTY / AZERTY / QWERTZ)
The physical legends are designed around a QWERTY-like layout. On systems using other layouts, the shortcuts can still work, but the physical position may feel different from the printed legend.
Troubleshooting
Most issues on macOS come from one of these: setup not completed, permissions not granted, Math Mode OFF, or app-specific limitations.
| Symptom | Quick checks | Fix |
|---|---|---|
| Nothing happens when I press symbol shortcuts | Is the app running in the menu bar? Is Math Mode ON? Was setup completed? |
Open the Nitrax menu bar app, verify setup, and turn Math Mode ON. |
| The setup does not seem complete | Was Karabiner-Elements installed? Were permissions granted? |
Reopen the onboarding flow and complete the missing step(s). |
| The app is not visible in the menu bar | The app may not be running. | Launch the Nitrax app again from Applications. |
| Shortcuts work in some apps but not others | The target app may behave differently with text insertion. | Test first in Notes or Google Docs. If it works there, the issue is likely app-specific. |
| Spreadsheet behavior feels unstable | Is this happening in Excel, Google Sheets, or another spreadsheet app? | This is a known weaker area on macOS for now. Prefer document or text apps when possible. |
| Bluetooth won’t pair / reconnect | Was it paired before? Is pairing mode active (flashing)? | Remove the device in macOS Bluetooth settings, then pair again from scratch. |
| 2.4G doesn’t connect | Is the receiver plugged in? Is 2.4G mode selected? | Plug the receiver in, select 2.4G mode, and if needed re-enter pairing by holding the 2.4G button. |
| The 𝜑 key does not work in Overleaf | Does the issue happen specifically in Overleaf? | Yes — this is currently treated as a known limitation based on testing. |
Trust & transparency
The macOS version relies on the Nitrax app together with Karabiner-Elements to make the shortcut layers possible on Mac. Karabiner-Elements is a widely known utility in the macOS ecosystem for advanced keyboard behavior.
• Runs locally on your machine
• No telemetry
• Guided setup so you know what is being enabled
The project is intended to remain transparent and open about how it works. A GitHub link is provided above because the codebase is open-source.
FAQ
Does the keyboard work without the macOS app?
Why is Karabiner-Elements needed?
Are the permissions normal?
Where do I control Math Mode on Mac?
What are the math shortcuts on macOS?
Gray layer: Ctrl + Option + Shift + key.
Which apps look best right now on macOS?
Are spreadsheets fully reliable on macOS?
Is there any known limitation?
Glossary
| Term | Meaning |
|---|---|
| Math Mode | When ON, the app enables the keyboard’s printed math layers. When OFF, the keyboard behaves normally. |
| Menu bar app | The small control app that lives at the top of the macOS screen. |
| Karabiner-Elements | A macOS utility used here to make the shortcut layer work reliably. |
| 2.4G | Wireless mode using the included USB receiver. |
| Bluetooth pairing | The process of connecting the keyboard to your Mac through Bluetooth settings. |
| Mac mode (Fn + W) | The recommended keyboard OS mode when using the keyboard on macOS. |
Support & contact
Still stuck — or want to be notified when the macOS version is released? Send us a message and include: your macOS version, the app you’re typing in, and what you expected vs what happened.