User Interface#

#GUI

The GUI of Braiins Toolbox offers a user-friendly interface, composed of three segments represented by tabs. Let's explore the layout and structure of these tabs:

• Device List: This tab displays the list of detected bitcoin mining devices on your network. It provides an overview of device information and mining status.
• Device Management: Upon opening the app, you are directed to this tab. Here, you can define the network to be scanned for devices, allowing you to specify the range or specific IP addresses.
• Pool Presets: Define pool configurations for your mining pools and save them as presets. Quickly apply these presets when configuring pools on your miners for added efficiency.
• Braiins OS Updates: Access the latest Braiins OS firmware versions along with a "What's New" section to easily track changes and updates in the most recent Braiins OS releases.
• Logs: This tab allows you to access and review logs related to user's actions, including action logs and system logs.
• Shortcuts: Use the shortcut cheat sheet to control your Toolbox entirely with keyboard shortcuts, eliminating the need for a mouse or touchpad.
• Manual: Redirect to the Braiins Toolbox Manual in Braiins Academy for detailed guidance and resources.

By navigating between these tabs, you can efficiently manage your mining devices, configure settings, and access important information.

Toolbox runs as a single window by default. Opening a second window shows a notice instead of starting a duplicate instance.

#Device List

The Device List tab displays all detected miners, shown page by page with pagination support. Users can customize which data columns are visible and change their order.

The list itself is a snapshot, populated by Scan and Refresh: scanning discovers devices and builds the list, refreshing updates the data for the devices already in it, and either one leaves the list exactly as it finished until you run the next one. Because every column comes from that same snapshot, there's no longer a distinction between static and live attributes, everything from miner model and pool configuration to hashrate, power consumption, temperature, and fan speed can be sorted, filtered, and included in CSV exports alike.

#Shortcuts

Toolbox now offers the ability to control everything via keyboard shortcuts, making it faster and easier to manage your mining fleet. Whether you're opening the Command Palette to navigate and confirm actions or using shortcuts on the Device List, these options allow seamless miner selection, quick access to actions and configurations, and effortless navigation — all without a mouse or touchpad.

With these shortcuts, you can:

• Access the Command Palette (Ctrl + P / ⌘ + P) to effortlessly navigate Toolbox tabs, explore Batch Actions, and confirm selections to apply changes seamlessly.
• Utilize shortcuts in the Device List to quickly search, select, and manage devices.

Check out the GIF below to see it in action!

#CLI

The CLI consists of 9 commands:

• scan
• firmware
• system
• miner
• tuner
• cooling
• custom-contract
• self
• advanced

The commands consist of other related subcommands (except for the scan command, which is standalone).

Users can use the command below to see a list of options and commands that are possible in Braiins Toolbox.

./braiins-toolbox --help

Usage: braiins-toolbox [OPTIONS] [COMMAND]

Commands:
  scan             Scan the provided IP addresses or ranges and print all discovered miners to stdout
  firmware         Firmware-related commands - install, uninstall, upgrade, ...
  system           System-related commands - data collection, reboot, exec, ...
  miner            Miner-related commands - pool urls, start, stop, restart, ...
  tuner            Tuner-related commands - set hashrate/power target, set DPS ...
  cooling          Cooling management - cooling mode
  custom-contract  Manage custom contract for BOS FW
  self             Commands for working with toolbox itself
  advanced         Manage Advanced Braiins OS settings

Options:
  -g, --gui-listen-address <ADDR>      GUI address to listen on [default: 127.0.0.1:8888]
      --gui-config-path <PATH>         Path to the config file
      --pool-presets-file-path <FILE>  Path to file with pool presets
  -p, --password <PASSWORD>            Override default password
  -t, --timeout <DURATION>             Timeout for network operations [default: 10s]
  -r, --scan-rate <RATE>               Number of IP addresses scanned per second. Decrease when running over a VPN or
                                       with an unstable or slow connection. Increase when running on the same local
                                       network where all miners are located [default: 250]
      --logfile-path <FILE>            Path to file where debug log file
      --max-log-size <SIZE>            Maximum size for all rolling log files combined [default: 1GB]
  -h, --help                           Print help
  -V, --version                        Print version

#Global Options

Users can apply the following global options to any batched operations:

• --gui-listen-address for setting the address to listen on the Braiins Toolbox. Default is 127.0.0.1:8888.
• --gui-config-path servers for defining the path for the configuration of GUI. Default config file is stored in .config/braiins-toolbox/config.toml.
• --pool-presets-file-path represents the path to the file with pool presets.
• --password, which is used if the default web password of the miner(s) is changed to the custom password.
• --timeout, which is a timeout for network operations with a default value of 8 seconds.
• --scan-rate is an option, which controls the number of scanned IP addresses per second. Default is 2000.
• --logfile-path for setting the path for the Toolbox log file.
• --max-log-size defines the maximum size of all rolling Toolbox log files combined, default is 1GB.
• --help, which displays the list of possible options and commands.
• --version, which displays the Toolbox version.