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.1.0.tar.gz (95.7 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.1.0-py3-none-any.whl (15.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for wiibalance-1.1.0.tar.gz
Algorithm Hash digest
SHA256 c9262c7f3a39ae65e218853a17e844eec016213ef317aa92ed7afa01a30e2781
MD5 9fe40fc7ecadfdca5d0c762852635698
BLAKE2b-256 e9018f5e6e17ddb7785198b1fea4cec92e54e4d2334f63aa51743958a2549ace

See more details on using hashes here.

Provenance

The following attestation bundles were made for wiibalance-1.1.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.1.0-py3-none-any.whl.

File metadata

  • Download URL: wiibalance-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.3 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 681106242d5d4184580461ee0591ed37653bba63e6a1d8e57e71d2b1998ed5a4
MD5 ece2b397a5421fe68893616401f7be1a
BLAKE2b-256 c87a711b51653dec4f1a54c6508afdf5f5710d85255cf6b8edfba2ba16c68b57

See more details on using hashes here.

Provenance

The following attestation bundles were made for wiibalance-1.1.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

This release

1.1.0 This release

2 files

1.0.0

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