ishtiaqhossain/portal-hub

Portal Hub is a single-file Python web tool for managing a collection of Meta Portal smart display devices from one browser page over your home Wi-Fi network. Meta Portal devices run Android, and this tool communicates with them using ADB, which is a standard Android development utility that lets you send commands to Android devices from a computer. Portal Hub downloads ADB automatically the first time it runs, so you do not need to install anything beyond Python 3.7 or later. Once running, the tool opens a local web page you visit from any browser on the same network, including from a phone or laptop. You can see which devices are online, install APK files to one device or all devices at once, view the list of installed apps with their icons, uninstall or force-stop apps, take screenshots, reboot devices, and simulate button presses like Home and Back. There is also an update checker: you point an app at a GitHub release page or a direct APK download link, and the tool checks whether a newer version is available and offers a one-click update across all devices that are behind. The first time you connect a device, a USB cable is required to switch the Portal from USB mode to wireless ADB mode. After that setup step, the cable is no longer needed and the Portal communicates over Wi-Fi. If a device reboots, the wireless ADB connection drops due to a limitation in the older Android version the Portal runs, and you need to reconnect it with USB once more to restore wireless access. The tool stores your saved devices and update sources in local JSON files and has no accounts, logins, or external services. Because it has no password protection, the README recommends keeping it on a private home network and not exposing it to the internet. Configuration options let you change the port number, bind address, and ADB path if needed. No license is stated in the repository.