Skip to content

Release v1.0.0

Choose a tag to compare

View all tags
@underhax underhax released this 19 Mar 00:07
v1.0.0
d696d74

Initial Stable Release

This is the first production-ready version of the Matrix Bot for OpenWrt. It provides a secure, lightweight, and dependency-free way to manage your router remotely via the Matrix protocol.

Key Features

  • Native OpenWrt Support: Written in pure POSIX shell, optimized for BusyBox ash. No heavy runtimes (Python/Node.js) required.
  • Hybrid Transport System:
    • Secure E2EE: Primary communication via matrix-commander-rs over SSH.
    • Transparent Fallback: Direct HTTP support for non-encrypted rooms via curl or wget.
  • Comprehensive Remote Management:
    • Control system services (init.d), firewall, and network interfaces.
    • Manage Wi-Fi radios (On/Off/Toggle) and view real-time signal status.
    • Wake-on-LAN (WOL) support for waking PCs in your local network.
  • Advanced Client Reporting: Dynamic listing of connected wireless and wired LAN clients with MAC/IP/Hostname resolution.
  • Procd Integration: Managed as a native OpenWrt service with auto-respawn and standard logging via logread.

Security & Reliability

  • CI/CD Verified: Every line of code is automatically analyzed by GitHub Actions using ShellCheck to ensure strict POSIX compliance and prevent common shell pitfalls.
  • Input Sanitization: All command arguments are strictly filtered to prevent shell injection vulnerabilities.
  • Credential Protection: Matrix access tokens are handled securely using temporary private files and curl -K to prevent exposure in the process list.
  • Access Control: Built-in administrator-only restrictions with security alerts for unauthorized interaction attempts.

Compatibility & Requirements

  • Tested Hardware: Xiaomi Mi Router 3G (mir3g).
  • Tested OS: OpenWrt 25.12.0 (BusyBox ash).
  • Dependencies: curl, jq (or jsonfilter), openssh-client.

Installation instructions are available in the README.md.

Assets 2
Loading