A small, native macOS menu-bar companion for ZLT cellular routers. Read your modem's SMS inbox and see its live cellular connection without opening the router panel.
Download the latest DMG · Report a problem
- Live 4G / 5G / NSA mode with five signal bars that reflect the modem's actual reported level.
- Separate 4G and 5G RSRP, RSRQ, SINR, and band readings.
- Searchable SMS inbox, readable message details, and verification-code copying.
- Persian / right-to-left text and legacy modem emoji encoding.
- Configurable 10 / 30 / 60-second refresh (30-second default), browser handoff, and manual resume after a session expires.
- On-demand cellular mode and primary 2.4 / 5 GHz Wi-Fi settings, with explicit Apply confirmation. Available modes come from firmware capabilities and operator restrictions.
- Native macOS Password AutoFill for modem login fields; optional Mac notifications, Keychain storage, and launch at login.
- Native Liquid Glass controls on macOS 26+, system appearance, and reduced-motion / reduced-transparency support.
| Device | Status |
|---|---|
| ZLT X28 PRO (du-branded) | Verified on real hardware: login, SMS, and signal measurements |
| Other ZLT routers using the same stock JSON API | Experimental; not verified |
| Huawei, ZTE, Xiaomi, and other router families | Not supported |
This is a firmware-specific client, not a universal modem app. Support on one ZLT model does not guarantee support on another firmware. To report compatibility, provide the model, firmware version, macOS version, and what works. Do not post modem passwords, session tokens, SIM identifiers, or private messages.
Mac requirements: macOS 14 or later. The universal DMG contains Apple Silicon and Intel code. Live hardware testing has been performed on Apple Silicon; the Intel slice is cross-built. Liquid Glass requires macOS 26 or later; older versions use standard native controls.
- Download the universal
.dmgfrom Releases. - Open it and drag ModemBar to Applications.
- Eject the disk image, then launch ModemBar from Applications.
- Connect your Mac to the modem's network and enter its private LAN IPv4 address and panel credentials. The default address is
192.168.70.1; the tested X28 PRO uses the usernameuser. Use your own modem's actual login. - Look for the signal icon in your menu bar. Closing the utility window leaves it running there.
Click the modem password field and choose Passwords… from the native AutoFill menu. Select the saved entry for your modem and authenticate when macOS asks. Automatic domain matching may be unavailable for a private modem address, so select the entry manually when needed. The app does not access the Passwords database or handle biometric authentication. Remember in Keychain is a separate optional app-local credential store.
This preview is ad-hoc signed, not Developer ID signed or Apple-notarized. macOS may block the first launch. If you decide to trust this build, follow Apple's instructions for opening an app from an unidentified developer. The app and DMG do not disable Gatekeeper or change security settings. You can also build it yourself from source.
SHA256SUMS.txt is attached to each release so you can check download integrity. A checksum is not a substitute for Apple notarization.
ModemBar talks directly to the stock modem web interface over your local network and refreshes every 30 seconds by default (10 / 30 / 60 seconds in Settings). No cloud relay, SSH access, custom firmware, or router-side installation is required. The Mac must be awake and connected to the modem's network.
SMS remains read-only: the app does not send/delete messages or mark them read on the modem. Read status is local to your Mac. Login preserves the modem's current auto-upgrade preference.
Cellular and Wi-Fi settings load only when requested. Apply uses the stock panel commands and preserves Wi-Fi security and linked-band state. Firmware-managed bands stay read-only. Wi-Fi names must be 1–32 UTF-8 bytes; passwords use 8–63 printable characters without spaces. Open networks cannot be edited from the app. Advanced channel, security-type, guest-network, and routing controls remain in the browser panel.
Some firmware permits only one management session. Use Open browser panel & pause ModemBar to log the app out before signing in through a browser, then Resume ModemBar when finished. ModemBar reuses its session during polling and does not automatically reclaim a revoked/expired session. The modem may still require an expired session to time out if logout fails. A settings change can temporarily disconnect devices; after a dropped response, reload settings before retrying because the change may already have applied.
Open USSD using the # button in ModemBar. Choose a Hamrah Aval preset or enter a code, then click Send. If the carrier opens a menu, enter its option number and click Reply. Use End session to dismiss an open menu. Presets do not send by themselves, and replies are kept in memory only.
On the tested du ZLT X28 Pro setup, the modem's USSD panel can report “unsupported” in 4G-only mode. The user confirmed USSD worked after setting the modem to 4G / 3G. ModemBar uses the same firmware endpoint. Enable Recover 4G after USSD to temporarily select 4G only after a session ends, wait for 4G, then restore 4G / 3G. This can briefly interrupt connectivity. Hamrah Aval presets may vary by plan; use the live carrier menu for current options.
- Credentials are stored in macOS Keychain only if you enable that option. Session IDs stay in memory.
- SMS bodies stay in app memory; local read/notification history stores message hashes.
- Notification previews are off by default. Enabling them exposes message text through the macOS notification system.
- There is no analytics service. Redirects are rejected and connections are limited to private LAN IPv4 addresses.
- The stock modem interface may use HTTP. ModemBar uses that existing interface and does not add encryption to it; use a trusted local network.
Requires Xcode 26+ or an equivalent Swift 6.2+ toolchain with the macOS 26+ SDK. There are no third-party package dependencies.
./scripts/test.sh
./scripts/build-app.sh # Current Mac architecture
./scripts/build-dmg.sh # Universal Apple Silicon + Intel DMGOutput is written to dist/. The disk image includes the app, an Applications shortcut, and installation notes. GitHub Actions builds and tests the same source on macOS.
29 tests cover challenge-based login, login lockouts, session expiration, read-only pagination, SMS Unicode/whitespace preservation, malformed UTF-8, CESU-8 emoji, Base64 variants, message identity, code extraction, radio responses, CGI preambles, LAN-address validation, session reuse/logout, firmware mode restrictions, token-protected settings writes, Wi-Fi security preservation, linked-band behavior, and multi-turn USSD requests. The inbox, search, message details, and separate 4G/5G metrics have also been verified against a real X28 PRO. New settings writes have automated protocol coverage and were matched to the stock X28 PRO panel scripts; live configuration changes have not been performed. The live Hamrah Aval USSD menu was verified on the du-branded unit; automatic 4G recovery has not been verified on hardware. Automated tests use synthetic data, not private SMS fixtures.
MIT. This project is independent of modem manufacturers and Apple.