busybar-tools 0.2.0

CLI tools to manage BUSY Bar

BUSY Bar Tools

Command-line (CLI) tools to manage your BUSY Bar device.

• Easy to install by single command.
• Work on Linux and MacOS.
• There are no heavy dependencies.

Available as a Python package on PyPI. Source code available on GitHub.

Installation

brew install pipx           # MacOS (Homebrew)
sudo apt install pipx       # Ubuntu/Debian
pipx ensurepath             # Optional

# If you haven't install `pipx` before, you will NEED to open a new terminal before continuing.

pipx install busybar-tools

Usage

To use the tools, simply run the busybar command followed by the desired subcommand:

busybar [options] <subcommand>

Available commands and options

• busybar update [branch or tag or URL]: Update firmware via HTTP API. Default branch is dev.
• busybar cli: Start interactive CLI terminal session to BUSY Bar.

Options:

• -d, --device DEVICE BUSY Bar Device IP address (USB LAN or Wi-Fi)
• -p, --port PORT Device Port
• -t, --target {20,21,22} Target hardware version

Examples

Update firmware

• busybar update - Update to the latest firmware from the dev branch.

• busybar update 0.5.0 - Update to a specific TAG version (e.g., 0.5.0 release).

• busybar update factory - Update to firmware from the desired (e.g., factory) branch.

• busybar update porta/remote-control - Update to the desired branch another way.

• busybar update https://update.flipperzero.one/builds/busybar-firmware/0.5.0/ - Update using a direct URL to the folder with build artifacts.

• busybar -d 10.0.5.20 update - Specify a custom device IP address.

CLI terminal

• busybar cli - Start a terminal session to the BUSY Bar device. Press Ctrl+] to exit the session.
• busybar -d 10.0.5.20 -p 23 cli - Start a terminal session to the BUSY Bar device with a custom IP address and port.

---

Changelog

Upcoming features plan

• Easy recovery via DFU from any possible broken state
• Factory reset
• ...create an issue for any feature requests or bug reports!

0.2.0 - latest

• CLI terminal session to device available via busybar cli command
• Improved file path handling to more reliablely locate update files

0.1.0

• Initial release (basic functionality for firmware update)