WiiBalance

The modern Python controller for the Wii Balance Board.

Linux PyPI Version

wiibalance

Features

  • Connect to a Wii Balance Board via Bluetooth
  • Read sensors, battery, button, and LED states
  • Control LED

Why WiiBalance?

  • Permanent pairing via daemon! Only press sync once
  • Fast and modern
  • CLI interface
  • Easy to use
  • Looks super cool
  • Developer friendly

Installation

Installing WiiBalance is incredibly easy :)

pip install wiibalance

Usage

You'll want to install the WiiBalance daemon so that you don't have to re-pair your board after every command. Identify your board by its Bluetooth address and run the following command:

$ wiibalance daemon setup -a <address>

Now, you can use the CLI!

Live Demo

To display a cool-looking visualization of the Wii Balance Board's current state, run

$ wiibalance live

You can also use --json to get a clean JSON representation of the current state.

Read Weight

$ wiibalance weight
Total Weight: 0.82

Read Position

$ wiibalance cop
Center of Pressure: (1.0, 1.0)

The center of pressure is the point where the user's weight "is" on the board. It is mapped -1 to 1 left to right (X) and -1 to 1 bottom to top (Y) such that (0, 0) is the center of the board.

Control LED

$ wiibalance led --on
$ wiibalance led --off
$ wiibalance led # toggle

Pretty straightforward.

Daemon

The WiiBalance daemon manages your board connection in the background. It provides six commands:

  • setup - Configure the daemon with your board's Bluetooth address (run once)
  • remove - Remove the daemon configuration

The following commands are convenient wrappers around systemctl:

  • status - Check if the daemon is running
  • start - Start the daemon service
  • stop - Stop the daemon service
  • restart - Restart the daemon service
$ wiibalance daemon status
$ wiibalance daemon start

In-depth docs coming soon!

Issues & Contributing

Please open an issue or submit a pull request! :)

Project links

Data verified by PyPI on Aug 15, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.3.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for bboonstra from gravatar.com bboonstra

Credits

Author: Ben Boonstra

GitHub Statistics

Data verified by PyPI on Aug 15, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Tags

balance-board bluetooth nintendo wii

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wiibalance-1.0.0.tar.gz (94.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wiibalance-1.0.0-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file wiibalance-1.0.0.tar.gz.

File metadata

  • Download URL: wiibalance-1.0.0.tar.gz
  • Upload date:
  • Size: 94.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for wiibalance-1.0.0.tar.gz
Algorithm Hash digest
SHA256 0982423a7c09d9f9807f5887302ff94f8c5499d1a964a84e4b897d9dca2b8770
MD5 20b8088d6ae005ea30f9d6136b6a00ab
BLAKE2b-256 5d68f7410f7247776d8e740594ddcdbe2ad1abe5ee3e166123d9cf00a8bb17da

See more details on using hashes here.

Provenance

The following attestation bundles were made for wiibalance-1.0.0.tar.gz:

Publisher: pypi.yml on bboonstra/wiibalance

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file wiibalance-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: wiibalance-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 14.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for wiibalance-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6237d90a228f2ebde761b20c6c478ed5582d2d1684cdc8f723e7d08d3169015a
MD5 02c4c7d423596002850f1341fe88ffea
BLAKE2b-256 7625962c58906850a5369d78be258e8d485cd898ed717b2a552ef95fbed526b6

See more details on using hashes here.

Provenance

The following attestation bundles were made for wiibalance-1.0.0-py3-none-any.whl:

Publisher: pypi.yml on bboonstra/wiibalance

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.3.1

2 files

1.3.0

2 files

1.2.1

2 files

1.2.0

2 files

1.1.0

2 files

This release

1.0.0 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page