ibuddy 1.0.0

Control the MSN i-Buddy USB figure from Python

ibuddy

Control your MSN i-Buddy USB figure from Python.

Install

pip install ibuddy

Quick Start

from ibuddy import IBuddyDevice

with IBuddyDevice() as buddy:
    buddy.demo()
    buddy.head_color("red")
    buddy.flap(5)
    buddy.heartbeat(3)

Available Colors

red, green, blue, cyan, magenta, yellow, white

What Can It Do?

Method	Description
head_color(name)	Set head LED to a named color
heart(on)	Turn the heart LED on/off
flap(times)	Flap the wings N times
wiggle(times)	Swivel torso left/right N times
heartbeat(times)	Blink the heart LED N times
rainbow(times)	Cycle through all 7 colors
celebrate()	Party mode: wiggle + flap + heartbeat + rainbow
demo()	Full demo of all features
reset()	Turn everything off

All action methods accept times and delay/duration parameters for fine control.

Context Manager

Always use with to ensure the device is properly reset when done:

with IBuddyDevice() as buddy:
    buddy.head_color("blue", duration=1.0)
    buddy.flap(3)
# Automatically resets and closes

Platform

Windows only - The i-Buddy uses Windows HID APIs for communication.

License

MIT