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.0.tar.gz (96.4 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.0-py3-none-any.whl (16.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: wiibalance-1.2.0.tar.gz
  • Upload date:
  • Size: 96.4 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.0.tar.gz
Algorithm Hash digest
SHA256 651bed87c8d1f35a4c226dede8937aa7f960e80f8d6f1e6fd970c4ec7030e5e4
MD5 af3efb8a06b13a6286fa6cbd40d76bfe
BLAKE2b-256 a1dd284e5dd357f81118ca350fdd581784499516aa693433a1a984e731fe03fa

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: wiibalance-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 16.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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f7fb86721b28f700532cf409087ac156a28600cfc8f97ccda5efc28b01267ec3
MD5 f63a77d6198010816b10342a49c4e4d7
BLAKE2b-256 2e6500150db225eb0c6a14fff8729a05dbbc09ffc74207963fa3939aaf203584

See more details on using hashes here.

Provenance

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

This release

1.2.0 This release

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