A modern, user-friendly TUI (Text User Interface) application for setting up Wireless@SGx on Linux systems. No more manual configuration or command-line hassles!

• 🎨 Beautiful TUI - Modern terminal interface using Textual framework
• 🔐 Secure Storage - Credentials stored securely in system keyring
• 🔧 Auto Configuration - Automatically configures NetworkManager
• 🌐 Multi-ISP Support - Works with Singtel and Starhub
• 📱 Easy OTP Entry - User-friendly OTP input with timer
• 🚀 One-Line Install - Simple installation process

pip install wirelesssgx
wirelesssgx

curl -sSL https://raw.githubusercontent.com/siva-sub/wireless-sgx-linux-tui/master/install.sh | bash

git clone https://github.com/siva-sub/wireless-sgx-linux-tui.git
cd wireless-sgx-linux-tui
pip install -e .
wirelesssgx

To update to the latest version:

curl -sSL https://raw.githubusercontent.com/siva-sub/wireless-sgx-linux-tui/master/update.sh | bash

To completely remove Wireless@SGx:

curl -sSL https://raw.githubusercontent.com/siva-sub/wireless-sgx-linux-tui/master/uninstall.sh | bash

1. Launch the application:

   wirelesssgx

   Or if you prefer:

   python -m wirelesssgx

2. Choose your action:

   • New Registration: For first-time users
   • Retrieve Existing: If you already have an account
   • Auto-Connect: If you have saved credentials

3. Enter your details:

   • Phone number (8-digit Singapore mobile, e.g., 9XXXXXXX)
   • Date of birth (DDMMYYYY format)
   • Select your ISP (Singtel/Starhub)

4. Enter OTP:

   • Check your SMS for the OTP
   • Enter it in the application

5. Done! Your credentials are saved and network is configured automatically.

After setting up, you can use these commands to manage your connection:

wirelesssgx show

Shows your saved username, ISP, and auto-connect status.

wirelesssgx connect

Connect to Wireless@SGx using your saved credentials.

wirelesssgx autoconnect

Configure your system to automatically connect to Wireless@SGx when in range.

wirelesssgx status

Check if you're currently connected to Wireless@SGx.

wirelesssgx forget

Delete your saved credentials and network configuration.

This application uses a Text User Interface (TUI) - it runs in your terminal but provides a graphical-like experience with:

• Mouse support
• Buttons and forms
• Colored interface
• Keyboard navigation

Think of it as a GUI that runs in your terminal!

• Singtel - Fully tested and working
• Starhub - Fully tested and working

Note: M1 and SIMBA are also Wireless@SG operators but their API endpoints are not publicly available for this registration method.

• Python 3.8 or higher
• Linux with NetworkManager or systemd-networkd
• Active Singapore mobile number for OTP

1. "Cannot connect to NetworkManager"

   • Ensure NetworkManager is running: sudo systemctl start NetworkManager

2. "Keyring access denied"

   • Install gnome-keyring or similar: sudo apt install gnome-keyring

3. "OTP timeout"

   • The application will offer to resend OTP
   • Check your phone number is correct

If automatic configuration fails, you can manually configure using the displayed credentials:

1. Open your network settings
2. Add new WiFi connection
3. Settings:
   • SSID: Wireless@SGx
   • Security: WPA & WPA2 Enterprise
   • Authentication: PEAP
   • Inner Authentication: MSCHAPv2
   • Username: [displayed username]
   • Password: [displayed password]

git clone https://github.com/siva-sub/wireless-sgx-linux-tui.git
cd wireless-sgx-linux-tui
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e ".[dev]"

pytest

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Based on the original wireless-sg-wifi-for-linux project
• Uses the Textual framework for the TUI
• Thanks to the Singapore tech community for reverse engineering efforts

This is an unofficial tool. Use at your own risk. The authors are not responsible for any misuse or damage.