English | Bahasa Indonesia
A lightweight, zero-dependency WSGI management dashboard and turnkey SoftAP hotspot controller designed for MediaTek MT7663 and MT7668 SDIO Wi-Fi modules on the FiberHome HG680-FJ (Amlogic S905X2 / Meson G12A) running Armbian Linux.
This package transforms your TV box into a standalone Dual-Band Wireless Router & DBDC Repeater with auto-switching upstream WAN support via Ethernet (eth0) or Wi-Fi Client (wlan0), requiring no external USB Wi-Fi dongles.
- Target Hardware: FiberHome HG680-FJ (Amlogic S905X2 / Meson G12A)
- Supported Wi-Fi Modules & Companion Driver Repositories:
- MediaTek MT7663 / MT7661 SDIO (
037A:7663):elsangithub/mt7663-driver - MediaTek MT7668 SDIO (
037A:7668/0x7608/0x6602):elsangithub/mt7668-driver
- MediaTek MT7663 / MT7661 SDIO (
- Operating System: Armbian Linux (
6.18.56-ophub/6.18.59-ophub) - Userspace / Packages: Debian stable (Bookworm 12 / Trixie 13)
- Multi-Source WAN (Ethernet & Wireless Repeater):
- Ethernet Access Point Mode (
eth0WAN): Plugs directly into your main ISP modem/router via LAN cable and broadcasts ultra-fast 5 GHz (VHT80 866 Mbps) or 2.4 GHz wireless. - DBDC Wireless Repeater Mode (
wlan0WAN): Receives home Wi-Fi wirelessly onwlan0while simultaneously re-broadcasting an isolated hotspot onap0.
- Ethernet Access Point Mode (
- Zero-Dependency WSGI Dashboard:
- Written in pure Python 3 using an embedded micro-framework (
bottle.py). No Node.js, npm, or heavy web server runtimes required. - Consumes under 25 MB RAM, ideal for minimal TV box environments.
- Written in pure Python 3 using an embedded micro-framework (
- Full Bilingual Support (English & Bahasa Indonesia):
- Instant, one-click language toggle (ID / EN) in the navigation bar.
- Every dropdown menu, status badge, channel list, and security parameter is fully localized.
- Isolated Hotspot Stack:
- Dedicated
hostapdanddnsmasqinstances specifically bound toap0(10.10.10.1/24). - System-wide daemons are safely masked to prevent port 53/67 binding conflicts with upstream DNS resolvers.
- Dedicated
- Live Hardware & Traffic Telemetry:
- Real-time SoC temperature monitoring from Amlogic thermal zones (
/sys/class/thermal/thermal_zone0/temp). - Live client device table displaying MAC, assigned IP, hostname, custom device alias, and real-time per-client upload/download bandwidth.
- Real-time SoC temperature monitoring from Amlogic thermal zones (
- Automated NAT & Routing Dispatcher:
- Automatic
iptablesNAT masquerade triggered via NetworkManager dispatcher wheneverwlan0oreth0goes UP. - Sysctl kernel optimizations for IPv4 forwarding and ARP isolation (
arp_ignore=1,arp_announce=2).
- Automatic
[ WAN Source 1: Wired LAN ] [ WAN Source 2: Home Wi-Fi ]
Main Modem / Router (eth0) Home Wi-Fi 2.4 / 5G (wlan0)
β β
βββββββββββββββββββ¬ββββββββββββββββββββ
βΌ
+βββββββββββββββββββββββββββββββββββββ+
| FiberHome HG680-FJ (Amlogic S905X2)|
| |
| Auto-Detect WAN Interface |
| (NetworkManager Dispatcher) |
| β |
| iptables NAT / Masquerade |
| IPv4 IP Forwarding = 1 |
| Isolated dnsmasq (DHCP/DNS) |
| β |
| Dual-Band Hotspot Engine (ap0) |
| 2.4 GHz (HT40) / 5 GHz (VHT80 866M)|
| β |
| WSGI Management Web UI (:8080) |
+ββββββββββββββββββ¬βββββββββββββββββββ+
β
βΌ SoftAP Broadcast
[ Phones / Laptops / Smart TVs ]
The MediaTek MT7663 and MT7668 chipsets support 802.11ac Wave 2 VHT80 (80 MHz bandwidth). Understanding their capabilities and environmental trade-offs helps you achieve the best performance:
- 866 Mbps Physical Link Rate: When operating at 80 MHz with 2x2 MU-MIMO on 5 GHz, compatible client devices achieve theoretical link speeds of up to 866.7 Mbps.
- Real-World High Throughput: Achieves 350β500 Mbps actual throughput in iperf3/speed tests. Ideal for 4K video streaming, high-speed local NAS transfers, and low-latency gaming.
- Peak Performance with
eth0WAN: Usingeth0as the wired WAN input allows the MediaTek radio (MT7663 / MT7668) to dedicate 100% of its RF airtime to client devices onap0at full 80 MHz speeds.
- Reduced Wall Penetration: High-frequency 5 GHz signals naturally experience higher attenuation through solid walls and concrete compared to 2.4 GHz.
- RF Spectrum Congestion: An 80 MHz channel bonds 4 contiguous 20 MHz channels (e.g. 36 + 40 + 44 + 48). In densely populated apartment complexes with many nearby 5 GHz routers, channel collisions may trigger packet retries.
- Repeater Mode Caveat (5 GHz STA + 5 GHz AP): If you use
wlan0to receive a 5 GHz network and simultaneously runap0at 5 GHz 80 MHz, the single physical radio must rapidly time-slice between listening and transmitting. Under extreme workloads, this may lead to buffer overflow.- Solution: For wireless repeater mode, configure
wlan0on 5 GHz andap0on 2.4 GHz (HT40), or vice versa (True DBDC).
- Solution: For wireless repeater mode, configure
Before installing this package, ensure you have installed the matching DKMS driver:
- Kernel Driver:
- For MT7663:
mt7663-dkms(>= 1.0.11) - For MT7668:
mt7668-dkms(>= 2.0.1)
- For MT7663:
- Operating System: Armbian Linux (
6.18.59-ophub/ Debian 12/13 base).
Download the latest .deb release package and install it using apt so that all required runtime dependencies (hostapd, dnsmasq, python3, iptables, wireless-tools) are automatically resolved:
# Download latest release package (v1.0.6)
wget https://github.com/elsangithub/mt7663-router-webui/releases/download/v1.0.6/mt7663-router-webui_1.0.6_all.deb
# Install and automatically resolve dependencies
sudo apt update
sudo apt install ./mt7663-router-webui_1.0.6_all.debOn the first installation, reboot your STB to allow the Amlogic SDIO bus controller to perform a clean hardware reset with ap_mode=1:
sudo rebootAfter reboot, verify both interfaces are present:
ip link show wlan0
ip link show ap0- Connect your phone or laptop to the default Wi-Fi hotspot:
- SSID:
HG680_5G_VHT80(or custom configured SSID) - Password:
password123
- SSID:
- Open your web browser and navigate to:
- URL:
http://10.10.10.1:8080 - (Alternatively, access via your STB's Ethernet IP at
http://<STB-LAN-IP>:8080)
- URL:
- Log in with the default administrator credentials:
- Username:
admin - Password:
admin
- Username:
Tip
You can change the admin username and password anytime in the Admin tab.
The package manages its configurations through standard Linux configuration paths:
| File Path | Description |
|---|---|
/etc/default/mt7663-hotspot |
Hotspot environment settings (SSID, channel, band, gateway IP, DHCP range, DNS servers). |
/etc/hostapd/hostapd-mt7663.conf |
Hostapd runtime template generated automatically by the hotspot service. |
/etc/modprobe.d/wlan_mt7663_sdio.conf |
Driver module options setting ap_mode=1 for dual virtual interface initialization. |
/etc/sysctl.d/99-mt7663.conf |
Kernel IP forwarding and ARP isolation parameters. |
/etc/NetworkManager/dispatcher.d/90-wlan0-routing.sh |
Dispatcher hook that automatically updates iptables NAT whenever WAN connects. |
/etc/mt7663-device-names.json |
Stores custom friendly names assigned to client devices in the Web UI. |
To cleanly remove the Web UI and restore the system to a pure wlan0 Wi-Fi client state:
# 1. Purge the package and configurations
sudo apt purge -y mt7663-router-webui
# 2. Clean up auto-installed dependencies
sudo apt autoremove -y --purge
# 3. Reboot to restore clean single-interface mode
sudo rebootThis project is licensed under the GNU General Public License v2.0.



