macOS Documentation
Loqin for macOS Setup Guide
Complete walkthrough for running Loqin on macOS. Keep your MacBook connected to VIT hostel Wi-Fi automatically from the menu bar without repetitive captive portal logins.
1. Installation Walkthrough
Follow these steps to set up Loqin on your Mac:
Download the macOS Disk Image
Get Install_Loqin_macOS.dmg from our Download Hub or GitHub Releases.
Drag to Applications
Double-click the downloaded .dmg file to mount it, then drag the Loqin application icon into your Applications folder.
First Launch & Gatekeeper Verification
Because Loqin is an open-source student project without an Apple Developer ID signature, macOS Gatekeeper may display a prompt. Right-click (or Control-click) Loqin in Applications and select Open, then confirm by clicking Open in the dialog.
Configure Your Login Details
When prompted on first launch, input your VIT registration number and Wi-Fi password. Loqin immediately saves them into your native macOS Keychain.
Access via the Menu Bar
Loqin lives in your top menu bar as a discreet status icon, actively monitoring connectivity and authenticating behind the scenes.
2. Apple Keychain Storage & Security
On macOS, credentials are protected by the operating system’s cryptographic storage:
- Apple Keychain Services: Passwords are encrypted using your Mac login password via the system Keychain.
- Zero Plaintext Storage: No plaintext password files or unencrypted caches exist on your drive.
- Local Scope: Network requests containing login tokens are transmitted solely to the local hostel captive portal IP address.
3. macOS Menu Bar Controls
Clicking the Loqin icon in your top menu bar gives you access to quick operations:
- Connection Status: Displays whether your captive portal session is active, authenticating, or offline.
- Connect Now: Triggers an on-demand re-authentication attempt.
- Pause / Resume: Suspends automated background pings when connected to personal mobile hotspot or off-campus networks.
- Update Credentials: Re-enter your registration credentials whenever you update your VIT Wi-Fi password.
- Quit: Closes the app and unloads background tasks.
4. Uninstallation & Removal
To remove Loqin from your Mac:
- Quit Loqin from the top menu bar.
- Open Finder and navigate to your Applications folder.
- Drag Loqin to the Trash and empty the Trash.
- (Optional) If you want to remove the stored password token, open Keychain Access, search for
Loqin, and delete the entry.