Vigilatus

Desktop app for monitoring multiple TP-Link Tapo cameras.
Note: this app was basically fully written with the help of AI, while I did fully oversee all code changes, this is my first Electron application.

Legal disclaimer

• This project is an independent, community-driven tool and is not affiliated with, endorsed by, or sponsored by TP-Link.
• Any Tapo API communication in this project relies on publicly observable behavior and/or third-party reverse-engineered integrations, which may change or stop working at any time.
• Tapo, TP-Link, and related names, logos, and product marks are trademarks of their respective owners.
• Use this software only with devices and accounts you own or are authorized to access, and ensure your usage complies with applicable laws and the vendor's terms.
• This repository is provided for educational and interoperability purposes and does not constitute legal advice.

Development

Install dependencies, then run the dev shell:

npm install
npm run dev

Testing

Run the unit tests with:

npm run test:unit

Run the real Electron smoke test, which builds the app and launches it against an isolated temp profile:

npm run test:e2e

For manual automation runs, set VIGILATUS_USER_DATA_DIR to isolate config and logs from your normal profile. The main process writes a vigilatus.log file inside that directory and exposes the active runtime paths through window.vigilatus.diagnostics.getRuntimeInfo().

Releases

Build distributables with electron-builder:

# unpacked app directory (quick packaging smoke test)
npm run package

# Windows portable .exe
npm run release:win

# Linux portable AppImage
npm run release:linux

Artifacts are written to release/.

Notes:

• release:win should be run on Windows.
• release:linux should be run on Linux (or in a Linux CI runner/container).

Mac should work in theory but I'm unable to test that, if you did feel free to let me know!