A command line utility for controlling a LG webOS TV over the network.

Alga is available on PyPI. I would recommend installing it via pipx:

$ pipx install alga

Or, via Nix flakes:

nix run github:Tenzer/alga

The first time you use the utility, you will need to setup a connection to the TV. With the TV on, run alga tv add <identifier> [hostname/IP]. This will bring up a prompt on the TV asking if you want to accept the pairing. When accepted, Alga will be ready to use.

If no hostname or IP address is provided to alga tv add, it will be default try to connect to "lgwebostv" which should work.

The hostname, a key and MAC address will be written to ~/.config/alga/config.json for future use.

See usage for a list of available commands.

The code base is fully type annotated and test coverage is being enforced. Types can be checked via uv run mypy . and tests via uv run pytest.

Tests are run for each of the supported Python versions in CI.

pre-commit used to run Ruff for linting and formatting.

usage.md is updated via uv run ./generate-usage.sh.