An asynchronous Python client for communicating with HDFury devices via their HTTP API. This lightweight library provides methods for fetching device information, configuration, and issuing control commands such as reboot, hotplug, and mode changes.

• Asynchronous communication using aiohttp
• Fetch device information and configuration
• Issue control commands (reboot, hotplug, relay, mute, etc.)
• Built-in error handling for connection and parsing failures
• Designed for easy integration into automation tools or async workflows

• Python 3.11+
• aiohttp library

import asyncio
from hdfury import HDFuryAPI, HDFuryError

async def main():
    client = HDFuryAPI("192.168.1.100")  # Replace with your device IP

    try:
        info = await client.get_info()
        print("Device Info:", info)

        board = await client.get_board()
        print("Board Info:", board)

        config = await client.get_config()
        print("Configuration:", config)

        # Example command: reboot the device
        await client.issue_reboot()
        print("Reboot command sent!")

    except HDFuryError as err:
        print(f"Error communicating with HDFury device: {err}")

    finally:
        await client.close()

asyncio.run(main())

HDFuryAPI(host: str, session: aiohttp.ClientSession | None = None)

• host – IP address or hostname of the HDFury device.
• session (optional) – existing aiohttp.ClientSession to reuse.

await client.close()

Closes any open HTTP sessions.

All exceptions inherit from HDFuryError.

Defined in const.py, this dictionary maps known operation mode identifiers to their human-readable descriptions.

from hdfury import OPERATION_MODES

for mode, description in OPERATION_MODES.items():
    print(f"{mode}: {description}")

These can be used to display or interpret the current operating mode returned by the device.

Maps available TX0 input port IDs to human-readable labels.

from hdfury import TX0_INPUT_PORTS

print(TX0_INPUT_PORTS["1"])  # Output: Input 1

Maps available TX1 input port IDs to human-readable labels.

from hdfury import TX1_INPUT_PORTS

print(TX1_INPUT_PORTS["3"])  # Output: Input 3

MIT