Henga
Native macOS Menu Bar App for robust, zero-hassle NAS mounting.
Auto-mount SMB shares without duplicate /Volumes/share-1 ghost mounts, keychain prompts, or cluttered system views.
The Problem Henga Solves
Anyone using a Synology NAS or network storage on macOS knows the daily struggle:
- Ghost Mounts: macOS disconnects unreliably on sleep/wake, leaving dead
/Volumes/share-1, /Volumes/share-2 folders.
- Cluttered "Computer" Overview: macOS floods your
MacBook Air system view with dozens of network drive icons.
- Keychain Prompt Cascades: System dialogs constantly ask for passwords after reboot.
- Finder Lag: Stale SMB sessions beachball Finder when the NAS is unreachable.
Henga fixes this at the kernel level.
Key Features
- 🚀 Zero Ghost Mounts (
-o nobrowse): Mounts network drives with the kernel MNT_NOBROWSE flag. Your macOS "Computer" view remains 100% clean and uncluttered.
- 📁 Central Finder Hub (
~/DiskStation): All active shares are neatly linked into your designated Finder hub folder (just like ShellFish or iCloud Drive).
- 🔐 Synology DSM 7 2FA Support: Native FileStation WebAPI discovery with trusted device token persistence (
did). Enter your 2FA OTP code once; never get prompted again.
- 🔄 Smart Auto-Mount & Reconnect: Automatically monitors reachability (POSIX non-blocking socket checks) and transparently reconnects shares when network returns.
- ⚡ Launch at Login: Zero-hassle autostart using Apple's modern
SMAppService.mainApp API.
- 🌐 Multi-NAS Architecture: Configure multiple Synology DiskStations or universal SMB servers with custom hub names and independent mount controls.
Architecture & Code Quality
Henga is built strictly following native Swift 6 and macOS platform guidelines:
Henga
├── HengaCore # Pure Swift logic, SMB mount engine, 2FA API client, Keychain helper
├── HengaMac # Native SwiftUI macOS Menu Bar Extra & Settings UI
└── HengaCLI # Headless diagnostic tool for automation & server testing
- Local Quality Gate: Strict offline validation of the macOS/Swift 6 architecture before every commit.
- Adversarial Sabotage Tests: Tested against path injection attacks, malformed DSM 7 JWT error responses, and corrupt mount outputs.
Installation
Mac App Store (recommended): Download Henga for free — requires macOS 14 Sonoma or later.
After installing, click the Henga icon in your menu bar and open Settings to add your NAS.
Build from Source
- Clone the repository:
git clone https://github.com/hehljo/Henga.git
cd Henga
- Open the Xcode Workspace:
open Henga.xcworkspace
- Build & Run:
- Select scheme
HengaMac
- Press Cmd + R
Privacy
Henga keeps everything on your Mac: server addresses, user names and settings stay local, passwords live in the macOS keychain. The app talks only to the server you enter yourself; there is no account, no analytics, no advertising and no third-party crash reporting. Full privacy policy (German/English): lupfa.de/datenschutz/henga · lupfa.de/en/privacy/henga. Imprint: lupfa.de/impressum.
Support & Donation
If Henga saves you time and keeps your macOS Finder uncluttered, consider supporting the development:
License
MIT License. See LICENSE for details.
