It also acts as a reference project for developing modules outside the main Owlbot repository. Each module is a top-level Python package directory, dependencies are declared in pyproject.toml, the environment is managed with uv, and CI runs the same style, type, test, and spelling checks used by Owlbot.

Modules

chat_archive: archives Owncast chat activity and stream context updates to JSON files.

Each module package is kept at the repository root so it can be copied or symlinked independently into the directory Owlbot scans for user modules.

Loading Modules

Place the module folders you want to use inside your Owlbot user modules directory:

modules/
  chat_archive/
    __init__.py
    README.md

If you do not already have a user modules directory, create one and configure Owlbot to scan it with owlbot.modules_dir:

owlbot:
  modules_dir: "/path/to/modules"

Module-specific configuration belongs under modules.<module_name> in config.yaml. See the README inside each module package for its config and runtime behavior.