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

CLI 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

Configure

You can get, set, and reset your configuration with wiibalance config.

$ wiibalance config get
{
    "daemon_enabled": "false",
    "address": null,
    "units": "metric"
}

Python Usage

from wiibalance import create_balance_board

board = create_balance_board("<INSERT ADDRESS>")
print(board.read_state())
board.disconnect()
exit()

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.2.1.tar.gz (96.6 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.2.1-py3-none-any.whl (16.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for wiibalance-1.2.1.tar.gz
Algorithm Hash digest
SHA256 258056691f6463c0276cd7c2764e47afdec5ae36f0e0f44644a3e272745964b3
MD5 c2f7b91c82e72a214e55b7dcb557988c
BLAKE2b-256 a7aa648035548c1cb1e7f9ea0cda22f7b930e1a9217a805a13398fb6fc389242

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: wiibalance-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 16.5 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.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 177a2ad863c70903e9d083918e38e2db3e635f8fef1fb959444252499bf307b8
MD5 feaef8a7b7d6ef01eda67479681324c3
BLAKE2b-256 50029060631a9f449607b444cb356485ec943eac33b66b86caa6e89a27d1f53d

See more details on using hashes here.

Provenance

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

This release

1.2.1 This release

2 files

1.2.0

2 files

1.1.0

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