---
title: Local web interface
slug: bar/local-web-interface
description: Learn how to control, customize, and update your BUSY Bar from any browser, entirely offline
image: https://cdn.images.archbee.com/3StCFqarJkJQZV-7N79yY/l8Erb6DR0l6C75VHsDIY1_local-web-interface-prev.png
createdAt: 2025-08-26T10:07:56.244Z
---
The local web interface is a control panel for your BUSY Bar. Built into the device, the interface allows you to set up BUSY Bar, update its firmware, design custom statuses, manage apps, enable HTTP API access, and view the HTTP API reference. You can open the web interface in any browser on Windows, macOS, or Linux via USB or Wi-Fi (LAN).
On this page, you’ll learn:
- [Access the local web interface%section%](docId\:v_izwbs0I2kIljDxY_Kkp)
- [Overview%section%](docId\:v_izwbs0I2kIljDxY_Kkp)
- [Troubleshooting%section%](docId\:v_izwbs0I2kIljDxY_Kkp)
***
# Access the local web interface
You can access the local web interface via USB or Wi-Fi. An internet connection is not required.
::::::ExpandableHeading
### :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/E6JCd96P1l0K38ah5ZGX3_usb-header.png" alt caption width="96" height="96"} Via USB
:::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to the PC via USB.
:::
::::WorkflowBlockItem
On your PC, open a web browser and go to [http://10.0.4.20](http://10.0.4.20). The local web interface will load automatically.
:::ExpandableHeading
*The web interface doesn’t load? Click here for help *:inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** buttons for 3 seconds.
- Make sure your browser is allowed to find devices on local networks: How to enable this on [macOS](https://support.apple.com/en-gb/guide/mac-help/mchla4f49138/mac) and [Windows 11](https://soundondigital.com/support/allow-an-app-through-firewall-windows-11/).
- Try a hard reboot of your BUSY Bar: Press and hold the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::::
::::::
::::::ExpandableHeading
### :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/HKFo9DlWwktKDMQxhDYyZ_wifi-header.png" alt caption width="96" height="96"} Via Wi-Fi
Before opening the web interface via Wi-Fi, make sure:
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/4LSmaeQt0ilTZ-j6q0_hw-20260301-161115.png" alt caption width="88" height="88"} [BUSY Bar is connected to Wi-Fi](docId\:OAuMOf3wwdbFNBlnqffSy) :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/4ylzwhOioPqiUoIdwqS8H-20260302-104633.png" alt caption width="36" height="88"}
**Step 1.**** Enable remote access**
:::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to the PC via USB.
:::
::::WorkflowBlockItem
On your PC, open a web browser and go to [http://10.0.4.20](http://10.0.4.20). The local web interface will load automatically.
:::ExpandableHeading
*The web interface doesn’t load? Click here for help *:inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** buttons for 3 seconds.
- Make sure your browser is allowed to find devices on local networks: How to enable this on [macOS](https://support.apple.com/en-gb/guide/mac-help/mchla4f49138/mac) and [Windows 11](https://soundondigital.com/support/allow-an-app-through-firewall-windows-11/).
- Try a hard reboot of your BUSY Bar: Press and hold the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::WorkflowBlockItem
Turn on the **HTTP API access** toggle.
:::
:::WorkflowBlockItem
*(Optional)* Set a password to secure the web interface.
:::
:::::
**Step 2.**** Check the BUSY Bar's IP address**
:::ExpandableHeading
*In the web interface over USB* :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
1. Open the BUSY Bar's web interface: in a web browser, go to [http://10.0.4.20](http://10.0.4.20)
2. In the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/tSWHP9lg3XARAZOc8ZNOi_network.png" alt caption width="68" height="96"}** Network** tab, copy the IP address.
:::
:::ExpandableHeading
*Directly on BUSY Bar* :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
On your BUSY Bar, go to **Settings → Wi-Fi → View IP Address**. The BUSY Bar will display an IP address.
:::
****
**Step 3.**** Access the web interface via Wi-Fi**
:::::WorkflowBlock
:::WorkflowBlockItem
Open a browser and enter the BUSY Bar's IP address. The web interface will load automatically.
:::
::::WorkflowBlockItem
*(Optional)* Enter your password if you've set one and click **Unlock**.
:::ExpandableHeading
*The web interface doesn’t load? Click here for help *:inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Make sure you‘re connecting your BUSY Bar to the **same** Wi-Fi network as your PC.
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** buttons for 3 seconds.
- Make sure your browser is allowed to find devices on local networks: How to enable this on [macOS](https://support.apple.com/en-gb/guide/mac-help/mchla4f49138/mac) and [Windows 11](https://soundondigital.com/support/allow-an-app-through-firewall-windows-11/).
- Try a hard reboot of your BUSY Bar: Press and hold the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::::
::::::
***
# Overview
The local web interface has five tabs:
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/tSWHP9lg3XARAZOc8ZNOi_network.png" alt caption width="68" height="96"} **[Network](https://docs.busy.app/bar/local-web-interface#network-tab)** — Manage BUSY Bar’s Wi-Fi connection and access the HTTP API
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/PyPJR1bOsQ8HdmACBubEG_firmware.png" alt caption width="68" height="96"} **[Firmware](https://docs.busy.app/bar/local-web-interface#firmware-tab)** — View firmware information and update BUSY Bar
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/AfTLmams5FMsAPAkj2oOJ_settings.png" alt caption width="68" height="96"} **[Settings](https://docs.busy.app/bar/local-web-interface#settings-tab)** — Configure BUSY Bar settings, smart home integration, and time zone
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"} **[Draw tool](https://docs.busy.app/bar/local-web-interface#draw-tool)** — Create custom statuses and display them on BUSY Bar
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/0IwYAxPb1f0DgfrXzbIXI_apps-icon.png" alt caption width="68" height="96"} **[Apps](https://docs.busy.app/bar/local-web-interface#apps-tab)** — Install, configure, update, and delete custom apps on BUSY Bar
At the top of each tab, you’ll find the battery level, connection status, BUSY Bar name, and a live view of its screen. In the top-right corner, open the account menu to change the web interface theme, set a web interface password, or link your BUSY account.
## Rename BUSY Bar
::::WorkflowBlock
:::WorkflowBlockItem
Click the BUSY Bar name at the top of the screen and click **Rename**.
:::
:::WorkflowBlockItem
Enter the new name and click **Rename**.
:::
::::
## Change the web interface theme
::::WorkflowBlock
:::WorkflowBlockItem
Сlick the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** icon in the top-right corner.
:::
:::WorkflowBlockItem
Click **Switch to light theme** (or **Switch to dark theme**).
:::
::::
## Set a password for the web interface
You can restrict access to the web interface by protecting it with a password. The password will be required when connecting over Wi-Fi. When connecting via USB, no password is required.
::::WorkflowBlock
:::WorkflowBlockItem
Сlick the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** icon in the top-right corner.
:::
:::WorkflowBlockItem
Click **Set password**.
:::
:::WorkflowBlockItem
Enter the password and click **Set password**.
:::
::::
:::hint{type="warning"}
Remember your web interface password carefully — it cannot be recovered, but only [reset via a wired connection](https://docs.busy.app/bar/troubleshooting/local-web-interface#forgot-password-when-accessing-the-web-interface-o).
:::
## Link your BUSY account
To link the BUSY Bar to your BUSY account and sync your data across all platforms:
::::WorkflowBlock
:::WorkflowBlockItem
In the web interface, click the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** icon in the top-right corner.
:::
:::WorkflowBlockItem
Click **Log in to BUSY account**.
:::
:::WorkflowBlockItem
Log in to your BUSY account with your email address, or continue with Google, Apple, or Microsoft.
:::
:::WorkflowBlockItem
In your BUSY account, click **Connect** under the BUSY Bar screen.
:::
:::WorkflowBlockItem
On your BUSY Bar, go to **Settings → Account → Get pairing code** — BUSY Bar will display a pairing code.
:::
:::WorkflowBlockItem
In your BUSY account, enter the code and click **Connect**.
:::
::::
***
# Network tab
In the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/tSWHP9lg3XARAZOc8ZNOi_network.png" alt caption width="68" height="96"} **Network** tab, you can manage the BUSY Bar‘s Wi-Fi connection, view the BUSY Bar‘s IP address, and access the HTTP API:
## Connect BUSY Bar to Wi-Fi
The web interface allows you to connect your BUSY Bar to Wi-Fi and manage its Wi-Fi connection. Learn more in [Connect to W-Fi](https://docs.busy.app/bar/basics/connect-wifi#connect-to-wi-fi-using-the-web-interface-on-your-p).
## View HTTP API documentation
Access the HTTP API reference locally by opening the **HTTP API docs** in the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/tSWHP9lg3XARAZOc8ZNOi_network.png" alt caption width="68" height="96"}** Network** tab. It is also published online in BUSY Docs. [Learn more about BUSY Bar HTTP API](docId\:H4whpEXTNlYjSR9PlxsAr).
## Enable HTTP API access
You can enable HTTP API access to send requests and control BUSY Bar when connected via Wi-Fi. By default, access via Wi-Fi is disabled. To enable it, you need to switch on the HTTPI API access toggle and set a password — it will be required each time you open the web interface via Wi‑Fi as well as for authorizing HTTP API requests.
:::hint{type="warning"}
Remember the HTTP API access password carefully — it cannot be recovered, but only [reset via a wired connection](docId\:HEQ_Fu6jIWRgAqCvoWbak).
:::
***
# Firmware tab
In the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/PyPJR1bOsQ8HdmACBubEG_firmware.png" alt caption width="68" height="96"} **Firmware** tab, you can view the current firmware version, update BUSY Bar, and manage automatic overnight updates.
## Update BUSY Bar firmware via the web interface
Before updating the firmware, make sure:
- :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/Y6td4MdXp2hktGeyFxeMS-20260301-161127.png" alt caption width="96" height="88"} [BUSY Bar’s battery charge is at least 40%%page%](docId:6gAZ7MkPcoNI4E1ZxxPhk)
To update the BUSY Bar firmware:
::::WorkflowBlock
:::WorkflowBlockItem
Go to the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/PyPJR1bOsQ8HdmACBubEG_firmware.png" alt caption width="68" height="96"}** Firmware** tab and click **Update**.
:::
:::WorkflowBlockItem
In the window that opens, click **Start update** — the update will take **around 3 minutes**.
:::
::::
***
## Update BUSY Bar firmware manually from a file
::::WorkflowBlock
:::WorkflowBlockItem
Download the `.tgz` firmware file from the [firmware releases page on GitHub](https://github.com/busy-app/busybar-firmware/releases).
:::
:::WorkflowBlockItem
[Access the local web interface.](docId\:v_izwbs0I2kIljDxY_Kkp)
:::
:::WorkflowBlockItem
Go to the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/PyPJR1bOsQ8HdmACBubEG_firmware.png" alt caption width="68" height="96"} **Firmware** tab.
:::
:::WorkflowBlockItem
Click **Update from file**.
:::
:::WorkflowBlockItem
Select the downloaded file, then click **Start update**.
:::
::::
***
# Settings tab
In the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/AfTLmams5FMsAPAkj2oOJ_settings.png" alt caption width="68" height="96"} **Settings** tab, you can remotely control the sound and brightness of your BUSY Bar, change its time zone, manage smart home integration, and get information about your BUSY Bar.
## Change time zone
::::WorkflowBlock
:::WorkflowBlockItem
In the web interface, open the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/AfTLmams5FMsAPAkj2oOJ_settings.png" alt caption width="68" height="96"}** Settings** tab.
:::
:::WorkflowBlockItem
In **Time zone**, select your preferred time zone.
:::
::::
## Manage smart home integration
With BUSY Bar, you can optimize your home for deep focus by controlling your smart home devices the moment you start or stop a focus session. The web interface lets you add your BUSY Bar to smart home systems, forget pairings, and see the number of connections. Alternatively, you can do some of it using your BUSY Bar or smart home app. Learn more in [Smart home](docId\:cjan7zSDPB8yGpf4ZngI3).
To add your BUSY Bar to your smart home via the web interface:
::::WorkflowBlock
:::WorkflowBlockItem
In the web interface, open the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/AfTLmams5FMsAPAkj2oOJ_settings.png" alt caption width="68" height="96"}** Settings** tab.
:::
:::WorkflowBlockItem
In the **Smart home option**, click **+ Pair device**. You'll see a QR code.
:::
:::WorkflowBlockItem
On your phone, open your smart home app and go to **+ → Add Accessory -> Scan QR code**.
:::
:::WorkflowBlockItem
Scan the QR code shown in the web interface. Alternatively, you can enter the code manually.
:::
:::WorkflowBlockItem
Assign your BUSY Bar to a room and name it to help you identify and control it.
:::
::::
To remove all smart home connections via the web interface:
::::WorkflowBlock
:::WorkflowBlockItem
In the web interface, open the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/AfTLmams5FMsAPAkj2oOJ_settings.png" alt caption width="68" height="96"} **Settings** tab.
:::
:::WorkflowBlockItem
In the Smart home option, click **Forget all pairings**.
:::
:::WorkflowBlockItem
In the pop-up, confirm by clicking **Forget all pairings**.
:::
::::
Your BUSY Bar will be removed from your smart home automations and will restart.
***
# Draw tool
The :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool** provides a pixel-based canvas where you can arrange elements however you like. Create and edit your own unique statuses with a simple, user-friendly visual editor right in your browser, then display them on your BUSY Bar with a single click.
Learn more about [Draw tool%page%](docId\:yhy-U_oNsGv2fIiWzatMn)
::Image[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/-WLORUNCtav0hPLI2jqla_draw-tool-tab.png" size="100" isUploading="false" width="1780" height="973" darkWidth="1780" darkHeight="973" showCaption="true" position="center"}
***
# Apps tab
In the :inlineImage[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/0IwYAxPb1f0DgfrXzbIXI_apps-icon.png" alt caption width="68" height="96"}** Apps** tab, you can install, start, stop, configure, update, and delete BUSY Bar apps. To install or update an app, upload its `.tgz` file in the web interface. Some app settings are only available in the web interface.
The Apps tab is available with firmware 1.3.1 and later. To learn more, visit [Manage apps on BUSY Bar%page%](docId\:pqsePhUA0iLDLeuetPoIF)
***
# Troubleshooting
Need help with the local web interface? Find solutions to common issues, including forgotten passwords and connection problems in the [Local web interface issues](docId\:HEQ_Fu6jIWRgAqCvoWbak) page.