timberborn-http 0.0.4

Timberborn http api wrapper

Timberborn HTTP API Wrapper

A Python library for interacting with the Timberborn HTTP automation API. Supports both direct API control and webhook-based event handling.

Features

• Get the state of levers & adapters from timberborn
• Update the state of levers
• Receive webhooks and trigger actions

Installation

pip install timberborn-http

Quickstart

1. Direct API Control

from timberborn_http import TimberbornAPI

api = TimberbornAPI("http://localhost:8080")

# Get all levers
levers = api.get_levers()
for lever in levers:
    print(lever.name, lever.state)

# Control a lever
api.switch_on("HTTP Lever 1")
api.set_color("HTTP Lever 1", "ff0000")

2. Webhook Events

from timberborn_http import TimberbornWebhookServer

server = TimberbornWebhookServer(port=8081)

@server.on_event("HTTP Lever 1")
def handle_on(name):
    print(f"{name} turned ON!")

while True:
    pass

More examples & details in the examples folder

Getting Help

• GitHub Issues
• Discord in #⏱️automation or #🤖mod-creators