[space] 🍅 BUSY Docs
[title]
[path] Development/
[title]
[path] Development/
[title]
[path] Development/
[title]
[path] Development/
[title]
[path] Development/
[title] Set up modes on BUSY Bar
[path] BUSY and CUSTOM modes/
You can set up BUSY and CUSTOM modes right on your BUSY Bar. Alternatively, you can [configure them from your phone](docId\:yVHx6rLpS7IxuvbKVPj5-).
On this page, you’ll learn how to change mode settings and see an overview of the available options.
***
## Change mode settings
You can change the timer settings and the status theme:
::::WorkflowBlock
:::WorkflowBlockItem
Switch your BUSY Bar to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} or :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-i3AtQ2KI77_AOwtJ6Bbp-20260313-124654.png" alt="CUSTOM" caption width="135" height="72"} to set up the chosen mode.
:::
:::WorkflowBlockItem
Go to **Setup -> Timer** to change timer settings.
:::
:::WorkflowBlockItem
Go to **Setup -> Theme** to set the status when in a focus session.
:::
:::WorkflowBlockItem
Go to **Setup -> Smart home -> Trigger smart home** to enable or disable smart home automation.
:::
::::
***
## Timer settings
- **Mode:**
- **Interval** — work and rest phases, like a Pomodoro timer.
- **Simple** — a countdown to the end of the session.
- **Off** — no time limit. The session runs until you stop it.
- **Autostart:** When On, the next phase starts automatically
- **Show work phase only: **When On, the device doesn't display the rest phase or pause on the main screen
***
## Default settings
**BUSY mode: **interval timer — 20 min work / 5 min rest × 3 cycles
**CUSTOM mode: **simple timer — 20 min with “Keep out” theme
[title]
[path] Development/
[title] Development
[path] /
Developers can control BUSY Bar through its open HTTP API, including displaying custom images, switching operating modes, and configuring device settings. The same API works over local connections via USB or Wi-Fi, as well as remotely over the internet using API token authentication.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"} **Coming soon**
The SDK for developing BUSY Bar apps in JavaScript is under development.
:::
***
# HTTP API
::::LinkArray{contentSource="CUSTOM" customOrder="onVvtt6uikj_kLIdqTyS2,CWZF7_BgtKyRZFqikXfxR,mHB0Yhjc8inn7D5I7AjxF,v6y9UlOGC2Xs_Qp1fpyoY"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/XHXLIbVkbkg4eGHMo84HT_about-api.jpg"}
[About HTTP API](https://docs.busy.app/bar/dev/http-api)
Control your BUSY Bar from any script, application, or service
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/dI3en77ViIxEGtI1fwEB6_busy-bar-http-api-new.png"}
[BUSY Bar HTTP API reference](https://api.busy.app/busybar/docs)
Complete reference of all BUSY Bar HTTP API endpoints
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/bDRLmK_Okvvon4qZXN9pG_account-api.png"}
[BUSY account HTTP API reference](https://api.busy.app/docs)
Reference of the cloud endpoints for timer state and profiles
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/psYaN1qXzPWB_6Arqg2Yw_api-keys.jpg"}
[API tokens](https://docs.busy.app/bar/dev/api-tokens)
Manage your API tokens for remote connection to BUSY Bar
:::
::::
***
# busylib library
::::LinkArray{contentSource="CUSTOM" customOrder="2uHME40QltuhW17kDYNcA,gHA_deNbW2UHBw9xbXjl4,BF7YbTFShCTndpwMG_SFL"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ayHOmRd7ESYDHNI9TSIkL_python-logo.jpg"}
[Python library](https://pypi.org/project/busylib/)
Official Python wrapper for the HTTP API
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/V7J81VeB58fsjg8BWBZmO_group-2087328340.jpg"}
[Python library docs](https://busy-app.github.io/busylib-py/)
Setup guide, examples, and API reference
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/2nMyL30R83hSoqpG17NSK_ts-logo.jpg"}
[TypeScript library](https://go.busy.app/typescript-library)
Official TypeScript wrapper for the HTTP API
:::
::::
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"} **L********ibraries from the community**
There are also libraries for the BUSY Bar HTTP API, built and maintained by the community:
- [BusyBar .NET](https://busybar-dotnet.homotechsual.dev/)
- [busybar.zig](https://tty.fail/mrus/busybar.zig)
:::
***
# Sources
::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ugc9-p-3bASGKmUtC3IIf_github-repo-frimware.jpg"}
[Firmware repository](https://github.com/busy-app/busybar-firmware)
Official BUSY Bar firmware repository
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/vJJNsT3DEyLZ0GQz6Pi1y_3d-model-section-preview.png"}
[BUSY Bar 3D model](https://busy.app/pages/downloads#model)
Model of BUSY Bar for community projects
:::
::::
***
# Build your own widgets
You can create your own BUSY Bar widgets using our open HTTP API, turning the device into a programmable display showing real-time data. Check out our guide on creating widgets without coding in the BUSY Blog:
::::LinkArray{contentSource="CUSTOM" itemsPerRow="3"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/i0o28yX9cH0RajmrxB8Eo-20260618-113257.jpg"}
[How to Make BUSY Bar Widgets Without Coding](https://blog.busy.app/how-to-make-a-busy-bar-widget-without-coding/)
:::
::::
::::LinkArray{contentSource="DOCS" sourceParentDocId="IJMjCoU-v0qH0qpY-DbKO" childrenDocs}
:::LinkArrayItem
:::
::::
[title] Google Calendar integration
[path] Apps and integrations/
Google Calendar integration allows you to get reminders about upcoming events on your BUSY Bar and show your status during meetings. It helps you never miss important events and lets others know you’re busy.
On this page, you’ll learn about Google Calendar integration, how to connect and disconnect calendars:
- [How the calendar syncing works%section%](docId\:BLGy7-zUp3bo9IXaMhGea)
- [Connect to your Google Calendar%section%](docId\:BLGy7-zUp3bo9IXaMhGea)
- [Customize reminders and statuses%section%](docId\:BLGy7-zUp3bo9IXaMhGea)
- [Disconnect from your Google Calendar%section%](docId\:BLGy7-zUp3bo9IXaMhGea)
***
# How the calendar syncing works
Once synced with your Google Calendar, the BUSY Bar automatically displays real-time updates for your events:
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/jjjcc5pvaUQCnIA3GEtoj_reminder.png" alt caption width="72" height="96"}** Before the event:** BUSY Bar shows a reminder with the event title and a countdown to the event start.
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/hGQW_sFMrWzCPfllkj4HX_event.png" alt caption width="72" height="96"}** During the event:** The display switches to an active status, showing the event title and the time remaining. You can change the status to a custom message.
You can customize the reminder and the message shown during the event, or disable them completely. You can also sync multiple calendars from different Google accounts and set notifications for each one separately.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****How events work on BUSY Bar**
- **Always on top:** Events overlay any status and are shown even in sleep mode
- **Event overlap:** Newest events and most recently added calendars take priority
- **All-Day events:** Events lasting 24+ hours are not shown
:::
***
# Connect your Google Calendar
Before connecting, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/SFkJbuMrpDI2lbNtHKnpq-20260310-132733.png" alt caption width="88" height="88"}[BUSY Bar is linked to your BUSY account%page%](docId\:CtPB9O5UzErW5xMxE3Yuw)
To connect your Google Calendar:
::::::WorkflowBlock
:::::WorkflowBlockItem
::::Tabs
:::Tab{title="Web browser"}
Open [cloud.busy.app](https://cloud.busy.app/) in your browser.
:::
:::Tab{title="Desktop BUSY App"}
1. Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"} **BUSY App **on your computer.
2. In the BUSY Bar tab, click **Google Calendar**.
3. Click **Connect**.
:::
::::
:::::
:::WorkflowBlockItem
Log in to your BUSY account with your email address, or continue with Google, Apple, or Microsoft.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y2NYFG9F_J5mMKTaW4s7J_integrations-icon.png" alt caption width="72" height="96"}** Integrations → Google Calendar → Connect.**
:::
:::WorkflowBlockItem
Choose a **Google account** you want to connect to.
:::
:::WorkflowBlockItem
Allow BUSY account to view your Google Calendar events to display them on the BUSY Bar screen.
:::
:::WorkflowBlockItem
Select calendars to synchronize with.
Once you connect your Google account, all calendars are added automatically. To hide reminders from specific calendars, you can turn them on or off in the integration settings for Google Calendar.
:::
:::WorkflowBlockItem
*(Optional) *Connect calendars from other Google accounts by clicking **Add account**.
:::
::::::
***
# Customize reminders and statuses
You can adjust how reminders appear before an event and what status is shown during the event.
::::WorkflowBlock
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y2NYFG9F_J5mMKTaW4s7J_integrations-icon.png" alt caption width="72" height="96"} **Integrations → Google Calendar → Manage**.
:::
:::WorkflowBlockItem
Click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/GcXQTz7qtJ9RWys_bFN3N_calendar-settings-icon.png" alt caption width="72" height="96"}** Settings** icon next to the calendar you want to customize.
:::
:::WorkflowBlockItem
Customize reminders and meeting status.
:::
::::
::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/jjjcc5pvaUQCnIA3GEtoj_reminder.png" alt caption width="72" height="96"}** Event reminders**
Configure how BUSY Bar notifies you before an event:
- Enable or disable reminders
- Set how long before the event the reminder should appear
- Enable or disable sound notifications
- Show the upcoming event name in the reminder
:::
:::VerticalSplitItem
****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/hGQW_sFMrWzCPfllkj4HX_event.png" alt caption width="72" height="96"}** Status during events**
Control how your status appears while a meeting is active:
- Enable or disable automatic status for events
- Display the event name or choose a status from the list
- Enable or disable sound notifications
:::
::::
***
# Disconnect your Google Calendar
You can disconnect individual calendars or remove all calendar connections at once.
::::::WorkflowBlock
:::::WorkflowBlockItem
::::Tabs
:::Tab{title="Web browser"}
Open [cloud.busy.app](https://cloud.busy.app/) in your browser.
:::
:::Tab{title="Desktop BUSY App"}
1. Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"} **BUSY App** on your computer.
2. In the BUSY Bar tab, click **Google Calendar**.
3. Click **Connect**.
:::
::::
:::::
:::WorkflowBlockItem
Log in to your BUSY account with your email address, or continue with Google, Apple, or Microsoft.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y2NYFG9F_J5mMKTaW4s7J_integrations-icon.png" alt caption width="72" height="96"} **Integrations → Google Calendar → Manage**.
:::
:::WorkflowBlockItem
Click **Remove** to disconnect an individual Google Calendar.
If you have multiple calendars, you can remove them one at a time by clicking **Remove** next to each calendar, or disconnect all at once by clicking **Remove integration**.
:::
::::::
[title] Firmware update
[path] Basics/
We recommend updating your device’s firmware regularly to get the latest features and improvements. Updating to the latest firmware will not affect your data or settings. On this page, you’ll learn how to update your BUSY Bar firmware:
- [Directly on your BUSY Bar%section%](docId\:CtPB9O5UzErW5xMxE3Yuw)
- [Using your phone%section%](docId\:CtPB9O5UzErW5xMxE3Yuw)
- [Using your computer%section%](docId\:CtPB9O5UzErW5xMxE3Yuw)
***
# Update the firmware directly on your BUSY Bar
Before updating the BUSY Bar firmware, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4LSmaeQt0ilTZ-j6q0_hw-20260301-161115.png" alt caption width="88" height="88"} [BUSY Bar is connected to Wi-Fi%page%](docId\:OAuMOf3wwdbFNBlnqffSy)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y6td4MdXp2hktGeyFxeMS-20260301-161127.png" alt caption width="96" height="88"}[BUSY Bar has at least 40% charge%page%](docId:6gAZ7MkPcoNI4E1ZxxPhk)
To update the BUSY Bar firmware:
::::WorkflowBlock
:::WorkflowBlockItem
On your BUSY Bar, go to **Settings → Firmware**.
If a new firmware update is available, you’ll see **New** next to **Firmware**.
:::
:::WorkflowBlockItem
Confirm the installation of the new firmware on your BUSY Bar. The update will take **around 3 minutes**.
:::
::::
## Automatic overnight firmware updates
BUSY Bar can automatically update its firmware overnight whenever a new version is available. **Automatic updates are enabled by default** and run between 2 AM and 5 AM, according to your BUSY Bar's system time.
To disable automatic firmware updates:
::::WorkflowBlock
:::WorkflowBlockItem
On your BUSY Bar, go to **Settings → Firmware → Settings**.
:::
:::WorkflowBlockItem
Set **Auto-update** to **Off**.
:::
::::
***
# Use your phone to update the BUSY Bar firmware
Before updating the BUSY Bar firmware using your phone, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} [Your phone has BUSY App installed%page%](https://busy.app/downloads)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4LSmaeQt0ilTZ-j6q0_hw-20260301-161115.png" alt caption width="88" height="88"} [BUSY Bar is connected to Wi-Fi%page%](docId\:OAuMOf3wwdbFNBlnqffSy)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y6td4MdXp2hktGeyFxeMS-20260301-161127.png" alt caption width="96" height="88"}[BUSY Bar has at least 40% charge%page%](docId:6gAZ7MkPcoNI4E1ZxxPhk)
To update the BUSY Bar firmware:
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Tap **Update now**. The update will start automatically and take **around 3 minutes**.
:::
::::
***
# Use your computer to update the BUSY Bar firmware
You can update your BUSY Bar firmware from your PC in four ways:
- [Using the local web interface%section%](docId\:CtPB9O5UzErW5xMxE3Yuw)
- [Using your BUSY account%section%](docId\:CtPB9O5UzErW5xMxE3Yuw)
- [Using BUSY App on your Mac%section%](docId\:CtPB9O5UzErW5xMxE3Yuw)
- [From a file using the local web interface%section%](docId\:CtPB9O5UzErW5xMxE3Yuw)
## Using the local web interface
This method works on Windows, macOS, and Linux. Before updating the firmware, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4LSmaeQt0ilTZ-j6q0_hw-20260301-161115.png" alt caption width="88" height="88"} [BUSY Bar is connected to Wi-Fi%page%](docId\:OAuMOf3wwdbFNBlnqffSy)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y6td4MdXp2hktGeyFxeMS-20260301-161127.png" alt caption width="96" height="88"}[BUSY Bar has at least 40% charge%page%](docId:6gAZ7MkPcoNI4E1ZxxPhk)
To update the BUSY Bar firmware:
:::::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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::WorkflowBlockItem
In the web interface, go to the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/A7JXZVtnX-PpRToD6kBhh-20260304-124815.png" alt caption width="68" height="88"} **Firmware** tab, then click **Update**.
:::
:::WorkflowBlockItem
In the window that opens, click **Start update** — the update will take **around 3 minutes**.
:::
:::::
## Using your BUSY account
This method works on Windows, macOS, and Linux. Before updating the firmware, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4LSmaeQt0ilTZ-j6q0_hw-20260301-161115.png" alt caption width="88" height="88"} [BUSY Bar is connected to Wi-Fi%page%](docId\:OAuMOf3wwdbFNBlnqffSy)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y6td4MdXp2hktGeyFxeMS-20260301-161127.png" alt caption width="96" height="88"}[BUSY Bar has at least 40% charge%page%](docId:6gAZ7MkPcoNI4E1ZxxPhk)
To update the BUSY Bar firmware:
:::::WorkflowBlock
:::WorkflowBlockItem
In the web browser on your PC, go to [https://cloud.busy.app](https://cloud.busy.app)
:::
:::WorkflowBlockItem
Log in to your BUSY account with your email address, or continue with Google, Apple, or Microsoft.
:::
::::WorkflowBlockItem
Link your BUSY Bar to your BUSY account if not already linked.
:::ExpandableHeading
*Need help linking to the account? Click here*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
1. In your [BUSY account](https://cloud.busy.app), click **Connect** under the BUSY Bar.
2. On your BUSY Bar, go to **Settings → Account → Get pairing code** — BUSY Bar will display a pairing code.
3. In your BUSY account, enter the code and click **Connect**.
:::
::::
:::WorkflowBlockItem
In the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/DbHg4CQVgik2uueauMn8O-20260305-151603.png" alt caption width="64" height="88"} **Dashboard** tab, click **Update now**, then click **Update** — the update will take **around 3 minutes**.
:::
:::::
## Using BUSY App on your Mac
Before updating the firmware, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} [Your Mac has BUSY App installed%page%](https://busy.app/downloads)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y6td4MdXp2hktGeyFxeMS-20260301-161127.png" alt caption width="96" height="88"}[BUSY Bar has at least 40% charge%page%](docId:6gAZ7MkPcoNI4E1ZxxPhk)
To update the BUSY Bar firmware:
:::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** on your Mac.
:::
:::WorkflowBlockItem
Click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/L-NjbC1JV-oIwGp-9hBnp-20260304-123534.png" alt caption width="176" height="88"} BUSY App in the menu bar, then click **Connect**.
Alternatively, you can click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** icon in the Dock.
:::
:::WorkflowBlockItem
Connect your BUSY Bar to the PC via USB.
:::
::::WorkflowBlockItem
You’ll see a window asking for your permission to connect the BUSY Bar — click **Connect**.
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VMfrpLrpuYMKhr31n5tsa_warning-icon.png" alt caption width="84" height="88"}** ****Important**
Don’t unplug your BUSY Bar while it’s connecting to your Mac!
:::
::::
:::WorkflowBlockItem
Once the BUSY Bar is connected, in the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/EX2BnudHoI4MB7Gb386pR-20260305-152012.png" alt caption width="144" height="88"}** BUSY Bar** tab, click **Update now**.
:::
:::WorkflowBlockItem
In the window that opens, click **Update** — the update will take **around 3 minutes**.
:::
:::::
## From a file using the local web interface
You can download the latest firmware version from the official BUSY Bar firmware repository and update the BUSY Bar firmware via the local web interface.
Before updating the firmware, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y6td4MdXp2hktGeyFxeMS-20260301-161127.png" alt caption width="96" height="88"}[BUSY Bar has at least 40% charge%page%](docId:6gAZ7MkPcoNI4E1ZxxPhk)
**Step 1.**** Download the firmware file**
::::WorkflowBlock
:::WorkflowBlockItem
On your PC, go to the [firmware releases page on GitHub](https://github.com/busy-app/busybar-firmware/releases).
:::
:::WorkflowBlockItem
Find the latest firmware version.
:::
:::WorkflowBlockItem
In the **Assets** section, click the `.tgz` file to download it:
:::
::::
**Step 2.**** Upload the file to install the firmware on your BUSY Bar**
:::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to a PC using a USB cable.
:::
::::WorkflowBlockItem
In the browser, go to [http://10.0.4.20](http://10.0.4.20)
:::ExpandableHeading
*The web interface doesn’t load? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::WorkflowBlockItem
Go to **Firmware** and click **Update from file**.
:::
:::WorkflowBlockItem
Select the `.tgz` file you downloaded, then click **Start update**.
The firmware update will take around 3 minutes.
:::
:::::
[title]
[path] Development/
[title] FAQ
[path] /
:::Iframe{iframeHeight="500" code=""}
:::
Explore frequently asked questions about the BUSY Ecosystem by category. If you’re experiencing issues with your device, app, or connection, visit the[%troubleshooting%](https://docs.busy.app/bar/troubleshooting) page for step-by-step solutions.
***
# BUSY Bar
:::ExpandableHeading
### What is BUSY Bar?
BUSY Bar is a productivity multi-tool with an LED pixel display for custom statuses. It includes a built-in Pomodoro timer, apps, and an open HTTP API for customization and integrations. You can also connect BUSY Bar to Matter-enabled smart home systems to use it in your automations.
Learn more: [%page%](https://busy.app/)
:::
:::ExpandableHeading
### How long does it take to charge the device?
- 2.5 hours — with an 18W (or higher) Power Delivery charger.
- 7–8 hours — with other USB chargers or a USB port.
:::
:::ExpandableHeading
### What do the indicators on the back screen mean?
The status bar on the right side of the back screen shows the current state of your BUSY Bar.
The indicators show:
**Sound**
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Hh0lC1jmyg3AhENg6D4ls_sound-status-icon.png" alt caption width="96" height="96"} — Sound on
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kqGf6HZ1FvjDpl2YgvmMY_muted-status-icon.png" alt caption width="96" height="96"} — Muted
**Wi-Fi connection**
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/EvBUM8PQ8JCEmpS0-Hfhc_wifi-status-icon.png" alt caption width="96" height="96"} — Connected
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/FrI37hDiYjSGnFXDToji5_wifi-connecting-status-icon.png" alt caption width="96" height="96"} — Connecting
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/mZri7ubKv_bJvHlp7iEqA_no-wifi-status-icon.png" alt caption width="96" height="96"} — No connection
**Bluetooth connection**
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VonTWmHF4Z-E2sCr8AnKE_bluetooth-status-icon.png" alt caption width="96" height="96"} — Connected
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/U-IKnExXAryRRNlldGpFJ_bluetooth-connecting-status-icon.png" alt caption width="96" height="96"} — Connecting
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4YjlzqsRrHYx__J8VntH6_no-bluetooth-status-icon.png" alt caption width="96" height="96"} — No connection
**USB connection**
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/_kquy24_TPuBYCDIwbc_L_usb-status-icon.png" alt caption width="96" height="96"} — Connected via USB
**Battery charge**
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/oVMQx1niZG-pQsJ6OZf4w_charge-75-status-icon.png" alt caption width="96" height="96"} — Battery level: 75%
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BrlZ3RJcRnYDkYhqWQ3Az_charging-status-icon.png" alt caption width="96" height="96"} — Charging
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/5Rh6Ru0WoFvU46FLI5MkT_charge-warning-status-icon.png" alt caption width="96" height="96"} — Battery issue. [Contact support%page%](https://support.busy.app/hc/en-us)
:::
::::ExpandableHeading
### How do I clean the BUSY Bar?
Clean only with a well-wrung electronic/screen wipe or a dry microfiber cloth.
Never spray liquid directly onto the device or let moisture enter any openings, including the USB charging port, speaker holes, or button gaps.
:::hint{type="danger"}
******Do not** clean either screen with alcohol or alcohol-based cleaners, tissues, wipes, or sanitizers. Doing so can permanently damage the screens and void your warranty.
:::
::::
:::ExpandableHeading
### Can I take BUSY Bar on an airplane?
Yes. It is recommended to carry the BUSY Bar in your hand luggage, as most airlines require battery-powered devices to be transported in the cabin.
Some airlines may allow the device in checked baggage, but you should confirm their policy in advance.
:::
:::ExpandableHeading
### I want to preserve BUSY Bar’s battery charge
You can completely power off the device and preserve battery charge:
- On the BUSY Bar, go to **Settings → System → Power → Shut Down**.
To turn the BUSY Bar back on, press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 3 seconds.
:::
:::ExpandableHeading
### Can I set up my BUSY Bar via PC?
Yes. You can use [BUSY App](https://busy.app/pages/downloads) or the local web interface, available via USB or Wi-Fi.
Learn more: [Set up via PC%page%](docId\:thP7SpHuQrzbWrGhlOTAO)
:::
:::ExpandableHeading
### Why do statuses still appear when the selector is set to OFF?
That’s expected. OFF puts the BUSY Bar to sleep — it doesn’t shut it down completely. Notifications, focus sessions started in the app, and the ON CALL status still appear.
To shut down your BUSY Bar completely:
- Go to **Settings → System → Power → Shut down**.
To turn it back on:
- Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** button for 3 seconds.
:::
:::ExpandableHeading
### Why does my BUSY Bar status keep getting replaced?
BUSY Bar shows only one activity at a time. When multiple activities are active, the one with the highest priority is shown. Lower-priority activities are hidden until the higher-priority activity ends.
Priority, from highest to lowest:
1. **Focus sessions **started on BUSY Bar, in BUSY App, by a smart home automation, or through the API.
2. **Google Calendar notifications** shown before and during events.
3. **Automatic ON CALL status** triggered when your Mac's microphone is in use.
4. **Smart home graphics** sent by automations that call `/api/draw`.
5. **Draw tool graphics and streams** from API clients.
:::
***
# BUSY Bar firmware
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/jdIqzhfTYOSDh80fNHr8t-20260313-162440.png" size="90" width="2500" height="1568" position="center" darkWidth="2500" darkHeight="1568" showCaption="false"}
:::ExpandableHeading
### What is my current firmware version?
You can check your firmware version directly on the BUSY Bar:
- Go to **Settings → About → Firmware**.
You can also view it in [BUSY App](https://busy.app/pages/downloads) under your device settings or in the **Firmware** tab of the [local web interface](docId\:v_izwbs0I2kIljDxY_Kkp).
:::
:::::ExpandableHeading
### I don’t have access to Wi-Fi. How can I update the BUSY Bar firmware?
**Option 1.**** Update via BUSY App on Mac**
If your Mac is connected to the internet, you can update your BUSY Bar through BUSY App over USB. BUSY App uploads the firmware update file to your BUSY Bar and installs it.
Learn more: [Use desktop BUSY App to update the BUSY Bar firmware%page%](docId\:CtPB9O5UzErW5xMxE3Yuw)
**Option 2.**** Update via the BUSY Bar local web interface**
You can download the latest firmware version from the official BUSY Bar firmware repository and install it through the local web interface.
**Step 1. Download the firmware file**
::::WorkflowBlock
:::WorkflowBlockItem
On your PC, go to the [firmware releases page on GitHub](https://github.com/busy-app/busybar-firmware/releases).
:::
:::WorkflowBlockItem
Find the latest firmware version.
:::
:::WorkflowBlockItem
In the **Assets** section, click the `.tgz` file to download it:
:::
::::
**Step 2. Upload the file and install the firmware**
::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to your PC using a USB cable.
:::
:::WorkflowBlockItem
In the browser, go to [http://10.0.4.20](http://10.0.4.20). If the page doesn’t load:
- Make sure your browser is enabled 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 restart of your BUSY Bar. → Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
:::WorkflowBlockItem
Go to **Firmware** and click **Update from file**.
:::
:::WorkflowBlockItem
Select the `.tgz` file you downloaded, then click **Start update**.
The update takes about 3 minutes.
:::
::::
:::::
:::ExpandableHeading
### How do I know if new firmware is available?
You can check for updates directly on the BUSY Bar:
- Go to **Settings → Firmware → Check for updates.**
You can also check for updates and update your BUSY Bar using [BUSY App](https://busy.app/pages/downloads), the [local web interface](docId\:v_izwbs0I2kIljDxY_Kkp), or BUSY account (available at [cloud.busy.app](https://cloud.busy.app)). If an update is available, you will see a green notification.
:::
:::::ExpandableHeading
### How to downgrade the BUSY Bar firmware?
BUSY Bar has no dedicated downgrade option, but you can install any previously released firmware version manually: download the firmware file, then upload it to your device via the web interface.
**Step 1.**** Download the firmware file**
::::WorkflowBlock
:::WorkflowBlockItem
On your PC, go to the [firmware releases page on GitHub](https://github.com/busy-app/busybar-firmware/releases).
:::
:::WorkflowBlockItem
Find the version you want to install.
:::
:::WorkflowBlockItem
In the **Assets** section, click the `.tgz` file to download it:
:::
::::
**Step 2.**** Upload the file to install the firmware on your BUSY Bar**
::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to your PC using a USB cable.
:::
:::WorkflowBlockItem
In the browser, go to [http://10.0.4.20](http://10.0.4.20). If the page doesn’t load:
- Make sure your browser is enabled 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 restart of your BUSY Bar. → Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
:::WorkflowBlockItem
Go to **Firmware** and click **Update from file**.
:::
:::WorkflowBlockItem
Select the `.tgz` file you downloaded, then click **Start update**.
The firmware update takes about 3 minutes.
:::
::::
**Step 3.**** Disable automatic firmware updates**
::::WorkflowBlock
:::WorkflowBlockItem
On your BUSY Bar, go to **Settings → Firmware → Settings**.
:::
:::WorkflowBlockItem
Set **Auto-update** to **Off**.
:::
::::
:::::
:::::ExpandableHeading
### How do I put BUSY Bar into recovery mode (DFU)?
:::hint{type="info"}
Use recovery mode (DFU) **only** for firmware recovery.
:::
::::WorkflowBlock
:::WorkflowBlockItem
Press and hold :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="200" height="150"}** Start / Pause**, :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="200" height="200"}**Back**, and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xlWSbh7j8KDYqS-b2YSDD-20260316-105319.png" alt caption width="200" height="200"}**OK / Skip** buttons for 3 seconds.
:::
:::WorkflowBlockItem
Release :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="200" height="150"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="200" height="200"}**Back** buttons, but keep holding the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xlWSbh7j8KDYqS-b2YSDD-20260316-105319.png" alt caption width="200" height="200"}** OK / Skip** button for an additional 2 seconds.
:::
:::WorkflowBlockItem
Release the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xlWSbh7j8KDYqS-b2YSDD-20260316-105319.png" alt caption width="200" height="200"}** OK / Skip** button.
:::
::::
Once in DFU mode, the BUSY Bar flashes its LEDs yellow three times, then turns them red.
:::Iframe{iframeHeight="500" code=""}
:::
To exit recovery mode:
- Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="200" height="150"}** Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="200" height="200"}**Back** buttons for 3 seconds.
:::::
:::ExpandableHeading
### How do I exit recovery mode (DFU)?
To exit recovery mode:
- Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="200" height="150"}** Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="200" height="200"}**Back** buttons for 3 seconds.
:::
:::ExpandableHeading
### Can I install custom firmware on BUSY Bar?
Yes. You can install custom firmware on BUSY Bar via the [local web interface](docId\:v_izwbs0I2kIljDxY_Kkp).
The firmware sources are available in the [official firmware repository](https://github.com/busy-app/busybar-firmware). You can modify the code, build your own firmware, and flash it to your BUSY Bar.
:::
***
# BUSY App
:::ExpandableHeading
### What is BUSY App?
BUSY App is a free focus timer for your phone, watch, and Mac. Set up a Pomodoro-style workflow or run a session with no time limit, block distracting apps and notifications, choose what BUSY Bar shows during a session, and play music in work and rest phases.
Learn more: [BUSY App%page%](docId\:t7klHajsRwOhzOxjk9OJ6)
:::
:::ExpandableHeading
### Do I need BUSY Bar to use BUSY App?
No. BUSY App works on its own as a focus timer on your phone, watch, and Mac. Log in to your [BUSY account](docId\:GTTBlGHrq0OJUa6qy6MWz) on each device to sync timers and sessions between them. If you have a BUSY Bar, it joins the same sync — start a session on your BUSY Bar and control it from any app.
:::
::::::ExpandableHeading
### Which platforms does the BUSY App support?
BUSY App is available on iOS and Android, including support for Apple Watch and Wear OS smartwatches.
On computers, BUSY App is [available for macOS](https://apps.apple.com/gb/app/busy-advanced-focus-timer/id6738797176?platform=mac). A Windows app is coming soon.
:::::VerticalSplit{layout="middle"}
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
*Click here for QR code* :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-kWE2mBrqr6Mn1HivQah-b-20250826-103310.png" size="50" width="500" height="500" darkWidth="500" darkHeight="500" position="center" showCaption="false"}
:::
::::
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
*Click here for QR code*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-YsO7Y3XKK99YQ5yhtpkSC-20250826-103326.png" size="50" width="500" height="500" darkWidth="500" darkHeight="500" position="center" showCaption="false"}
:::
::::
:::::
::::::
:::ExpandableHeading
### Is there a dedicated app for Windows?
Not yet. The Windows version is coming soon.
:::
:::::::ExpandableHeading
### How many BUSY Bars can I connect to BUSY App?
You can connect any number of BUSY Bars by linking them to your [BUSY account](docId\:GTTBlGHrq0OJUa6qy6MWz).
::::::Tabs
:::Tab{title="Mobile BUSY App"}
Follow the steps on the [Pair with your phone](docId\:Dn-wX8LbZf8DpafRKu7a2) page.
:::
:::::Tab{title="Desktop BUSY App"}
::::WorkflowBlock
:::WorkflowBlockItem
[Connect your first BUSY Bar with the desktop BUSY App.](docId\:GTTBlGHrq0OJUa6qy6MWz)
:::
:::WorkflowBlockItem
Disconnect the USB cable from your first BUSY Bar.
:::
:::WorkflowBlockItem
Click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** icon in the Dock.
:::
:::WorkflowBlockItem
Go to the **BUSY Bar tab**.
:::
:::WorkflowBlockItem
Click **your BUSY Bar’s name**, then click **Add device**.
:::
:::WorkflowBlockItem
Connect the second BUSY Bar to your Mac via USB.
:::
:::WorkflowBlockItem
Connect the second BUSY Bar to Wi-Fi.
:::
:::WorkflowBlockItem
Update the second BUSY Bar’s firmware.
:::
::::
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****Your BUSY Bars are ready to use!**
Repeat steps 2–8 for each additional BUSY Bar.
:::
:::::
:::::Tab{title="BUSY account"}
::::WorkflowBlock
:::WorkflowBlockItem
[Connect your first BUSY Bar.](docId\:GTTBlGHrq0OJUa6qy6MWz)
:::
:::WorkflowBlockItem
In your BUSY account, click **your BUSY Bar’s name **in the lower-left corner, then click **Connect another device**.
:::
:::WorkflowBlockItem
On your second BUSY Bar, go to **Settings → Account → Get pairing code**. BUSY Bar displays a pairing code.
:::
:::WorkflowBlockItem
In your BUSY account, enter the code, then click **Connect**.
:::
::::
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****Your BUSY Bars are ready to use!**
Repeat steps 2–4 for each additional BUSY Bar.
:::
:::::
::::::
:::::::
:::ExpandableHeading
### Can I block apps and notifications on my Mac?
This feature is coming soon.
:::
:::ExpandableHeading
### I don’t want to see an icon in my Mac Dock. Can I remove it?
Yes. You can remove it by going to **Preferences → Show in Dock** and turning it off.
:::
***
# BUSY account
:::ExpandableHeading
### What is BUSY account?
BUSY account is the cloud service that keeps the entire BUSY ecosystem in sync, including BUSY App on mobile and desktop, and the BUSY Bar device.
It keeps your focus sessions, timers, and integrations synced across all your devices, enables secure remote access to your BUSY Bar over the internet, and manages API access for connected services and automations.
To use these cloud features, create an account and sign in to BUSY App on your mobile and desktop devices, as well as your BUSY Bar.
Learn more: [BUSY account%page%](docId\:GTTBlGHrq0OJUa6qy6MWz)
:::
:::::ExpandableHeading
### How to create a BUSY account?
You can create an account in BUSY App on mobile and desktop, or in your web browser.
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/nk9T8iJ680jfUZPTWKQcF_phone-dark.png" alt caption width="56" height="96"} **Mobile BUSY App**
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} [BUSY App](https://busy.app/pages/downloads) on your phone.
:::
:::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Log in** in the top-left corner. The browser will open the sign-in page.
:::
:::WorkflowBlockItem
Continue with your Google, Apple, or Microsoft account.
*or*
Create your account using your email.
:::
::::
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/6MbcBA4hBEeYXmpjk86-h_web-dark.png" alt caption width="72" height="96"} **Web browser (any platform)**
::::WorkflowBlock
:::WorkflowBlockItem
Open [cloud.busy.app](https://cloud.busy.app) in your browser.
:::
:::WorkflowBlockItem
Continue with your Google, Apple, or Microsoft account.
*or*
Create your account using your email.
:::
::::
****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/O9ayv-GqUis9aQj5aiUdR_pc-dark.png" alt caption width="88" height="96"} **Desktop BUSY App (Mac only)**
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} [BUSY App](https://busy.app/pages/downloads) on your computer.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Log in** in the top-left corner. The browser will open the sign-in page.
:::
:::WorkflowBlockItem
Continue with your Google, Apple, or Microsoft account.
*or*
Create your account using your email.
:::
::::
Having trouble logging in or creating an account? Please see [BUSY account issues%page%](docId:_XRVFEvMFz0_TJLLA9wxo)
:::::
:::::::ExpandableHeading
### How many BUSY Bars can I connect to my BUSY account?
You can connect any number of BUSY Bars to your BUSY account. All connected devices will stay in sync.
::::::Tabs
:::Tab{title="Mobile BUSY App"}
Follow the steps on the [Pair with your phone](docId\:Dn-wX8LbZf8DpafRKu7a2) page.
:::
:::::Tab{title="Desktop BUSY App"}
::::WorkflowBlock
:::WorkflowBlockItem
[Connect your first BUSY Bar with the desktop BUSY App.](docId\:GTTBlGHrq0OJUa6qy6MWz)
:::
:::WorkflowBlockItem
Disconnect the USB cable from your first BUSY Bar.
:::
:::WorkflowBlockItem
Click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** icon in the Dock.
:::
:::WorkflowBlockItem
Go to the **BUSY Bar tab**.
:::
:::WorkflowBlockItem
Click **your BUSY Bar’s name**, then click **Add device**.
:::
:::WorkflowBlockItem
Connect the second BUSY Bar to your Mac via USB.
:::
:::WorkflowBlockItem
Connect the second BUSY Bar to Wi-Fi.
:::
:::WorkflowBlockItem
Update the second BUSY Bar’s firmware.
:::
::::
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****Your BUSY Bars are ready to use!**
Repeat steps 2–8 for each additional BUSY Bar.
:::
:::::
:::::Tab{title="BUSY account"}
::::WorkflowBlock
:::WorkflowBlockItem
[Connect your first BUSY Bar.](docId\:GTTBlGHrq0OJUa6qy6MWz)
:::
:::WorkflowBlockItem
In your BUSY account, click **your BUSY Bar’s name **in the lower-left corner, then click **Connect another device**.
:::
:::WorkflowBlockItem
On your second BUSY Bar, go to **Settings → Account → Get pairing code**. BUSY Bar displays a pairing code.
:::
:::WorkflowBlockItem
In your BUSY account, enter the code, then click **Connect**.
:::
::::
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****Your BUSY Bars are ready to use!**
Repeat steps 2–4 for all other BUSY Bars.
:::
:::::
::::::
:::::::
:::::ExpandableHeading
### How to delete my BUSY account?
:::hint{type="danger"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/qnjdr5-ckAAHFovFCIo6c_danger-icon.png" alt caption width="76" height="88"}** **
Your account and all your user data will be permanently deleted from our servers.
:::
You can delete your account in BUSY App (mobile or desktop) or at [cloud.busy.app](https://cloud.busy.app/)
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/nk9T8iJ680jfUZPTWKQcF_phone-dark.png" alt caption width="56" height="96"} **Mobile BUSY App**
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** on your phone.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** in the top-left corner.
:::
:::WorkflowBlockItem
Tap **Delete account**.
:::
:::WorkflowBlockItem
In the pop-up, tap **Delete** to confirm.
:::
::::
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/6MbcBA4hBEeYXmpjk86-h_web-dark.png" alt caption width="72" height="96"} **Web browser (any platform)**
::::WorkflowBlock
:::WorkflowBlockItem
In your browser, go to [cloud.busy.app](https://cloud.busy.app/)
:::
:::WorkflowBlockItem
Log in to your BUSY account.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** in the top-right corner.
:::
:::WorkflowBlockItem
Go to **Account**.
:::
:::WorkflowBlockItem
Click **Delete account**.
:::
:::WorkflowBlockItem
In the pop-up, click **Delete** to confirm.
:::
::::
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/O9ayv-GqUis9aQj5aiUdR_pc-dark.png" alt caption width="88" height="96"} **Desktop BUSY App (Mac only)**
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} [BUSY App](https://busy.app/pages/downloads) on your computer.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** in the top-left corner.
:::
:::WorkflowBlockItem
Click **Delete account**.
:::
:::WorkflowBlockItem
In the pop-up, click **Delete** to confirm.
:::
::::
:::::
***
# Local web interface
:::ExpandableHeading
### What is the BUSY local web interface?
The local web interface is a control panel for your BUSY Bar that‘s built right into the device. It allows you to remotely control and update your BUSY Bar, create custom statuses, enable HTTP API access, and view the HTTP API reference.
Open it in any web browser using Wi-Fi (LAN) or USB Ethernet (virtual LAN).
Learn more: [Local web interface%page%](docId\:v_izwbs0I2kIljDxY_Kkp)
:::
:::ExpandableHeading
### Can I connect to the local web interface over Wi-Fi?
Yes. Follow the steps described on the [Local web interface](docId\:v_izwbs0I2kIljDxY_Kkp) page.
:::
:::::ExpandableHeading
### How do I switch the web interface to a light or dark theme?
To change the web interface theme:
::::WorkflowBlock
:::WorkflowBlockItem
Сlick the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/h5eC0x6koN8kFrAcGx1YE-20260302-172803.png" alt caption width="60" height="88"} **Account** icon in the top-right corner.
:::
:::WorkflowBlockItem
Click **Switch to light theme** (or **Switch to dark theme**).
:::
::::
:::::
:::::ExpandableHeading
### Can I restrict access to my BUSY Bar local web interface when connecting over Wi-Fi?
Yes, you can protect it with a password, and we recommend doing so. The password will be required when connecting over Wi-Fi, but not when connecting via USB.
To set a password for web interface access:
::::WorkflowBlock
:::WorkflowBlockItem
Сlick the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/h5eC0x6koN8kFrAcGx1YE-20260302-172803.png" alt caption width="60" height="88"} **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.
:::
:::::
:::::ExpandableHeading
### Can I change the IP address of the web interface?
Yes. BUSY Bar's local web interface is available at `10.0.4.20` when the device is connected over USB. If that address conflicts with your network, change it by editing the `settings.json` file on your BUSY Bar.
::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to a PC using a USB cable.
:::
:::WorkflowBlockItem
In your browser, go to [10.0.4.20/?path=/ext/apps\_data/usb\_srv](http://10.0.4.20/?path=/ext/apps_data/usb_srv)
:::
:::WorkflowBlockItem
Right-click `settings.json`, then click **Download file**.
:::
:::WorkflowBlockItem
Open the downloaded file in a text editor, set the `address` field to the new IP address, and save it.
:::
:::WorkflowBlockItem
Go back to [10.0.4.20/?path=/ext/apps\_data/usb\_srv](http://10.0.4.20/?path=/ext/apps_data/usb_srv)
:::
:::WorkflowBlockItem
Delete the old `settings.json` file.
:::
:::WorkflowBlockItem
Drag and drop the edited file into the browser window, then click **Upload**.
:::
:::WorkflowBlockItem
Restart your BUSY Bar by pressing and holding the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** buttons for 3 seconds.
:::
:::WorkflowBlockItem
In your browser, go to `http://`. The web interface should load at the new address.
:::
::::
:::::
***
# Smart home integration
:::ExpandableHeading
### Which smart home systems are BUSY Bar compatible with?
BUSY is Matter-certified and works with major smart home platforms, including Apple HomeKit, Google Home, Amazon Alexa, Samsung SmartThings, and Home Assistant.
Learn more: [Compatible Matter Hub%page%](docId\:JpGMyYSUQyzddmcA_C6oI)
:::
:::ExpandableHeading
### Can I connect a BUSY Bar to multiple smart home systems at the same time?
Yes. Learn more: [Connect to smart home%page%](docId\:o-O1V6N63_pisLlcQJbJN)
:::
:::::ExpandableHeading
### How to disconnect the BUSY Bar from one particular Smart Home system?
You can do it right via your smart home app. General steps for most smart home systems:
::::WorkflowBlock
:::WorkflowBlockItem
Open your smart home app (the one you used to set up the device).
:::
:::WorkflowBlockItem
Go to **Devices** or **Home**.
:::
:::WorkflowBlockItem
Select the BUSY Bar you want to remove.
:::
:::WorkflowBlockItem
Look for **Settings (⚙️)** or **Device Info**.
:::
:::WorkflowBlockItem
Tap **Remove device / Delete / Unpair**.
:::
:::WorkflowBlockItem
Confirm removal.
:::
::::
You cannot disconnect the BUSY Bar from a single smart home system directly on the device itself. You can only remove all existing pairings at once.
Learn more: [Connect to smart home%page%](docId\:o-O1V6N63_pisLlcQJbJN)
:::::
***
# Wall mount
:::ExpandableHeading
### I lost the screws. What size should I buy?
You‘ll need:
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xNGlfY0Zb1wr8wdNAswho-20260615-181118.png" alt caption width="96" height="96"}** For wooden wall:**
- *2× wall screws:* 3×18–35 mm self-tapping, with a pan head
- *1× locking screw: *ST1.7 × 8 mm self-tapping, with a pan head
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4a3-pR1rVN5EUOjj68OFd-20260615-181119.png" alt caption width="96" height="96"}** For brick or concrete wall: **
- *2× wall screws:* 3×18 mm self-tapping, with a pan head
- *2× wall plugs: *4×20 mm, plastic
- *1× locking screw: *ST1.7 × 8 mm self-tapping, with a pan head
:::
::::::ExpandableHeading
### Can I replace the double-sided tape on the mount?
Yes. You can replace the double-sided tape.
:::::WorkflowBlock
::::WorkflowBlockItem
**Get a double-sided tape.**
:::hint{type="info"}
We recommend Premium Crown 513 Double-Sided Tape or similar.
:::
::::
:::WorkflowBlockItem
**Cut out two pads**, each 33×28 mm (1.3×1.1 in).
:::
:::WorkflowBlockItem
**Clean the back of the wall mount **with rubbing alcohol, then let it dry.
:::
:::WorkflowBlockItem
**Peel off the backing paper** from one side of each double-sided tape pad.
:::
:::WorkflowBlockItem
**Apply the double-sided tape pads** to the back of the wall mount as shown below, then press them firmly.
:::
:::::
::::::
***
# Development
:::ExpandableHeading
### What can I develop for BUSY Bar?
You can create your own BUSY Bar widgets using our open HTTP API, turning the device into a programmable display showing real-time data. The BUSY SDK and support for executable apps are coming soon.
:::
:::ExpandableHeading
### Where can I find the development documentation?
Visit the [Development](docId:5888c5ifDhiyBrJztwJt7) section to explore the API documentation, libraries, and developer guides. We hope you have fun building with BUSY Bar.
We‘re continuously expanding the platform with new capabilities. Support for executable apps is coming soon. Stay tuned!
:::
:::ExpandableHeading
### What is the BUSY SDK and when will it be available?
The BUSY SDK will allow developers to build JavaScript applications that run directly on BUSY Bar.
We plan to release it later this year. Stay tuned!
:::
***
# Recycling
:::::ExpandableHeading
### How to remove the battery before disposing of BUSY Bar
Local regulations may require you to remove the battery before disposing of electronic devices. Follow the steps below to safely remove the battery from your BUSY Bar.
**Step 1.**** Remove the back cover**
Start disassembly by removing the glossy black cover from the back of the device, which covers the back display:
::::WorkflowBlock
:::WorkflowBlockItem
Use a plastic card to release one of the clips near the center at the bottom of the back cover.
:::
:::WorkflowBlockItem
Gently release the remaining clips until the back cover comes off completely. The back cover is held in place by **8 clips**.
:::
::::
**Step 2.**** Remove the screws**
Use a PH1 screwdriver to remove the 5 screws:
::::WorkflowBlock
:::WorkflowBlockItem
4 screws on the back of the device.
:::
:::WorkflowBlockItem
1 screw on the bottom of the device.
:::
::::
**Step 3.**** Remove the front display unit**
:::hint{type="danger"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/qnjdr5-ckAAHFovFCIo6c_danger-icon.png" alt caption width="76" height="88"}** ****Important**
Do not pull the display unit too far out of the housing, as this may damage the display cable or connectors.
Do not disconnect the display cable. The battery must be disconnected first.
:::
::::WorkflowBlock
:::WorkflowBlockItem
Use a plastic card to release the 2 latches on top of the front display.
:::
:::WorkflowBlockItem
Gently pull the front display unit out toward the right.
:::
::::
**Step 4.**** Remove the battery**
::::WorkflowBlock
:::WorkflowBlockItem
Gently move the battery to the left so you can access the connector.
:::
:::WorkflowBlockItem
Use tweezers or your fingertip to press the connector latch.
:::
:::WorkflowBlockItem
Pull the battery connector to disconnect it from the PCB.
:::
::::
:::::
[title] Controls
[path] Basics/
BUSY Bar features simple controls with physical buttons and switches, so you can manage your focus sessions and settings directly from the device — no PC or mobile app needed.
On this page, you’ll learn about the BUSY Bar controls:
- [Controls overview%section%](docId\:PNs-Hr2fjqIK_S7bfVl6N)
- [Selecting modes%section%](docId\:PNs-Hr2fjqIK_S7bfVl6N)
- [Controls during a focus session%section%](docId\:PNs-Hr2fjqIK_S7bfVl6N)
- [Hotkeys%section%](docId\:PNs-Hr2fjqIK_S7bfVl6N)
***
# Controls overview
BUSY Bar controls:
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ZjM_I6D2HlStS7r9sH_9V-20260316-102821.png" alt caption width="140" height="110"}** Start / Pause button** — Start or pause modes, also OK
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wi7xMxRuIxCMAmRWzm-iW-20260316-102821.png" alt caption width="110" height="110"}** Mode selector** — Select modes, open apps, or access settings
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7YKaSwNYj7BVY8cjYPl-C-20260316-102822.png" alt caption width="110" height="110"}** Scroll wheel** — Navigate menus, also OK / Skip
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kOjxN6IQrspQMDuqFdM9u-20260316-102821.png" alt caption width="110" height="112"}** Back button** — Go back or exit apps
***
# Selecting modes
Use the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kBlpLStuBhGmON3SCi0uz-20260316-105319.png" alt caption width="96" height="96"} mode selector to switch between:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="236" height="88"} — Main focus mode, by default set to BUSY interval timer
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-i3AtQ2KI77_AOwtJ6Bbp-20260313-124654.png" alt="CUSTOM" caption width="135" height="72"} — Second focus mode, by default set to custom status
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wiHRzvPaojWcu051ktoay-20260313-124710.png" alt caption width="63" height="72"} — Sleep mode with both screens off
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Zm41xV8tAoecw1NxD19Ju-20260313-124723.png" alt caption width="138" height="72"} — Clock and user-added apps (coming soon)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VOcioMEZ3F7MGgkv0lHTq-20260313-124812.png" alt caption width="210" height="72"} — Wi-Fi, Bluetooth, brightness, sound, firmware update, and more
***
# Controls during a focus session
When you have an active focus session, here’s how the controls work:
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ZjM_I6D2HlStS7r9sH_9V-20260316-102821.png" alt caption width="140" height="110"}** Start / Pause button** — Pause your focus session.
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7YKaSwNYj7BVY8cjYPl-C-20260316-102822.png" alt caption width="110" height="110"}** Scroll wheel** — Rotate to adjust time, or press to skip the current phase.
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wi7xMxRuIxCMAmRWzm-iW-20260316-102821.png" alt caption width="110" height="110"}** Mode selector** — Move to immediately end your session.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kOjxN6IQrspQMDuqFdM9u-20260316-102821.png" alt caption width="110" height="110"}** Back button **— Immediately end your session.
***
# Hotkeys
BUSY Bar has hotkeys to power it on, restart it, and enter recovery mode.
## Power on
To power on your BUSY Bar for the first time or after a complete shutdown:
- Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back **button for 3 seconds.
***
## Normal restart
This restart helps if the BUSY Bar freezes and doesn’t respond to button presses:
- Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** buttons for 3 seconds.
:::Iframe{iframeHeight="500" code=""}
:::
***
## Hard restart
This type of restart resets the power circuit of your BUSY Bar. **Your settings and data remain unchanged.** A hard restart may help if a normal restart doesn’t resolve the issue:
- Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::Iframe{iframeHeight="500" code=""}
:::
***
## Recovery mode (DFU)
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****Use recovery mode only if your BUSY Bar is unresponsive**
If your BUSY Bar doesn't turn on or respond to button presses, switch it to recovery mode as described below, then restore the firmware using the [BUSY Bar recovery tool](https://recovery.busy.app/).
:::
To switch your BUSY Bar to recovery mode:
::::WorkflowBlock
:::WorkflowBlockItem
Press and hold :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="200" height="150"}** Start / Pause**, :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="200" height="200"}**Back**, and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xlWSbh7j8KDYqS-b2YSDD-20260316-105319.png" alt caption width="200" height="200"}**OK / Skip** buttons for 3 seconds.
:::
:::WorkflowBlockItem
Release :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="200" height="150"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="200" height="200"}**Back** buttons, but keep holding the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xlWSbh7j8KDYqS-b2YSDD-20260316-105319.png" alt caption width="200" height="200"}** OK / Skip** button for an additional 2 seconds.
:::
:::WorkflowBlockItem
Release the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xlWSbh7j8KDYqS-b2YSDD-20260316-105319.png" alt caption width="200" height="200"}** OK / Skip** button.
:::
::::
Once in DFU mode, the BUSY Bar flashes its LEDs yellow three times, then turns them red.
:::Iframe{iframeHeight="500" code=""}
:::
To exit recovery mode:
- Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="200" height="150"}** Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="200" height="200"}**Back** buttons for 3 seconds.
[title] Mobile BUSY App issues
[path] Troubleshooting/
Find troubleshooting steps for the mobile BUSY App below.
***
:::ExpandableHeading
### Can’t see BUSY Bar in Bluetooth settings
Try these steps until the issue is resolved:
- Make sure Bluetooth is enabled on your phone.
- Enable pairing mode on your BUSY Bar by going to **Settings → Bluetooth**.
- Keep your phone and BUSY Bar within 1–2 meters (3–6 ft) for a stable connection.
- Unpair the BUSY Bar from other devices. On your BUSY Bar, go to **Settings → Bluetooth** and forget the paired device.
- [Update your BUSY Bar to the latest firmware version.](docId\:CtPB9O5UzErW5xMxE3Yuw)
- Update the BUSY App to the latest version.
- Restart your BUSY Bar by holding the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
:::
:::ExpandableHeading
### Sync between devices doesn’t work
Try these steps until the issue is resolved:
- Check the internet connection on the synced devices.
- Make sure that the BUSY Bar is connected to your BUSY account and you're logged in to the account on all devices. See [BUSY account](docId\:GTTBlGHrq0OJUa6qy6MWz).
:::
[title] BUSY Bar issues
[path] Troubleshooting/
Find troubleshooting steps for your BUSY Bar below.
***
:::::ExpandableHeading
### Glue residue on the screen after removing the protective film
::Iframely{originalUrl="https://youtu.be/5YRnZ20yofI" embedUrl="https://youtu.be/5YRnZ20yofI" title="How to Safely Remove Protective Film Residue from Your BUSY Bar Screen" html=""}
A small number of BUSY Bars from the first batch may have glue residue left on the front screen after you peel off the protective film. Follow the steps below to clean the screen.
:::hint{type="danger"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/qnjdr5-ckAAHFovFCIo6c_danger-icon.png" alt caption width="76" height="88"}** ****Do not use force — this may scratch the screen**
The glue residue is hard to remove with ordinary cleaning solutions. Use only the recommended cleaner. Wiping with force or using an abrasive cloth may leave permanent scratches.
:::
**What you’ll need:**
- Microfiber cloth
- 70% isopropyl alcohol pads (available at any pharmacy)
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ZM45sT6e1ECjiX93v0XC8_glue-removers.png" size="90" isUploading="false" position="center" width="1455" height="546" darkWidth="1455" darkHeight="546" showCaption="false"}
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VMfrpLrpuYMKhr31n5tsa_warning-icon.png" alt caption width="84" height="88"}** ****Do not use******
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/NWcikktBkbbAM7iIaGvh__nail-polish-remover.png" alt caption width="45" height="47"} **Any other cleaner:** may contain substances that can damage the screen, such as acetone in nail polish remover.
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/0DTWpk4VEHFPoc3Nrd7Td_abrasive-cloths-1.png" alt caption width="47" height="47"} **Rough cloth:** may scratch the screen.
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/XmYC_b1foA6FR8-jV_8C__towel-paper-new.png" alt caption width="45" height="47"} **Paper towels or wet wipes:** may have fibers that can scratch the screen.
:::
**How to remove the residue**
::::WorkflowBlock
:::WorkflowBlockItem
Switch off your BUSY Bar and place it on a clean, debris-free surface.
:::
:::WorkflowBlockItem
Open an alcohol pad and lay it flat on the affected area of the screen.
:::
:::WorkflowBlockItem
Let the pad rest on the screen for a few seconds — this softens the glue.
:::
:::WorkflowBlockItem
Gently move the pad across the screen until all traces of the glue are removed. Do not scrub or press hard.
:::
:::WorkflowBlockItem
Take a clean microfiber cloth and gently wipe off any remaining alcohol. **Avoid wiping with force** as it may cause permanent damage to the screen.
:::
::::
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VMfrpLrpuYMKhr31n5tsa_warning-icon.png" alt caption width="84" height="88"}** ****Only use alcohol to remove glue residue**
For regular cleaning, use an alcohol-free screen cleaner. Repeated exposure to alcohol can damage the screen.
:::
:::::
:::ExpandableHeading
### Statuses appear when the selector is in the OFF position
This is expected behavior. OFF mode puts the BUSY Bar to sleep, not a full shutdown. Notifications, focus session started in the app, and the ON CALL status will still show.
To shut down your BUSY Bar completely, go to **Settings → System → Power → Shut down**. To power it back on, press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** button for 3 seconds.
:::
:::ExpandableHeading
### BUSY Bar won’t power on
If your BUSY Bar won’t power on, try these steps:
- Try charging your BUSY Bar for longer — at least 1 hour.
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
- Do a hard restart: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** button for 20 seconds.
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::ExpandableHeading
### BUSY Bar is frozen
If your BUSY Bar freezes and doesn’t respond to button presses, try these steps:
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
- Do a hard restart: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
- Repair the firmware: If the problem persists, the BUSY Bar firmware might be corrupted. Go to the [BUSY Bar Recovery page](https://recovery.busy.app/) and follow the instructions.
:::
:::ExpandableHeading
### BUSY Bar won’t charge
If your BUSY Bar won’t charge, try these steps:
- Try a different cable or power source.
- Restart your BUSY Bar: If it’s turned on, press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::ExpandableHeading
### BUSY Bar won’t connect to Wi-Fi
If your BUSY Bar won’t connect to Wi-Fi, try these steps:
- Move your BUSY Bar closer to your Wi-Fi router.
- Check your Wi-Fi band: BUSY Bar only supports 2.4 GHz Wi-Fi. Check your router settings and make sure the 2.4 GHz band is enabled.
- Restart your Wi-Fi router.
- Try another connection method: See [Connect to Wi-Fi](docId\:OAuMOf3wwdbFNBlnqffSy).
- Connect to a hidden network manually: [Enter the Wi-Fi name and password manually](https://docs.busy.app/bar/basics/connect-wifi#connect-to-a-hidden-wi-fi-network-using-your-phone).
- [Update your BUSY Bar firmware via PC](docId\:CtPB9O5UzErW5xMxE3Yuw).
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::ExpandableHeading
### Battery drains quickly
BUSY Bar has a battery life of **up to 8 hours** on a full charge. The battery continues to drain even when the mode selector is set to **OFF**.
If you notice significantly shorter battery life, try these steps:
- [Update your BUSY Bar to the latest firmware version.](docId\:CtPB9O5UzErW5xMxE3Yuw)
- Reduce the screen brightness: On your BUSY Bar, go to **Settings → Brightness**, set **Mode** to **Manual**, and set the brightness level.
- Shut down your BUSY Bar completely: To preserve the battery when you won’t use your BUSY Bar for an extended period, go to **Settings -> System -> Power -> Shut down**.
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::ExpandableHeading
### BUSY Bar fails to update firmware
If your BUSY Bar fails to update its firmware, try these steps:
- Make sure your BUSY Bar is connected to Wi-Fi: On your BUSY Bar, go to **Settings -> Wi-Fi**. See [Connect to Wi-Fi](docId\:OAuMOf3wwdbFNBlnqffSy) for instructions.
- Restart your BUSY Bar: Hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
- Make sure your BUSY Bar is [charged to at least 40%](docId:6gAZ7MkPcoNI4E1ZxxPhk).
- Try a different update method: Update using BUSY App or the local web interface. See [Firmware update](docId\:CtPB9O5UzErW5xMxE3Yuw).
- Try again later: The update server may be temporarily unavailable.
- Check the firmware file format: If you are updating from a firmware file, make sure it’s in the `.tgz` format.
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::ExpandableHeading
### Time zone setup is incorrect
You can set time manually on your BUSY Bar: **Settings → Time → Time Zone**.
BUSY Bar sets its time zone automatically based on the device you use to connect to it. This happens when you:
- Pair your BUSY Bar with BUSY App on your phone or desktop.
- Connect to the local web interface in a web browser.
:::
:::ExpandableHeading
### Firmware doesn’t update automatically overnight
If your BUSY Bar didn’t update its firmware overnight, check the following:
- Check the Wi-Fi connection: On your BUSY Bar, go to **Settings → Wi-Fi**.
- Make sure Auto-update is enabled: On your BUSY Bar, go to **Settings → Firmware → Settings → Auto-update **and set it to **On**.
:::
::::ExpandableHeading
### Google Calendar integration isn’t working
If Google Calendar events aren’t showing on your BUSY Bar, try these steps:
- Check the Wi-Fi connection: On your BUSY Bar, go to **Settings → Wi-Fi**.
- [Make sure your BUSY Bar is connected to your BUSY account.](docId\:GTTBlGHrq0OJUa6qy6MWz)
- Check the Google Calendar integration: In your [BUSY account](https://cloud.busy.app), open the **Integration tab** and make sure the Google Calendar integration is active. See [Google Calendar integration](docId\:BLGy7-zUp3bo9IXaMhGea) for setup instructions.
:::hint{type="info"}
Note that the calendar integration doesn’t show 24-hour events, and events are not shown during an active focus session on your BUSY Bar.
:::
::::
:::ExpandableHeading
### BUSY Bar won’t connect to a computer via USB
If your computer doesn’t detect your BUSY Bar over USB, try these steps:
- Try a different USB port on your computer.
- Try a different USB cable: Make sure the cable supports data transfer, not just charging.
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
- [Update your BUSY Bar to the latest firmware version.](docId\:CtPB9O5UzErW5xMxE3Yuw)
- Make sure you grant system permissions when connecting your BUSY Bar.
- Allow your browser to find devices on local networks: See 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/).
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::ExpandableHeading
### BUSY Bar is unresponsive after deleting system files
You can recover your BUSY Bar by reinstalling its firmware. This restores the system files needed for BUSY Bar to work.
To recover your BUSY Bar:
- Go to the [BUSY Bar Recovery page](https://recovery.busy.app/) and follow the instructions.
:::
[title] Local web interface
[path] /
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, 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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::::
::::::
::::::ExpandableHeading
### :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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
Using the local web interface (USB)
1. Access the local web interface via USB.
2. In the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/tSWHP9lg3XARAZOc8ZNOi_network.png" alt caption width="68" height="96"}** Network** tab, copy the IP address.
:::
:::ExpandableHeading
Directly on BUSY Bar
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 any and click **Unlock**.
:::ExpandableHeading
*The web interface doesn’t load? Click here for help *:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::::
::::::
***
# Overview
The local web interface has four tabs:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/PyPJR1bOsQ8HdmACBubEG_firmware.png" alt caption width="68" height="96"} [Firmware](https://docs.busy.app/bar/local-web-interface#firmware-tab) — View firmware info and update BUSY Bar's firmware
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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's settings, smart home integration, and time zone
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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 the BUSY Bar screen
At the top of each tab, you’ll see the battery level, web interface connection status, your BUSY Bar name, and a live stream of the BUSY Bar screen. In the top-right corner, you can open the account menu to change the web interface theme, secure the web interface with a password, and 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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/PyPJR1bOsQ8HdmACBubEG_firmware.png" alt caption width="68" height="96"} **Firmware** tab, you can view the current firmware version, update your BUSY Bar, and manage automatic overnight updates.
## Update your BUSY Bar firmware via the web interface
Before updating the firmware, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y6td4MdXp2hktGeyFxeMS-20260301-161127.png" alt caption width="96" height="88"} [BUSY Bar’s battery charge is at least 40%](docId:6gAZ7MkPcoNI4E1ZxxPhk) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4ylzwhOioPqiUoIdwqS8H-20260302-104633.png" alt caption width="36" height="88"}
To update the BUSY Bar firmware:
::::WorkflowBlock
:::WorkflowBlockItem
Go to the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/PyPJR1bOsQ8HdmACBubEG_firmware.png" alt caption width="68" height="96"}** Firmware** tab, click **Update**.
:::
:::WorkflowBlockItem
In the window that opens, click **Start update** — the update will take **around 3 minutes**.
:::
::::
***
## Update your 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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/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)
***
# 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.
[title] Draw tool
[path] /
With the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**, you can create custom statuses using a visual editor right in your web browser or BUSY App on your phone. Choose icons from the built-in library or upload your own images, add text, and display your creations on your BUSY Bar with one click.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"} **Coming soon**
You’ll soon be able to use custom statuses as BUSY Bar themes for focus modes.
:::
On this page, you’ll learn how to:
- [Open the Draw tool%section%](docId\:yhy-U_oNsGv2fIiWzatMn)
- [Use the Draw tool interface%section%](docId\:yhy-U_oNsGv2fIiWzatMn)
- [Create a status%section%](docId\:yhy-U_oNsGv2fIiWzatMn)
- [Display your status on BUSY Bar%section%](docId\:yhy-U_oNsGv2fIiWzatMn)
- [Export your statuses%section%](docId\:yhy-U_oNsGv2fIiWzatMn)
- [Import a status%section%](docId\:yhy-U_oNsGv2fIiWzatMn)
- [Delete a status%section%](docId\:yhy-U_oNsGv2fIiWzatMn)
***
# Open the Draw tool
You can open the Draw tool in BUSY App on your phone or in a web browser on your computer.
:::::::Tabs
:::::Tab{title="Mobile BUSY App"}
Before you begin, make sure that:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} [Your phone has BUSY App installed%page%](https://busy.app/downloads)
- :inlineImage[]{src="https://images.archbee.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png?format=webp" alt caption width="68" height="96"} [You’re logged into your BUSY account on your phone and BUSY Bar%page%](docId\:GTTBlGHrq0OJUa6qy6MWz)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4LSmaeQt0ilTZ-j6q0_hw-20260301-161115.png" alt caption width="88" height="88"} [BUSY Bar is connected to Wi-Fi%page%](docId\:OAuMOf3wwdbFNBlnqffSy)
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**.
:::
::::
:::::
::::::Tab{title="Web interface"}
You can access the Draw tool through your BUSY Bar’s local web interface on your computer over USB or Wi-Fi (LAN). An internet connection is not required.
### :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/E6JCd96P1l0K38ah5ZGX3_usb-header.png" alt caption width="96" height="96"} Via USB
:::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to a PC using a USB cable.
:::
::::WorkflowBlockItem
In your browser, go to [http://10.0.4.20](http://10.0.4.20) — BUSY Bar’s local web interface will load automatically.
:::ExpandableHeading
*The web interface doesn’t load? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**.
:::
:::::
### :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/HKFo9DlWwktKDMQxhDYyZ_wifi-header.png" alt caption width="96" height="96"} Via Wi-Fi (LAN)
Before you begin, make sure that:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4LSmaeQt0ilTZ-j6q0_hw-20260301-161115.png" alt caption width="88" height="88"} [BUSY Bar is connected to Wi-Fi%page%](docId\:OAuMOf3wwdbFNBlnqffSy)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/etaxo3HOK_s1BYhrV_2Cx_http-api-logo.png" alt caption width="68" height="96"} [HTTP API access is enabled on your BUSY Bar%page%](docId\:H4whpEXTNlYjSR9PlxsAr)
:::::WorkflowBlock
:::WorkflowBlockItem
Find your BUSY Bar’s IP address.
On your BUSY Bar, go to **Settings → Wi-Fi → \[Wi-Fi network name] → View IP address**. For example: `10.46.21.190`.
:::
::::WorkflowBlockItem
On your PC, open a web browser and enter your BUSY Bar’s IP address. The local web interface will load automatically.
:::ExpandableHeading
*The web interface doesn’t load? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Make sure your PC is connected to the same Wi-Fi network as your BUSY Bar.
- Update your BUSY Bar to the latest firmware. See [Firmware update](docId\:CtPB9O5UzErW5xMxE3Yuw).
- Access the local web interface via USB:
1. Connect BUSY Bar to your PC via USB.
2. In a web browser, go to [http://10.0.4.20](http://10.0.4.20)
:::
::::
:::WorkflowBlockItem
Enter the password for your BUSY Bar’s web interface.
*Forgot your password? *[Learn how to reset it.](https://docs.busy.app/bar/troubleshooting/local-web-interface#forgot-password-when-accessing-the-web-interface-o)
:::
:::WorkflowBlockItem
Go to the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool** tab.
:::
:::::
::::::
:::::::
***
# Draw tool interface
The editor works almost the same in the mobile BUSY App and the web interface. You can create a status and preview it on your BUSY Bar directly from the editor.
::::Tabs
:::Tab{title="Mobile BUSY App"}
In the Draw tool editor, you can:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/C_WjnNJLpdUOJjH6jxEMV_background-logo.png" alt caption width="68" height="96"}** Fill** — Change the background color.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Hkew-gPPjfs08EjzR_uuA_border-logo.png" alt caption width="68" height="96"}** Border** — Add a border.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/G1uLLgAYsWroRZubK4GV0_text-logo.png" alt caption width="68" height="96"} **Text** — Add text in eight different styles.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7B-Bw6hb9C-l_Jz_J_1tb_icons-logo.png" alt caption width="68" height="96"} **Icon** — Add icons from the built-in library.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/_JYh7b9ibRHyuhgidzbjH_image-logo.png" alt caption width="68" height="96"}** Image** — Upload images from your phone.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Gw8y2Lc3-pxIqx4q2FXcV_front-logo.png" alt caption width="68" height="96"} **Front / Back **— Rearrange objects on top of or below others.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/3Bl7Qn6SKQliDXWuORpXH_grid-logo.png" alt caption width="68" height="96"} **Grid** — Show/hide the grid.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ov-fqrPgc-am9kNzy5mB4_play-logo-wide.png" alt caption width="68" height="96"} **Show on BUSY Bar** — Preview your status directly from the editor.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9IEHp6J0ZLsCErj8nuUjy_stop-logo-wide.png" alt caption width="68" height="96"} **Turn status off** — Stop displaying the current custom status.
:::
:::Tab{title="Web interface"}
In the Draw tool editor, you can:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/C_WjnNJLpdUOJjH6jxEMV_background-logo.png" alt caption width="68" height="96"}** Background color** — Change the background color.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Hkew-gPPjfs08EjzR_uuA_border-logo.png" alt caption width="68" height="96"}** Border** — Add a border.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/G1uLLgAYsWroRZubK4GV0_text-logo.png" alt caption width="68" height="96"} **Text** — Add text in eight different styles.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7B-Bw6hb9C-l_Jz_J_1tb_icons-logo.png" alt caption width="68" height="96"} **Icon** — Add icons from the built-in library.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/vbYGDD0rzvnjlCmiWwYxt_image-logo.png" alt caption width="68" height="96"} **Image** — Upload images from your computer.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Gw8y2Lc3-pxIqx4q2FXcV_front-logo.png" alt caption width="68" height="96"} **Move down / Move up **— Rearrange objects on top of or below others.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/3Bl7Qn6SKQliDXWuORpXH_grid-logo.png" alt caption width="68" height="96"} **Show grid / Hide grid** — Show or hide the pixel grid.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xT3dDd-zO2IdfrygKNXzL_clear-logo.png" alt caption width="68" height="96"} **Clear editor** — Remove all objects from the canvas.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ov-fqrPgc-am9kNzy5mB4_play-logo-wide.png" alt caption width="68" height="96"} **Show on BUSY Bar** — Preview your status directly from the editor.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9IEHp6J0ZLsCErj8nuUjy_stop-logo-wide.png" alt caption width="68" height="96"} **Turn status off** — Stop displaying the current custom status.
:::
::::
***
# Create a status
Create a visual status for your BUSY Bar in the Draw tool. Follow the steps for BUSY App or the web interface.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****Saved statuses can’t be edited yet**
After you save a status, you can’t edit it. To make changes, you’ll need to recreate your status. Editing saved statuses is coming soon.
:::
Choose your platform and follow the steps:
:::::::Tabs
::::::Tab{title="Mobile BUSY App"}
:::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**, then tap **Create new**.
:::
:::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/C_WjnNJLpdUOJjH6jxEMV_background-logo.png" alt caption width="68" height="96"}** Fill** to choose a background color.
:::
:::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/G1uLLgAYsWroRZubK4GV0_text-logo.png" alt caption width="68" height="96"} **Text** to add and format text.
:::
:::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7B-Bw6hb9C-l_Jz_J_1tb_icons-logo.png" alt caption width="68" height="96"} **Icon** to add an icon from the library.
You can also tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/vbYGDD0rzvnjlCmiWwYxt_image-logo.png" alt caption width="68" height="96"} **Image** to add an image from your device.
:::
::::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/UCf28Y9ACHoLp8NcnLnu7_play-logo-narrow.png" alt caption width="48" height="96"}** Show on BUSY** to preview your status.
:::hint{type="info"}
The preview doesn't update automatically as you edit your status. To see your latest changes on your BUSY Bar, tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/jJnKv5bRTKnoQXPOXlGc8_play-logo-narrow-blue.png" alt caption width="48" height="96"} **Show on BUSY Bar** again.
:::
::::
:::WorkflowBlockItem
When ready, tap **Save**.
:::
:::::
::::::
::::::Tab{title="Web interface"}
:::::WorkflowBlock
:::WorkflowBlockItem
Connect BUSY Bar to a PC via USB, then open [http://10.0.4.20](http://10.0.4.20) in a browser.
Alternatively, you can [access the web interface via Wi-Fi (LAN)](docId\:v_izwbs0I2kIljDxY_Kkp).
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**, then click **Create**.
:::
:::WorkflowBlockItem
Click ** Background color** to choose a background color.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/G1uLLgAYsWroRZubK4GV0_text-logo.png" alt caption width="68" height="96"} **Text** to add and format text.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7B-Bw6hb9C-l_Jz_J_1tb_icons-logo.png" alt caption width="68" height="96"} **Icon** to add an icon from the library.
You can also click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/vbYGDD0rzvnjlCmiWwYxt_image-logo.png" alt caption width="68" height="96"} **Image** to add an image from your device.
:::
::::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/UCf28Y9ACHoLp8NcnLnu7_play-logo-narrow.png" alt caption width="48" height="96"} **Show on BUSY** to preview your status.
:::hint{type="info"}
The preview doesn't update automatically as you edit your status. To see your latest changes on your BUSY Bar, click **Show on BUSY Bar** again.
:::
::::
:::WorkflowBlockItem
When ready, click **Save**.
:::
:::::
::::::
:::::::
***
# Display your status on BUSY Bar
:::::::Tabs
::::::Tab{title="Mobile BUSY App"}
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**.
:::
:::WorkflowBlockItem
Tap the status you want to display, then tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/UCf28Y9ACHoLp8NcnLnu7_play-logo-narrow.png" alt caption width="48" height="96"}** Show on BUSY Bar**.
:::
::::
:::::ExpandableHeading
*If you have multiple BUSY Bars*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
When multiple BUSY Bar devices are connected to your mobile BUSY App, you need to display a status separately on each device by switching between devices in the app.
**How it works:**
::::WorkflowBlock
:::WorkflowBlockItem
In the BUSY App, go to the **Draw tool**.
:::
:::WorkflowBlockItem
Tap the status you want to display, then tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/UCf28Y9ACHoLp8NcnLnu7_play-logo-narrow.png" alt caption width="48" height="96"} **Show on BUSY Bar**.
:::
:::WorkflowBlockItem
Go back to your BUSY Bar's page and tap your BUSY Bar's name.
:::
:::WorkflowBlockItem
In the list of devices, select another BUSY Bar.
:::
:::WorkflowBlockItem
Go to the **Draw tool** and tap the status you want to display.
:::
:::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/UCf28Y9ACHoLp8NcnLnu7_play-logo-narrow.png" alt caption width="48" height="96"}** Show on BUSY Bar**.
:::
::::
:::::
To stop displaying a status:
- Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/i2rd5LoHX1lCCGCKYVYq5_stop-logo-narrow.png" alt caption width="48" height="96"} **Turn status off**.
::::::
:::::Tab{title="Web interface"}
::::WorkflowBlock
:::WorkflowBlockItem
Connect BUSY Bar to a PC via USB, then open [http://10.0.4.20](http://10.0.4.20) in a browser.
Alternatively, you can [access the web interface via Wi-Fi (LAN)](docId\:v_izwbs0I2kIljDxY_Kkp).
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**.
:::
:::WorkflowBlockItem
Hover over the status you want to display, then click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/UCf28Y9ACHoLp8NcnLnu7_play-logo-narrow.png" alt caption width="48" height="96"} **Show on BUSY Bar**.
:::
::::
To stop displaying a status:
- Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/i2rd5LoHX1lCCGCKYVYq5_stop-logo-narrow.png" alt caption width="48" height="96"} **Turn status off**.
:::::
:::::::
***
# Export your statuses
You can export your statuses as PNG files to save them locally or share them with others.
:::::::Tabs
::::::Tab{title="Mobile BUSY App"}
:::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**.
:::
::::WorkflowBlockItem
To export a status, **press and hold** it, then tap **Download .png**.
:::hint{type="info"}
To export multiple statuses, tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Me5Gtrv8Q5hjLsZhG5zTe_three-dots-icon.png" alt caption width="88" height="96"}, choose the statuses, then tap **Download .png**.
:::
::::
:::::
::::::
::::::Tab{title="Web interface"}
:::::WorkflowBlock
:::WorkflowBlockItem
Connect BUSY Bar to a PC via USB, then open [http://10.0.4.20](http://10.0.4.20) in a browser.
Alternatively, you can [access the web interface via Wi-Fi (LAN)](docId\:v_izwbs0I2kIljDxY_Kkp).
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**.
:::
:::WorkflowBlockItem
Hover over the status you want to export.
:::
::::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Me5Gtrv8Q5hjLsZhG5zTe_three-dots-icon.png" alt caption width="88" height="96"}, then click **Download PNG**.
:::hint{type="info"}
To export multiple statuses, click the checkboxes to select the statuses, then click **Download PNG**.
:::
::::
:::::
::::::
:::::::
***
# Import a status
You can import a status by creating a new status and adding the existing status as an image. Use a 72×16 px image for a perfect fit.
::::::Tabs
:::::Tab{title="Mobile BUSY App"}
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**, then tap** Create**.
:::
:::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/vbYGDD0rzvnjlCmiWwYxt_image-logo.png" alt caption width="68" height="96"} **Image**, then select the status image you want to import from your phone.
:::
:::WorkflowBlockItem
Tap **Save**.
:::
::::
:::::
:::::Tab{title="Web interface"}
::::WorkflowBlock
:::WorkflowBlockItem
Connect BUSY Bar to a PC via USB, then open [http://10.0.4.20](http://10.0.4.20) in a browser.
Alternatively, you can [access the web interface via Wi-Fi (LAN)](docId\:v_izwbs0I2kIljDxY_Kkp).
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**, then click **Create**.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/vbYGDD0rzvnjlCmiWwYxt_image-logo.png" alt caption width="68" height="96"} **Image**, then select the status image you want to import from your computer.
:::
:::WorkflowBlockItem
Click **Save**.
:::
::::
:::::
::::::
***
# Delete a status
:::hint{type="danger"}
Once deleted, a status can‘t be restored.
:::
:::::::Tabs
::::::Tab{title="Mobile BUSY App"}
:::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**.
:::
::::WorkflowBlockItem
Select a status, **press and hold** it, then tap **Delete**.
:::hint{type="info"}
To delete multiple statuses, tap , choose the statuses, then tap **Delete**.
:::
::::
:::WorkflowBlockItem
In the pop-up, tap **Delete **to confirm.
:::
:::::
::::::
::::::Tab{title="Web interface"}
:::::WorkflowBlock
:::WorkflowBlockItem
Connect BUSY Bar to a PC via USB, then open [http://10.0.4.20](http://10.0.4.20) in a browser.
Alternatively, you can [access the web interface via Wi-Fi (LAN)](docId\:v_izwbs0I2kIljDxY_Kkp).
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/blnlslsfWRyVWn1RzXMzD_draw-tool.png" alt caption width="68" height="96"}** Draw tool**.
:::
:::WorkflowBlockItem
Hover over the status you want to delete.
:::
::::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Me5Gtrv8Q5hjLsZhG5zTe_three-dots-icon.png" alt caption width="88" height="96"}, then click **Delete**.
:::hint{type="info"}
To delete multiple statuses, select them using the checkboxes, then click **Delete**.
:::
::::
:::WorkflowBlockItem
In the pop-up, click **Delete **to confirm.
:::
:::::
::::::
:::::::
[title] Desktop BUSY App issues
[path] Troubleshooting/
Find troubleshooting steps for the desktop BUSY App below.
***
:::ExpandableHeading
### No sync when BUSY Bar is connected via Wi-Fi
If your BUSY Bar isn’t syncing with BUSY App when connected via Wi-Fi, try these steps:
- Check the internet connection on your Mac.
- Make sure the BUSY Bar is connected to Wi-Fi: On your BUSY Bar, go to **Settings -> Wi-Fi**. See [Connect to Wi-Fi](docId\:OAuMOf3wwdbFNBlnqffSy) for instructions.
- Make sure you’re [logged in to your BUSY account on both your BUSY Bar and BUSY App.](docId\:GTTBlGHrq0OJUa6qy6MWz)
:::
:::::ExpandableHeading
### ON CALL status doesn’t appear on BUSY Bar
Make sure the ON CALL status toggle is enabled in BUSY App on Mac:
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App**.
:::
:::WorkflowBlockItem
In the **BUSY Bar tab**, enable the **ON CALL integration** toggle.
:::
::::
:::::
:::::ExpandableHeading
### Live Activity duplicates the BUSY App status in the menu bar
It’s a known issue when a Live Activity from an iPhone duplicates the BUSY App status in the menu bar — we’re working on it. For now, you can remove the activity manually each time it appears. Alternatively, you can disable iPhone Live Activities from appearing on your Mac.
:::hint{type="warning"}
Your Mac will stop receiving Live Activity notifications from your iPhone, such as those from food-delivery and taxi apps.
:::
To disable iPhone Live Activity on your Mac:
::::WorkflowBlock
:::WorkflowBlockItem
On your Mac, go to **System Settings → Notifications**.
:::
:::WorkflowBlockItem
Go to **Allow notifications from iPhone**.
:::
:::WorkflowBlockItem
Turn off **Allow Live Activities from iPhone**.
:::
::::
:::::
:::::ExpandableHeading
### The :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/L-NjbC1JV-oIwGp-9hBnp-20260304-123534.png" alt caption width="176" height="88"} app icon is hidden behind the Mac’s notch in the menu bar
If the BUSY app icon is hidden behind your Mac’s notch, move other menu bar icons to make space for it.
::::WorkflowBlock
:::WorkflowBlockItem
Press and hold the **Command (⌘) key** on your keyboard.
:::
:::WorkflowBlockItem
Click and drag a visible menu bar icon to the left, past the notch.
:::
:::WorkflowBlockItem
Repeat with other icons until the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/L-NjbC1JV-oIwGp-9hBnp-20260304-123534.png" alt caption width="176" height="88"} app icon appears.
:::
:::WorkflowBlockItem
Once the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/L-NjbC1JV-oIwGp-9hBnp-20260304-123534.png" alt caption width="176" height="88"} app icon is visible, move it to your preferred position.
:::
::::
The BUSY app icon will remain in its new position even after you restart your Mac.
:::::
[title] BUSY Bar Documentation
[path] /
:::Iframe{iframeHeight="500" code="
"}
:::
[title] Restart
[path] Basics/
We continuously update the firmware to add new features and improve performance. Occasionally, the BUSY Bar may become unresponsive after an update. Most of the time, a normal restart will fix the issue. If not, you may need to perform a hard restart.
***
# Normal restart
If your BUSY Bar freezes and doesn’t respond to button presses, restart it:
- Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** buttons for 3 seconds.
:::Iframe{iframeHeight="500" code=""}
:::
***
# Hard restart
:::hint{type="info"}
This type of restart resets the power circuit of your BUSY Bar. Your settings and data remain unchanged.
:::
If a normal restart doesn’t resolve the issue, perform a hard restart:
- Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::Iframe{iframeHeight="500" code=""}
:::
[title] Set up via PC
[path] Basics/
To get the most out of your BUSY Bar, complete the setup: connect it to Wi-Fi, link it to your BUSY account, and update its firmware. Setting up on a computer takes **around 5 minutes**.
On this page, you’ll learn how to set up your BUSY Bar via PC:
- [Using the local web interface%section%](docId\:thP7SpHuQrzbWrGhlOTAO)
- [Using BUSY App (Mac only)%section%](docId\:thP7SpHuQrzbWrGhlOTAO)
***
# Set up using the local web interface
You can open the local web interface in any browser on your computer — it works on Windows, macOS, and Linux. A USB connection is all that’s required.
## Step 1: Connect BUSY Bar to Wi-Fi
:::::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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::WorkflowBlockItem
In the web interface, in the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/YxZr_qVVu1JDupS58Xuf7-20260304-124207.png" alt caption width="68" height="88"} **Network** tab, click **Select network**.
:::
::::WorkflowBlockItem
Select a network from the list, enter the password, and click **Connect**.
:::ExpandableHeading
*Don’t see your Wi-Fi network? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Move your BUSY Bar closer to your Wi-Fi router.
- BUSY Bar only supports 2.4 GHz Wi-Fi networks. Check your router settings to make sure the 2.4 GHz band is enabled.
- Restart your Wi-Fi router.
- Your Wi-Fi network might be hidden. [Enter the Wi-Fi name and password manually](https://docs.busy.app/bar/basics/connect-wifi#connect-to-a-hidden-wi-fi-network-using-the-web-in).
:::
::::
:::::
## Step 2: Update BUSY Bar firmware
Before updating the firmware, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/A7JXZVtnX-PpRToD6kBhh-20260304-124815.png" alt caption width="68" height="88"}** Firmware** tab, click **Update**.
:::
:::WorkflowBlockItem
In the window that opens, click **Start update** — the update will take **around 3 minutes**.
:::
::::
***
## Step 3: Link BUSY Bar to your BUSY account
::::WorkflowBlock
:::WorkflowBlockItem
In the web interface, click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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**.
:::
::::
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****Your BUSY Bar setup is all done and ready to use!**
If you got here from the First start guide, you can click [here](docId:6gAZ7MkPcoNI4E1ZxxPhk) to head back.
:::
***
# Set up using BUSY App (Mac only)
You can complete the first-time setup in BUSY App on your Mac — just follow the steps below.
## Step 1: Download BUSY App on your Mac
:::Iframe{iframeHeight="0" code="
"}
:::
***
## Connect your BUSY Bar to BUSY App
:::::WorkflowBlock
:::WorkflowBlockItem
Click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/L-NjbC1JV-oIwGp-9hBnp-20260304-123534.png" alt caption width="176" height="88"} BUSY App in the menu bar, then click **Connect**.
Alternatively, you can click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"} **BUSY App** icon in the Dock.
:::
:::WorkflowBlockItem
Connect your BUSY Bar to the PC via USB.
:::
::::WorkflowBlockItem
You’ll see a window asking for your permission to connect the BUSY Bar — click **Connect**.
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VMfrpLrpuYMKhr31n5tsa_warning-icon.png" alt caption width="84" height="88"}** ****Important**
Don’t unplug your BUSY Bar while it’s connecting to your Mac!
:::
::::
:::::
***
## Step 3: Update BUSY Bar firmware
Before updating the firmware, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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
Once your BUSY Bar is connected, go to **Update your BUSY Bar**.
:::
:::WorkflowBlockItem
In the window that opens, click **Update** — the update will take **around 3 minutes**.
:::
::::
***
## Connect BUSY Bar to Wi-Fi
:::::WorkflowBlock
:::WorkflowBlockItem
Go to **Connect to Wi-Fi network → Select network**.
:::
::::WorkflowBlockItem
Select a network from the list, enter the password, and click **Connect**.
:::ExpandableHeading
*Don’t see your Wi-Fi network? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Move your BUSY Bar closer to your Wi-Fi router.
- BUSY Bar only supports 2.4 GHz Wi-Fi networks. Check your router settings to make sure the 2.4 GHz band is enabled.
- Restart your Wi-Fi router.
- Your Wi-Fi network might be hidden. [Enter the Wi-Fi name and password manually](https://docs.busy.app/bar/basics/connect-wifi#connect-to-a-hidden-wi-fi-network-using-your-phone).
:::
::::
:::WorkflowBlockItem
Once your BUSY Bar is connected to Wi-Fi, click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/f-pk_wu0uiCL010to-fIE-20260313-131302.png" alt caption width="40" height="88"}**Back**.
:::
:::::
***
## Step 5: Link BUSY Bar to your BUSY account
::::WorkflowBlock
:::WorkflowBlockItem
Go to **Link device to your BUSY account → Log in** — you’ll be redirected to the BUSY account page.
:::
:::WorkflowBlockItem
Log in to your BUSY account with your email address, or continue with Google, Apple, or Microsoft.
Once you log in using the desktop app, your BUSY Bar will be automatically added to your BUSY account.
:::
::::
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****Your BUSY Bar setup is all done and ready to use!**
If you got here from the First start guide, you can click [here](docId:6gAZ7MkPcoNI4E1ZxxPhk) to head back.
:::
[title] Block apps and notifications
[path] BUSY and CUSTOM modes/
:::Iframe{iframeHeight="500" code=""}
:::
When connected to the BUSY App, your BUSY Bar blocks distracting apps and their notifications on your phone while you’re focusing. You can configure different blocking settings for different timers.
On this page, you’ll learn how to block distracting apps and notifications with BUSY App.
:::hint{type="info"}
Desktop support is coming soon.
:::
***
## Block apps
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"} **BUSY App**.
:::
:::WorkflowBlockItem
Swipe to the timer you want to configure app blocking for.
:::
:::WorkflowBlockItem
Tap **Block apps** (or **Apps blocked** if you’ve already set it up).
:::
:::WorkflowBlockItem
Grant the required permissions for app blocking to work.
:::
:::WorkflowBlockItem
Select the apps or app categories you want to block.
:::
::::
Now, when you start this timer, those apps will be blocked — you won’t be able to open them, and you won’t receive their notifications while focusing. App blocking is paused during rest phases.
[title] Set up modes via mobile app
[path] BUSY and CUSTOM modes/
You can set up your BUSY and CUSTOM modes using BUSY App on your phone. Alternatively, you can [configure them right on your BUSY Bar](docId\:FXW1nr6TZ5QHzHuKlX6in).
On this page, you’ll learn how to sync timers between the mobile app and your BUSY Bar, and how to edit them.
***
## Sync app timers with BUSY Bar
Before syncing mobile app timers with your BUSY Bar, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/X9L9E4M_FlSzTdftjKwqm-20260301-212752.png" alt caption width="88" height="88"} [Your phone has BUSY App installed](https://busy.app/downloads) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/I1gFGsPWN-gL0nmwiNqX7-20260301-230639.png" alt caption width="36" height="88"}
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/oxS90xUjCZ8njV3ZCjtxZ-20260305-133742.png" alt caption width="84" height="88"} [Your BUSY Bar is paired with your phone via Bluetooth](docId\:Dn-wX8LbZf8DpafRKu7a2) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/I1gFGsPWN-gL0nmwiNqX7-20260301-230639.png" alt caption width="36" height="88"}
To sync app timers with your BUSY Bar:
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"} **BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} or :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-i3AtQ2KI77_AOwtJ6Bbp-20260313-124654.png" alt="CUSTOM" caption width="135" height="72"} to set up your chosen mode.
:::
:::WorkflowBlockItem
In **App mode**, select the timer you want to assign to the chosen mode on your BUSY Bar.
:::
:::WorkflowBlockItem
&#xNAN;*(Optional)* You can also change the BUSY Bar theme, enable **Show work phase only**, and toggle smart home automation.
:::
::::
Now, when you start a synced timer on either your BUSY Bar or in BUSY App, it will start across all synced devices. Unsynced timers started from your phone will also appear on your BUSY Bar.
***
## Editing timers in mobile app
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"} **BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Swipe to the timer you want to edit. If it’s synced with your BUSY Bar, changes will apply across devices.
:::
:::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/rUfO7PYrr-YObexxeX7Ai_settings.png" alt caption width="40" height="40"} to change the timer name and mobile theme.
:::
:::WorkflowBlockItem
Tap the time to adjust timer settings.
:::
:::WorkflowBlockItem
Tap **Block apps** to disable opening distracting apps on your phone.
:::
::::
Whenever you change timer settings, they will update on both your BUSY Bar and in BUSY App.
***
## If multiple BUSY Bar devices are connected
All connected BUSY Bars remain fully synced as long as they are online and logged into the same account. When you start a timer on one device, it will start on all other connected devices as well.
[title] BUSY App
[path] /
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"}** BUSY App** is a focus timer and distraction-blocking app available on phones, smartwatches, and computers (Mac only). BUSY App works together with BUSY Bar to create a seamless ecosystem: when you start a focus session on your BUSY Bar, it instantly syncs across all your linked devices. You can also start and manage your focus sessions from any device — the others sync automatically.
:::Iframe{iframeHeight="500" code=""}
:::
On this page, you’ll learn about the BUSY App versions and their features:
- [Mobile app](docId\:t7klHajsRwOhzOxjk9OJ6) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JOYoOfZBWq8K46a17xtZ8-20260312-164747.png" alt caption width="60" height="88"}
- [Watch app](docId\:t7klHajsRwOhzOxjk9OJ6) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JOYoOfZBWq8K46a17xtZ8-20260312-164747.png" alt caption width="60" height="88"}
- [Desktop app](docId\:t7klHajsRwOhzOxjk9OJ6) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JOYoOfZBWq8K46a17xtZ8-20260312-164747.png" alt caption width="60" height="88"}
***
## Supported platforms
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/CZ91HV4T5wnn3GR8kyIAG-20260609-165252.png" alt caption width="88" height="96"}** Phone:** iOS, Android
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Im0mNQHdNzBjFuCOC2Saw-20260609-170143.png" alt caption width="88" height="96"}** Computer:** macOS
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VWUqKOQ_1NjDsVcrcNjQ4-20260615-181835.png" alt caption width="88" height="96"}** Watch:** watchOS, Wear OS
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****Where is the Windows app?**
Support for Windows is coming soon.
:::
***
# Mobile app
The mobile BUSY App syncs your phone with BUSY Bar over Wi-Fi or Bluetooth. Use it to set up and start focus sessions, connect BUSY Bar to Wi-Fi, and to block distracting apps and notifications while you work. Learn [how to pair BUSY Bar with your phone](https://docs.busy.app/bar/basics/pair-phone).
The mobile version of BUSY App is available on iOS and Android:
:::::VerticalSplit{layout="middle"}
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
* Click here for QR code* :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-kWE2mBrqr6Mn1HivQah-b-20250826-103310.png" size="50" width="500" height="500" position="flex-start" darkWidth="500" darkHeight="500" showCaption="false" indent="1"}
:::
::::
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
* Click here for QR code* :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-YsO7Y3XKK99YQ5yhtpkSC-20250826-103326.png" size="50" width="500" height="500" position="flex-start" darkWidth="500" darkHeight="500" showCaption="false" indent="1"}
:::
::::
:::::
Customize each session to your workflow — set the length of work and rest phases, choose how many cycles to repeat, pick which apps and notifications to block, and control what BUSY Bar displays.
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/PW9ztsjEo__h8vlFiAkMR_busy-app-mobile-overview-new-1.png" size="100" width="1800" height="1434" darkWidth="1800" darkHeight="1434" position="center" caption="User interface of the BUSY App on a phone" showCaption="false"}
You can also manage BUSY Bar settings in the BUSY App. Adjust sound and brightness, rename your BUSY Bar, enable smart home automation, connect it to Wi-Fi, and install the latest firmware updates.
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/hJBBeIADJ4_11WKMLjAn1_mobile-busy-app-timer-mode-settings-1.png" size="100" isUploading="false" position="center" caption="You can setup the session timer and what will be shown on your BUSY Bar" width="1800" height="1296" darkWidth="1800" darkHeight="1296" showCaption="false"}
## Mobile BUSY App features
- **Focus timer.** Set up your own Pomodoro-style workflow, or dive in with no time limit.
- **Syncs across devices.** Control your focus session from any connected device.
- **Block phone apps** and their notifications in focus sessions.
- **Set BUSY Bar theme.** Select what your BUSY Bar will show in a focus session.
- **Music in sessions.** Play music in work and rest phases.
- **BUSY Bar settings.** Brightness, sound, smart home, firmware updates, and more.
- **Firmware update.** Keep BUSY Bar's firmware up to date by starting the update from the app.
***
## BUSY App on your watch
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"} **BUSY App on your phone is required**
BUSY App must be installed on the paired phone for it to work on watches. Currently, BUSY App is not available as a standalone app for watchOS or Wear OS.
:::
You can start, stop, or skip timers on your wrist without opening the BUSY App on your phone, and all actions are instantly synchronized across devices. During breaks, the smartwatch also provides timely reminders when rest periods end.
The BUSY App on your watch can’t change the timer settings. For this, use the BUSY App on your phone or the BUSY Bar device, or the BUSY App on your Mac if synced.
***
# Desktop app
The desktop version of BUSY App is available on macOS only:
:::Iframe{iframeHeight="0" code="
"}
:::
:::hint{type="info"}
The Windows version is coming soon.
:::
The desktop BUSY App syncs your Mac with BUSY Bar over Wi-Fi or USB. Use it to set up and start focus sessions, connect BUSY Bar to Wi-Fi, and automatically show ON CALL status when the mic is active. Learn [how to connect your BUSY Bar to the app.](https://docs.busy.app/bar/basics/setup-on-pc#set-up-using-busy-app-mac-only)
Customize each session to your workflow — set the length of work and rest phases, choose how many cycles to repeat. These settings are synced across all connected devices.
The desktop version of BUSY App can show full-screen reminders to take a break. This feature can be disabled in the BUSY App settings.
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y1a0lZ14be1MoZnVQcyru_full-screen-rest-reminder-new.jpg" size="90" isUploading="false" position="center" width="1800" height="1002" darkWidth="1800" darkHeight="1002" showCaption="false"}
***
## Desktop BUSY App features
- **Focus timer.** Set up your own Pomodoro-style workflow, or dive in with no time limit.
- **Syncs across devices.** Control your focus session from any connected device.
- **ON CALL status.** Show your status whenever your mic is active — no extra setup needed. [Learn more](docId:0NnNZ5TMbSWyAGpJTxljy)
- **Full-screen REST reminder**. Get full-screen reminders to take a break (can be disabled in settings).
- **Firmware update.** Keep BUSY Bar's firmware up to date by starting the update from your Mac.
:::hint{type="info"}
The block distractions on your Mac feature is coming soon.
:::
[title] Clock
[path] Apps and integrations/
The Clock app shows time and date on both screens of your BUSY Bar. Customize the date and time format and what is shown.
On this page, you‘ll learn how to run the Clock app on your BUSY Bar and how to configure your preferences.
***
## How to run Clock on BUSY Bar
::::WorkflowBlock
:::WorkflowBlockItem
Switch your BUSY Bar to **APPS**.
:::
:::WorkflowBlockItem
Go to **Clock**.
:::
:::WorkflowBlockItem
Select **START**.
:::
::::
Now, BUSY Bar will display the time on both the front and back screens.
To quit the app:
- Press **Back** twice.
:::hint{type="info"}
You can switch to another mode (including OFF) while the app is running. Switching back to **APPS** resumes the app, so you can quickly switch between modes.
:::
***
## Change Clock settings
::::WorkflowBlock
:::WorkflowBlockItem
Switch your BUSY Bar to **APPS**.
:::
:::WorkflowBlockItem
Go to **Clock**.
:::
:::WorkflowBlockItem
Select **SETUP**.
:::
:::WorkflowBlockItem
Configure your date and time settings:
- **Show date:** Disable to hide date
- **Show seconds:** Enable to show seconds
:::
::::
***
## Change BUSY Bar time settings
To change your BUSY Bar‘s time zone and time format (12/24h):
::::WorkflowBlock
:::WorkflowBlockItem
Switch your BUSY Bar to **SETTINGS**.
:::
:::WorkflowBlockItem
Go to **Time**.
:::
:::WorkflowBlockItem
Go to **Time zone** and select your preferred time zone.
:::
:::WorkflowBlockItem
Go to **Time format** and select your preferred time format.
:::
::::
[title] Apps and integrations
[path] /
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/iDvCiC_6n1GVgnAO2_LCn_apps-and-integrations-1.jpg" size="90" isUploading="false" width="1770" height="1104" darkWidth="1770" darkHeight="1104" position="center" showCaption="false"}
BUSY Bar includes built-in apps and integrations that let you view useful information, such as your schedule updates and the current time. Thanks to its open HTTP API, you can also create your own integrations with 3rd-party software.
On this page, you‘ll get an overview of BUSY Bar's built-in apps and integrations, as well as how you can expand its functionality.
:::hint{type="info"}
We‘re continually expanding BUSY Bar capabilities. Support for installing user apps on BUSY Bar is coming soon.
:::
***
# Built-in apps
::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/h5IR0NA0m35GjUOwIMVzj_clock-app.jpg"}
[Clock](https://docs.busy.app/bar/apps-and-integrations/clock)
Shows time and date on both screens of your BUSY Bar
:::
::::
:::hint{type="info"}
More built-in apps are coming soon.
:::
***
# Integrations
::::LinkArray{contentSource="CUSTOM" customOrder="jGGXWeVf65WOmZVQP6Bjl,CwYrx9UwZCFpIuO4-ezOT"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xj92j92SJomDwb5ljDKRa_on-call-prev.jpg"}
[Auto ON CALL status](https://docs.busy.app/bar/apps-and-integrations/on-call)
Automatically show ON CALL status, clearly signaling to people around you that you’re on a call
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ruwPVSmCocb5UdNmIO29F_google-calendar-prev.jpg"}
[Google Calendar integration](https://docs.busy.app/bar/apps-and-integrations/google-calendar)
Get reminders about upcoming events on your BUSY Bar and show your status during meetings
:::
::::
***
# Build your own widgets
You can create your own BUSY Bar widgets using our open HTTP API, turning the device into a programmable display showing real-time data. Visit the [Development](docId:5888c5ifDhiyBrJztwJt7) section to learn more. The BUSY SDK and support for executable apps are coming soon.
BUSY Bar widgets are not just for developers — anyone can make them. Check out our guide on creating widgets without coding in the BUSY Blog:
::::LinkArray{contentSource="CUSTOM" itemsPerRow="3"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/i0o28yX9cH0RajmrxB8Eo-20260618-113257.jpg"}
[How to Make BUSY Bar Widgets Without Coding](https://blog.busy.app/how-to-make-a-busy-bar-widget-without-coding/)
:::
::::
[title] Auto ON CALL status
[path] Apps and integrations/
BUSY Bar can automatically show ON CALL status, clearly signaling to people around you that you’re on a call and shouldn’t be disturbed. This feature doesn’t require any additional permissions, and it cannot listen to the microphone. No setup is needed in messaging apps like Slack or Microsoft Teams.
**How it works:** on your computer, BUSY App runs in the background and monitors microphone usage. When a call starts in any application, BUSY Bar automatically switches to ON CALL. When the call ends, the status is cleared automatically.
On this page, you’ll learn how to enable and use auto ON CALL status with your BUSY Bar.
:::hint{type="info"}
This feature works only on macOS when your BUSY Bar is connected to BUSY App — either via USB or through account login.
Windows support is coming soon.
:::
***
## Enable auto ON CALL status (Mac only)
Before using auto ON CALL status, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/X9L9E4M_FlSzTdftjKwqm-20260301-212752.png" alt caption width="88" height="88"} [You’ve completed the setup in BUSY App on your Mac](https://docs.busy.app/bar/basics/setup-on-pc#set-up-using-busy-app-mac-only) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/I1gFGsPWN-gL0nmwiNqX7-20260301-230639.png" alt caption width="36" height="88"}
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"}** BUSY App**.
:::
:::WorkflowBlockItem
In the **BUSY Bar** tab, enable the **ON CALL integration** toggle.
:::
::::
Now, your BUSY Bar will automatically display ON CALL whenever you’re in a meeting or call on your Mac.
***
## Disable auto ON CALL status
To disable auto ON CALL status on Mac:
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"}** BUSY App**.
:::
:::WorkflowBlockItem
In the **BUSY Bar** tab, disable the **ON CALL integration** toggle.
:::
::::
[title] Compatible Matter hubs
[path] Smart home/
BUSY Bar works with smart home hubs that support the Matter protocol. The devices below support Matter according to their manufacturers, so you can use any of them to connect BUSY Bar to your smart home.
***
### Apple
- Apple TV 4K (2nd, 3rd generation)
- Apple HomePod (2nd generation)
- Apple HomePod mini
- Apple iPad with iPadOS 26+ (only for local control)
### Google
- Google Nest Hub (1st, 2nd generation)
- Google Home Speaker
- Google Nest Hub Max
- Google Nest Wi-Fi Pro (Wi-Fi 6E)
- Google TV Streamer (4K)
### Samsung
- Samsung SmartThings Station
- Samsung SmartThings Hub v3
- Samsung SmartThings Hub Dongle
### Aeotec
- Aeotec Smart Home Hub
- Aeotec Smart Home Hub 2
### Aqara
- Aqara Hub M3
- Aqara Hub M100
- Aqara Camera Hub G5 Pro
- Aqara Camera Hub G350
- Aqara Doorbell Camera Hub G410
- Aqara Thermostat Hub W200
### Homey
- Homey Pro Hub (2023)
- Homey Pro Hub (2026)
### Hama
- Hama Smart Home Hub
### Yandex
- Yandex Station (2nd, 3rd generation)
- Yandex Station Lite (1st, 2nd generation)
- Yandex Station Max
- Yandex Station Midi
- Yandex Station Mini (2nd, 3rd generation)
- Yandex Station Mini 3 Pro
- Yandex Hub
- Yandex Station Duo Max
- Yandex TV Station
### Amazon
- Amazon Echo
- Amazon Echo Hub
- Amazon Echo Pop
- Amazon Echo Flex
- Amazon Echo Studio
- Amazon Echo Input
- Amazon Echo Plus (2nd generation)
- Amazon Echo Dot (2nd generation)
- Amazon Echo Show 5
- Amazon Echo Show 8 (2nd generation)
- Amazon Echo Show 10 (3rd generation)
- Amazon Echo Show 15
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ** **Amazon Alexa**
In the Amazon Alexa app, you can view and control BUSY status and switch it from automations. However, changes of BUSY status can’t trigger automations in the Alexa smart home. That’s because BUSY Bar is recognized in smart home systems as a smart light, and Alexa routines can’t be triggered by one.
:::
[title] Smart home
[path] /
With BUSY Bar, you can set up your home for deep focus, making your smart home devices react the moment you start or stop a focus session. BUSY Bar is Matter-certified and works with all major ecosystems: Google Home, Apple Home, Samsung SmartThings, Amazon Alexa, and Home Assistant.
:::hint{type="info"}
Native Home Assistant integration is coming soon.
:::
***
# Use BUSY Bar with your smart home
You can use BUSY Bar in your smart home automations in three ways. It can trigger other smart devices, respond to triggers from other devices, or act as a condition in automations.
## BUSY Bar controls smart devices
When you start a focus session on your BUSY Bar, your smart home triggers automations for the smart devices connected to the hub.
For example:
- When you start a focus session, your lights dim and the AC turns on.
- When you start a focus session, your smart speaker pauses music.
- When you start a focus session, the front door locks.
## Smart devices control BUSY Bar
When a smart switch or sensor changes state, BUSY Bar starts or stops a focus session. You can set the theme and timer for the session.
For example:
- When a contact sensor on your door closes, BUSY Bar starts a focus session.
- When you press a smart button on your desk, BUSY Bar starts a focus session.
- When you say “Hey Google, start focus”, the voice assistant starts a focus session.
## BUSY Bar as a condition for automations
You can use your BUSY Bar’s focus session as a condition for your automations. Set up automations to run only during a focus session or only outside of one.
For example:
- The smart speaker announces the doorbell only when the BUSY status is off.
- Your robot vacuum starts its scheduled cleaning only when the REST status is active.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****Automations can scale**
BUSY Bar can trigger multiple smart devices, and multiple smart devices can trigger BUSY Bar. It all depends on how you [set up your automations](docId:1t94kLeT1EwOu0b3c0gH5).
:::
***
Learn more about BUSY smart home integration:
:::Iframe{iframeHeight="0" code="
"}
:::
[title] Wall mount
[path] Accessories/
Attach your BUSY Bar to a wall or any other flat, smooth surface using the included screws or double-sided tape. You can also attach it to a tripod using the built-in 1/4"-20 UNC thread. Thanks to its built-in rechargeable battery, it doesn’t need to remain plugged in during use.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"} **Wall mount is not included with BUSY Bar**
The wall mount is sold separately — you can get one in the [official shop](https://busy.app/products/wall-mount).
:::
***
# In the box
The wall mount package includes:
- 1 × Wall mount
- 2 × Wall screws
- 2 × Wall plugs
- 2 × Double-sided tape pads
- 1 × Locking screw
***
# How to use the wall mount
To install on any surface, follow these two steps: attach the mount, then hang your BUSY Bar and secure it in place.
## Step 1: Attach the wall mount
Installation varies by surface type — select yours below.
::::::ExpandableHeading
****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4a3-pR1rVN5EUOjj68OFd-20260615-181119.png" alt caption width="96" height="96"}** Brick or concrete wall**
For brick or concrete walls, drill two holes, insert wall plugs, and screw the mount into place. Read on for detailed instructions.
**You’ll need:**
- Masking tape *(optional)*
- Level
- Pencil
- Drill with a 4-mm (5/32") bit
- Hammer
- Screwdrivers PH1 and PH2
To attach the mount to a brick or concrete wall:
:::::WorkflowBlock
:::WorkflowBlockItem
*(Optional)* To protect the wall, **place masking tape **over the area where you’ll screw in the mount.
:::
:::WorkflowBlockItem
**Draw a horizontal line** using a level.
:::
:::WorkflowBlockItem
**Align the wall mount holes** with the drawn line and **mark the location **of the wall mount holes.
:::
::::WorkflowBlockItem
**Drill two holes** in the marked areas using a drill with a 4-mm (5/32") bit. The hole depth should be at least 20 mm (0.8 in).
:::ExpandableHeading
*How can I ensure that I drill to the required depth? *:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
Measure 20 mm (0.8 in) from the tip of the drill bit and wrap a piece of tape around the bit at that point. Drill until the tape reaches the wall. The tape serves as a visual depth marker.
:::
::::
:::WorkflowBlockItem
**Insert the two provided wall plugs** into the drilled holes.
:::
:::WorkflowBlockItem
*(Optional)* **Remove the masking tape**, if used.
:::
:::WorkflowBlockItem
**Screw the wall mount** with the provided screws using the PH2 screwdriver.
:::
:::::
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/SrCtVrz3YrrtWV8UIOJIA-20260306-143018.png" alt caption width="117" height="100"} **Warning**
Make sure each screw is fully **tightened and seated in the recess**. Otherwise, it may scratch the back cover of the BUSY Bar.
:::
::::::
::::::ExpandableHeading
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xNGlfY0Zb1wr8wdNAswho-20260615-181118.png" alt caption width="96" height="96"}** Wooden wall**
For wooden walls, drill two holes and screw the mount into place — detailed instructions below.
**You’ll need:**
- Masking tape *(optional)*
- Level
- Pencil
- Drill with a 2-mm (5/64") bit
- Screwdrivers PH1 and PH2
To attach the mount to a wooden wall:
:::::WorkflowBlock
:::WorkflowBlockItem
*(Optional)* To protect the wall, **place masking tape **over the area where you’ll screw in the mount.
:::
:::WorkflowBlockItem
**Draw a horizontal line** using a level.
:::
:::WorkflowBlockItem
**Align the wall mount holes** with the drawn line and mark the location of the wall mount holes.
:::
::::WorkflowBlockItem
**Drill two holes** in the marked areas using a drill with a 2-mm (5/64") bit. The hole depth should be at least 17 mm (0.7 in).
:::ExpandableHeading
*How can I ensure that I drill to the required depth? *:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
Measure 17 mm (0.7 in) from the tip of the drill bit and wrap a piece of tape around the bit at that point. Drill until the tape reaches the wall. The tape serves as a visual depth marker.
:::
::::
:::WorkflowBlockItem
*(Optional)* **Remove the masking tape**, if used.
:::
:::WorkflowBlockItem
**Screw the wall mount** with the provided screws using the PH2 screwdriver.
:::
:::::
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/SrCtVrz3YrrtWV8UIOJIA-20260306-143018.png" alt caption width="117" height="100"} **Warning**
Make sure each screw is fully **tightened and seated in the recess**. Otherwise, it may scratch the back cover of the BUSY Bar.
:::
::::::
::::::ExpandableHeading
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/r_D5BepNwwicslpIX9Y99-20260615-181118.png" alt caption width="96" height="96"} **Other surfaces (no drilling)**
The wall mount includes two double-sided tape pads for mounting on smooth, flat surfaces such as glass, tile, or metal without drilling. Apply the tape pads to the back of the wall mount, then attach the mount to the flat surface.
**You’ll need:**
- Rubbing alcohol
- Dry cloth
- Level
- Temporary marker
- Screwdriver PH1
********
Prepare the wall mount by applying the double-sided tape pads:
::::WorkflowBlock
:::WorkflowBlockItem
**Clean the back of the wall mount **with rubbing alcohol, then let it dry.
:::
:::WorkflowBlockItem
**Peel off the backing paper** from one side of the double-sided tape pads.
:::
:::WorkflowBlockItem
**Apply the double-sided tape pads** to the back of the wall mount as shown below, then press them firmly.
:::
::::
To attach the mount to the flat surface:
:::::WorkflowBlock
:::WorkflowBlockItem
**Clean the surface** with rubbing alcohol and let it dry.
:::
::::WorkflowBlockItem
*(Optional)* **Hold the wall mount** in place, **level it horizontally** using a level (or a phone level), then **mark the position** with a temporary marker.
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/SrCtVrz3YrrtWV8UIOJIA-20260306-143018.png" alt caption width="117" height="100"} Avoid using a permanent marker — it’s difficult to clean off later.
:::
::::
:::WorkflowBlockItem
**Peel off the backing paper** from the double-sided tape pads on the wall mount in two places.
:::
:::WorkflowBlockItem
**Press down** the wall mount against the wall in the marked area **for 30 seconds** to ensure maximum adhesion.
:::
:::WorkflowBlockItem
*(Optional)* **Wipe off any drawn outline** with a cloth, if drawn.
:::
:::WorkflowBlockItem
**Leave the wall mount on the wall for 1 hour** before attaching the BUSY Bar. This allows the adhesive to bond and reach maximum strength.
:::
:::::
::::::
***
## Step 2: Mount your BUSY Bar
::::WorkflowBlock
:::WorkflowBlockItem
**Hang the BUSY Bar** on the wall mount.
:::
:::WorkflowBlockItem
**Secure the BUSY Bar** to the wall mount using the provided locking screw and the PH1 screwdriver.
:::
::::
[title] Screen protectors
[path] Accessories/
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/T2T4Rhs037Y17xRkdXj3w_busy-bar-screen-protectors.png" size="90" isUploading="false" position="center" width="2500" height="1350" darkWidth="2500" darkHeight="1350" showCaption="false"}
Protect your BUSY Bar from scratches with screen protectors — one for the front screen and another for the back of the device.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"} **Screen protectors are not included with BUSY Bar**
The screen protectors are sold separately — you can get them in the [official shop](https://busy.app/products/screen-protector).
:::
***
# How to apply screen protectors
Watch our video guide for step-by-step instructions on how to apply protectors to your BUSY Bar‘s screens.
::Iframely{originalUrl="https://youtu.be/BfbpSv8_aHM?si=Qqz9Ei3PYiqtN7nQ" embedUrl="https://youtu.be/BfbpSv8_aHM?si=Qqz9Ei3PYiqtN7nQ" title="How to apply screen protectors to BUSY Bar" html=""}
[title] Troubleshooting
[path] /
:::Iframe{iframeHeight="500" code=""}
:::
Looking for general answers? Visit the[%faq%](https://docs.busy.app/bar/faq) page.
:::Iframe{iframeHeight="500" code="
"}
:::
[title] BUSY account issues
[path] Troubleshooting/
Find troubleshooting steps for your BUSY account below.
***
:::ExpandableHeading
### BUSY Bar doesn’t show the pairing code for connecting to BUSY account
If your BUSY Bar doesn’t show the pairing code, try these steps:
- Make sure the BUSY Bar is connected to Wi-Fi: On your BUSY Bar, go to **Settings -> Wi-Fi**. To learn how to connect to Wi-Fi, see [Connect to Wi-Fi](docId\:OAuMOf3wwdbFNBlnqffSy).
- Move BUSY Bar closer to your Wi-Fi router. The Wi-Fi signal might be too weak or blocked by walls.
- Restart your Wi-Fi router.
- [Update your BUSY Bar to the latest firmware version.](docId\:CtPB9O5UzErW5xMxE3Yuw)
- Try again later. The server might be temporarily unavailable.
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::::ExpandableHeading
### Forgot my BUSY account password
To reset your password:
::::WorkflowBlock
:::WorkflowBlockItem
Go to [cloud.busy.app](https://cloud.busy.app/)
:::
:::WorkflowBlockItem
Enter your email and click **Log in**.
:::
:::WorkflowBlockItem
Click **Forgot password**.
:::
::::
If you can’t reset your password, [contact support](https://support.busy.app/hc/en-us).
:::::
:::ExpandableHeading
### Can’t log in even though all credentials are correct
If you can’t log in even though your credentials are correct, try these steps:
- Try a different login method. For example, if you usually log in with your email, try signing in with Google using the same email address.
- Try again later. The server might be temporarily unavailable.
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
[title] Smart home integration issues
[path] Troubleshooting/
Find troubleshooting steps for BUSY Bar smart home integration below.
***
::::ExpandableHeading
### I can’t scan the Matter QR code
If you can’t scan the Matter QR code, try one of these options:
- **Enter the pairing code manually.** It’s next to the QR code on the back screen of your BUSY Bar.
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/lnHSbmOSHOsehBIXewTce-20260608-181719.jpg" size="100" width="1800" height="963" darkWidth="1800" darkHeight="963" position="center" showCaption="false" indent="2"}
- **Scan the QR code from the local web interface:**
1. Connect your BUSY Bar to your PC using a USB cable.
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/TN_ejlHVT_ScBMKSroGCE-20250916-125918.jpg" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/WVXhhWDwHckhR7UHOnT05-20260202-153321.png" size="100" width="1700" height="1066" darkWidth="2500" darkHeight="1568" position="center" showCaption="false" indent="2"}
:::Paragraph{listStyleType="decimal" listStart="2" indent="2"}
In the browser, go to [http://10.0.4.20](http://10.0.4.20).
:::
:::Paragraph{listStyleType="decimal" listStart="3" indent="2"}
Open the **Settings** tab.
:::
:::Paragraph{listStyleType="decimal" listStart="4" indent="2"}
In the **Smart home** section, click **Pair device**.
:::
:::Paragraph{listStyleType="decimal" listStart="5" indent="2"}
Scan the Matter QR code displayed on your computer.
:::
::::
:::ExpandableHeading
### BUSY Bar won’t show QR code or manual code
If your BUSY Bar doesn’t show the QR code or manual pairing code, try these steps:
- Make sure your BUSY Bar is connected to Wi-Fi: On your BUSY Bar, go to **Settings → Wi-Fi**.
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::ExpandableHeading
### Failed to connect BUSY Bar to the smart home
If you can’t connect your BUSY Bar to your smart home, try these steps:
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
- Make sure your BUSY Bar is connected to Wi-Fi: On your BUSY Bar, go to **Settings → Wi-Fi**.
- Make sure your Wi-Fi network has internet access.
- Make sure IPv6 is enabled on your Wi-Fi router.
- [Update your BUSY Bar to the latest firmware version.](docId\:CtPB9O5UzErW5xMxE3Yuw)
- If your BUSY Bar was previously connected to a smart home system, forget all smart home pairings: On your BUSY Bar, go to **Settings → Smart Home → Forget all pairings**. Then try connecting it again.
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::::ExpandableHeading
### BUSY Bar status isn’t updating in the smart home
Make sure smart home integration is enabled on your BUSY Bar:
::::WorkflowBlock
:::WorkflowBlockItem
On your BUSY Bar, go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} / :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/FW9F1FGJAPCPxlsfpX144-20260306-150456.png" alt caption width="220" height="110"}** → Setup → Smart Home**.
:::
:::WorkflowBlockItem
Set **Trigger smart home** to **On**.
:::
::::
:::::
:::ExpandableHeading
### BUSY Bar status changes, but the automation doesn’t work
If your BUSY Bar status changes but your smart home automation doesn’t run, try these steps:
- **Make sure smart home integration is enabled on your BUSY Bar:**
1. On your BUSY Bar, go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} / :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/FW9F1FGJAPCPxlsfpX144-20260306-150456.png" alt caption width="220" height="110"}** → Setup → Smart Home**.
2. Set **Trigger smart home** to **On**.
- **Check your smart home app: **Your BUSY Bar (smart bulb) should change its state when you start or pause :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} or :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/FW9F1FGJAPCPxlsfpX144-20260306-150456.png" alt caption width="220" height="110"} mode. If it doesn’t, try [reconnecting your BUSY Bar to your smart home](docId\:o-O1V6N63_pisLlcQJbJN).
- **Make sure your automation scenarios are set up correctly** in your smart home app. See [Set up automations](docId:1t94kLeT1EwOu0b3c0gH5).
:::
:::ExpandableHeading
### BUSY Bar status changes not as expected
Make sure your automation scenarios are set up correctly in your smart home app. Incorrect or conflicting automation rules can cause unexpected BUSY status changes.
:::
:::ExpandableHeading
### BUSY Bar appears as not responding or offline in the smart home system
If your BUSY Bar appears as not responding or offline in your smart home system, try these steps:
- Make sure your BUSY Bar is connected to Wi-Fi: On your BUSY Bar, go to **Settings → Wi-Fi**.
- Make sure your smart home hub is connected to Wi-Fi.
- [Update your BUSY Bar to the latest firmware version.](docId\:CtPB9O5UzErW5xMxE3Yuw)
- Update your smart home hub firmware and app.
- If your BUSY Bar was previously connected to a smart home system:
1. On your BUSY Bar, go to **Settings → Smart Home → Forget all pairings**.
2. Remove your BUSY Bar from your smart home app.
3. [Connect your BUSY Bar to the smart home again](docId\:o-O1V6N63_pisLlcQJbJN).
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
[title] Wall mount issues
[path] Troubleshooting/
Find troubleshooting steps for the BUSY Bar wall mount below.
***
:::ExpandableHeading
### I lost the screws. What size should I buy?
You‘ll need:
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xNGlfY0Zb1wr8wdNAswho-20260615-181118.png" alt caption width="96" height="96"}**For wooden wall:**
- *2× wall screws:* 3×18–35 mm self-tapping, with a pan head
- *1× locking screw:* ST1.7 × 8 mm self-tapping, with a pan head
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4a3-pR1rVN5EUOjj68OFd-20260615-181119.png" alt caption width="96" height="96"}**For brick or concrete wall: **
- *2× wall screws:* 3×18 mm self-tapping, with a pan head
- *2× wall plugs: *4×20 mm, plastic
- *1× locking screw:* ST1.7 × 8 mm self-tapping, with a pan head
:::
::::::ExpandableHeading
### Double-sided tape is coming off the wall
You need to replace the double-sided tape:
:::::WorkflowBlock
::::WorkflowBlockItem
**Get a double-sided tape.**
:::hint{type="info"}
We recommend using Premium Crown 513 Double-Sided Tape or similar.
:::
::::
:::WorkflowBlockItem
**Cut out two pads** with dimensions of 33×28 mm (1.3×1.1 in).
:::
:::WorkflowBlockItem
**Clean the back of the wall mount **with rubbing alcohol, then let it dry.
:::
:::WorkflowBlockItem
**Peel off the backing paper** from one side of each double-sided tape pad.
:::
:::WorkflowBlockItem
**Apply the double-sided tape pads** to the back of the wall mount as shown below, then press them firmly.
:::
:::::
::::::
[title] Tech specs
[path] /
Take a closer look at the tech specs of your BUSY Bar and explore its hardware capabilities.
***
# Design and materials
- **Color:** White body with orange accents, black front and back panels
- **Body material:** PC/ABS
- **Main screen material:** PC
- **Back panel material:** PC
- **Light guide material:** PC
- **Padding material on the monitor mount:** TPE
***
# Size and weight
- **Height:** 55.2 mm (2.17 inches)
- **Width:** 168.6 mm (6.64 inches)
- **Depth:** 40.8 mm (1.61 inches)
- **Weight:** 250 grams (8.82 ounces)
***
# Controls
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ZjM_I6D2HlStS7r9sH_9V-20260316-102821.png" alt caption width="140" height="110"}** Start / Pause button** — Start or pause modes, also OK
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wi7xMxRuIxCMAmRWzm-iW-20260316-102821.png" alt caption width="110" height="110"}** Mode selector** — Select modes, open apps, or access settings
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7YKaSwNYj7BVY8cjYPl-C-20260316-102822.png" alt caption width="110" height="110"}** Scroll wheel** — Navigate menus, also OK / Skip
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kOjxN6IQrspQMDuqFdM9u-20260316-102821.png" alt caption width="110" height="112"}** Back button** — Go back or exit apps
***
# Main display
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/mpeAgVg5HkdgsWy407qJZ-20260422-114944.jpg" size="90" width="1900" height="839" darkWidth="1900" darkHeight="839" position="center" showCaption="false"}
- **Resolution:** 72x16 pixels
- **Max refresh rate: **60 Hz
- **Physical size: **158.4x35.2 mm
- **Brightness control:** Manual or automatic (via light sensor)
- **LED type: **RGB with common anode
- **LED size: **1.23x1.2 mm
- **LED pitch:** 2.2 mm
- **LED driver chips:** ICND2153 + ICN2012
***
# Monitor mount
- **Compatible with monitors:** Up to 21 mm (0.83 inch) thick
***
# Back display
- **Type:** Monochrome OLED (white)
- **Diagonal:** 1.54 inches
- **Max refresh rate: **60 Hz
- **Colors:** 16 grayscales
- **Resolution: **160x80 pixels
- **Controller:** SSD1320
- **Interface: **SPI
- **Brightness control:** Manual or automatic (via light sensor)
***
# Main MCU
- **Model:** [STM32U595RI](https://www.st.com/en/microcontrollers-microprocessors/stm32u595ri.html)
- **Core: **Arm Cortex-M33 @ 160 MHz + MPU, FPU, and DSP
- **Flash:** 2 MB
- **SRAM:** 2.5 MB
***
# Wireless MCU
- **Model:** [Silicon Labs SiWG917M111MGTBA](https://www.silabs.com/wireless/wi-fi/siwx917-wireless-socs/device.siwg917m111mgt)
- **Core: **Arm Cortex-M4F @ 180 MHz + MPU, FPU, and NWP
- **Flash:** 8 MB
- **SRAM:** 672 KB
***
# Wireless connectivity
- **Wi-Fi version: **Wi-Fi 6 (IEEE 802.11 b/g/n/ax)
- **Wi-Fi band: **2.4 GHz only
- **BLE version: **5.4
***
# Data storage
- **Type: **eMMC NAND flash memory
- **Capacity: **8 GB
***
# Speaker
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/HULa9bGN5rUZF6mxojX2u-20260415-110809.jpg" size="82" width="2000" height="1429" darkWidth="2000" darkHeight="1429" position="center" showCaption="false"}
- **Audio mode: **Mono
- **DAC model: **NS4168
- **DAC input interface: **I2S
- **DAC sample rate: **44.1 kHz
- **Amplifier type: **Embedded in DAC
- **Amplifier class:** D
- **Speaker impedance:** 6 ohms
- **Speaker power: **0.8 W
***
# Battery
- **Type: **1-cell 18650
- **Capacity:** 3250 mAh
- **Battery connector: **A2007-H04 (4-pin)
- **Protections: **Overcharge, over-discharge, overtemperature, undertemperature
- **Charging time:**
- 2.5 hours — with an 18 W (or higher) Power Delivery charger
- 7–8 hours — with other USB chargers or a USB port
***
# USB-C port
- **Function: **Virtual LAN adapter and charging port
- **Mode:** USB device with Power Delivery (PD) support
- **Version: **2.0 Full speed
- **Max speed: **12 Mbit/s
- **PD version: **3.0
- **PD supported modes: **5V⎓3A, 9V⎓1.5A
***
# What’s in the box
- BUSY Bar
- USB-C cable (2 m)
[title]
[path] Development/
[title] Set up automations
[path] Smart home/
Smart home automations allow connected devices to perform actions automatically based on predefined rules, reducing the need for manual control and making everyday tasks more convenient.
Once your BUSY Bar is connected to your smart home, you can add it to automations. BUSY Bar can trigger actions in other devices when its status changes, update its displayed status in response to events in your home, or serve as a condition that determines whether an automation runs.
On this page, you'll learn more about automations with BUSY Bar:
- [How automations work%section%](docId:1t94kLeT1EwOu0b3c0gH5)
- [BUSY Bar in automations%section%](docId:1t94kLeT1EwOu0b3c0gH5)
- [Create an automation with BUSY Bar%section%](docId:1t94kLeT1EwOu0b3c0gH5)
***
# How automations work
Every automation usually has three parts:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/PF6uAkw9VactEsMq8EBDZ_trigger.png" alt caption width="72" height="96"}** Trigger** — an event that starts an automation.
*Examples: motion is detected, a door opens, BUSY Bar shows the BUSY status.*
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-fDQbKMjuxl6iXPW-5V3M_condition.png" alt caption width="72" height="96"}** Condition** (optional) — decides whether the automation should run.
*Examples: only on weekdays, only if someone is home, only if BUSY Bar shows BUSY.*
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/w4AeD69akoUqzY7pN2zQA_action.png" alt caption width="72" height="96"}** Action** — the task the smart home performs.
*Examples: turn on lights, lock doors, play music, BUSY Bar changes status to BUSY.*
***
# BUSY Bar in automations
BUSY Bar is shown in a smart home as a **smart light** with only two possible states:
- **ON** — when the BUSY or custom status is running.
- **OFF** — when the BUSY or custom status is not running. For example, when the rest phase is active, the timer is paused, or BUSY Bar is in OFF mode.
This makes BUSY Bar a simple switch-like device that can be used in automations as:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/PF6uAkw9VactEsMq8EBDZ_trigger.png" alt caption width="72" height="96"} **Trigger** — when the BUSY status starts, the automation starts.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-fDQbKMjuxl6iXPW-5V3M_condition.png" alt caption width="72" height="96"} **Condition** — automation runs only if BUSY Bar is in a specific state (BUSY shown or not shown).
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/w4AeD69akoUqzY7pN2zQA_action.png" alt caption width="72" height="96"} **Action** — BUSY status starts or stops/pauses as a result of the automation.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ** **Amazon Alexa**
BUSY Bar cannot act as a trigger for Alexa routines. Alexa routines can’t be triggered by changes in the state of a smart light or switch.
:::
### BUSY Bar as a :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/PF6uAkw9VactEsMq8EBDZ_trigger.png" alt caption width="72" height="96"}Trigger
By default, BUSY Bar triggers automations from both :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/FW9F1FGJAPCPxlsfpX144-20260306-150456.png" alt caption width="220" height="110"} modes. You can change the trigger settings to use only one mode or disable triggering from both modes.
::::::Tabs
:::::Tab{title="Using BUSY Bar"}
::::WorkflowBlock
:::WorkflowBlockItem
Switch your BUSY Bar to the mode you want to configure: :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} or :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-i3AtQ2KI77_AOwtJ6Bbp-20260313-124654.png" alt="CUSTOM" caption width="135" height="72"}.
:::
:::WorkflowBlockItem
Go to **Setup → Smart Home**.
:::
:::WorkflowBlockItem
Set **Trigger smart home **to **ON **to enable smart home automations, or **OFF **to disable them.
:::
::::
:::::
:::::Tab{title="Using mobile BUSY App"}
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"} **BUSY App**, swipe to the timer you want to set up, and tap **Settings**.
:::
:::WorkflowBlockItem
Set **Smart home automation **to **ON **to enable smart home automations, or **OFF **to disable them.
:::
::::
:::::
::::::
### BUSY Bar as an :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/w4AeD69akoUqzY7pN2zQA_action.png" alt caption width="72" height="96"}Action
When BUSY Bar is added to an automation as an Action, it can only start :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} mode. :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/FW9F1FGJAPCPxlsfpX144-20260306-150456.png" alt caption width="220" height="110"} can’t be started by an automation.
***
# Create an automation with BUSY Bar
Before creating automations with BUSY Bar, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/8spYjGbfBW0VE-Abpk1UT-20260427-121318.svg" alt caption width="68" height="68"} [BUSY Bar is connected to your smart home%page%](docId\:o-O1V6N63_pisLlcQJbJN)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/w4AeD69akoUqzY7pN2zQA_action.png" alt caption width="72" height="96"}** **All other devices for the automation are added to your smart home
::::WorkflowBlock
:::WorkflowBlockItem
Open your smart home app.
:::
:::WorkflowBlockItem
Create a new automation. The steps may vary depending on your platform:
- Apple Home: :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-Dgfk5ZHvY1o25eZdA_2n_add.png" alt caption width="76" height="96"}** → Add Automation**
- Google Home: :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-Dgfk5ZHvY1o25eZdA_2n_add.png" alt caption width="76" height="96"}** → Automation**
- SmartThings: **Home Name → Create Routine**
- Amazon Alexa: **More → Routines → **:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-Dgfk5ZHvY1o25eZdA_2n_add.png" alt caption width="76" height="96"}** → Add an event**
:::
:::WorkflowBlockItem
Set up your automation by selecting:
- **Triggers** — events that start the automation
- **Conditions ***(optional)* — requirements that must be met for it to run
- **Actions** — tasks performed when triggers occur and conditions are met
:::
:::WorkflowBlockItem
Save the automation.
:::
::::
:::hint{type="info"}
When using BUSY Bar as a trigger or action, create automations for both of BUSY Bar’s states: ON and OFF.
:::
For detailed instructions on setting up automations, see the guide for your smart home system:
- [Google Home%page%](https://support.google.com/googlehome/answer/16214649?hl=en-GB\&ref_topic=16062118\&sjid=4547908301008657670-EU#zippy=%2Ccreate-an-automation)
- [Apple Home%page%](https://support.apple.com/en-gb/102313)
- [SmartThings%page%](https://www.samsung.com/us/support/answer/ANS10002640/)
- [Amazon Alexa%page%](https://www.amazon.co.uk/gp/help/customer/display.html?nodeId=G2PYLKJN3XVZ55EQ)
- [Home Assistant%page%](https://www.home-assistant.io/docs/automation/basics/)
[title] Pair with your phone
[path] Basics/
Pair your BUSY Bar with your phone for initial setup and to sync focus sessions between your BUSY Bar and phone via Bluetooth when Wi-Fi is unavailable. Pairing is done using :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App**, available on iOS and Android.
On this page, you’ll learn how to pair and unpair BUSY Bar with a phone:
- [Pair BUSY Bar with your phone%section%](docId\:Dn-wX8LbZf8DpafRKu7a2)
- [Pair multiple BUSY Bars with your phone%section%](docId\:Dn-wX8LbZf8DpafRKu7a2)
- [Switch between paired BUSY Bars%section%](docId\:Dn-wX8LbZf8DpafRKu7a2)
- [Unpair your BUSY Bar%section%](docId\:Dn-wX8LbZf8DpafRKu7a2)
- [Unpair multiple BUSY Bars%section%](docId\:Dn-wX8LbZf8DpafRKu7a2)
***
# Pair BUSY Bar with your phone
:::::::WorkflowBlock
::::::WorkflowBlockItem
Install :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** on your phone:
:::::VerticalSplit{layout="middle"}
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
*Click here for QR code*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-kWE2mBrqr6Mn1HivQah-b-20250826-103310.png" size="50" width="500" height="500" position="flex-start" darkWidth="500" darkHeight="500" showCaption="false" indent="1"}
:::
::::
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
*Click here for QR code*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-YsO7Y3XKK99YQ5yhtpkSC-20250826-103326.png" size="50" width="500" height="500" position="flex-start" darkWidth="500" darkHeight="500" showCaption="false" indent="1"}
:::
::::
:::::
::::::
:::WorkflowBlockItem
On your phone, make sure **Bluetooth **is** ON**.
:::
::::WorkflowBlockItem
Switch your BUSY Bar to pairing mode by going to **Settings → Bluetooth**.
:::Iframe{iframeHeight="0" code=""}
:::
::::
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Tap **Connect BUSY Bar**.
:::
::::WorkflowBlockItem
Your BUSY Bar should appear in the list of devices — tap **Connect**.
:::ExpandableHeading
*BUSY Bar not appearing? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Check the Bluetooth connection on your phone.
- Make sure your BUSY Bar is in Bluetooth pairing mode: Go to **Settings → Bluetooth**.
- Keep your phone and BUSY Bar within 1–2 meters (3–6 ft) for a stable connection.
- [Unpair your BUSY Bar from any other device](docId\:Dn-wX8LbZf8DpafRKu7a2).
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** buttons for 3 seconds.
- [Update your BUSY Bar firmware via PC](docId\:CtPB9O5UzErW5xMxE3Yuw).
- Update BUSY App via the [App Store](https://apps.apple.com/us/app/busy-advanced-focus-timer/id6738797176) or [Google Play](https://play.google.com/store/apps/details?id=com.flipperdevices.busybar).
:::
::::
:::WorkflowBlockItem
Follow the onscreen instructions.
:::
:::::::
***
# Pair multiple BUSY Bars with your phone
You can pair multiple BUSY Bars with BUSY App on your phone, but you can control only one at a time. To pair, follow these steps:
:::::::WorkflowBlock
::::::WorkflowBlockItem
Install :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** on your phone:
:::::VerticalSplit{layout="middle"}
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
*Expand for QR code*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-kWE2mBrqr6Mn1HivQah-b-20250826-103310.png" size="50" width="500" height="500" position="flex-start" darkWidth="500" darkHeight="500" showCaption="false"}
:::
::::
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
*Expand for QR code*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-YsO7Y3XKK99YQ5yhtpkSC-20250826-103326.png" size="50" width="500" height="500" position="flex-start" darkWidth="500" darkHeight="500" showCaption="false"}
:::
::::
:::::
::::::
:::WorkflowBlockItem
On your phone, make sure **Bluetooth **is** ON**.
:::
::::WorkflowBlockItem
Switch the first BUSY Bar to pairing mode by going to **Settings → Bluetooth**.
:::Iframe{iframeHeight="0" code=""}
:::
::::
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Tap **Connect device**.
:::
::::WorkflowBlockItem
Your BUSY Bar should appear in the list of devices — tap **Connect**.
:::ExpandableHeading
*BUSY Bar not appearing? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Check the Bluetooth connection on your phone.
- Make sure your BUSY Bar is in Bluetooth pairing mode: Go to **Settings → Bluetooth**.
- Keep your phone and BUSY Bar within 1–2 meters (3–6 ft) for a stable connection.
- [Unpair your BUSY Bar from any other device](docId\:Dn-wX8LbZf8DpafRKu7a2).
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VM2QMuyqx42OhCdwUH71--20260311-162001.png" alt caption width="140" height="110"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** buttons for 3 seconds.
- [Update your BUSY Bar firmware via PC](docId\:CtPB9O5UzErW5xMxE3Yuw).
- Update BUSY App via the [App Store](https://apps.apple.com/us/app/busy-advanced-focus-timer/id6738797176) or [Google Play](https://play.google.com/store/apps/details?id=com.flipperdevices.busybar).
:::
::::
:::WorkflowBlockItem
Follow the onscreen instructions.
:::
:::WorkflowBlockItem
Switch the second BUSY Bar to pairing mode by going to **Settings → Bluetooth**.
:::
:::WorkflowBlockItem
In **BUSY App**, tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Tap your **BUSY Bar name**, then tap **＋** **Add device**.
:::
::::WorkflowBlockItem
Your BUSY Bar should appear in the list of devices — tap **Connect**.
:::ExpandableHeading
*BUSY Bar not appearing? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Check the Bluetooth connection on your phone.
- Make sure your BUSY Bar is in Bluetooth pairing mode: Go to **Settings → Bluetooth**.
- Keep your phone and BUSY Bar within 1–2 meters (3–6 ft) for a stable connection.
- [Unpair your BUSY Bar from any other device](docId\:Dn-wX8LbZf8DpafRKu7a2).
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** buttons for 3 seconds.
- [Update your BUSY Bar firmware via PC](docId\:CtPB9O5UzErW5xMxE3Yuw).
- Update BUSY App via the [App Store](https://apps.apple.com/us/app/busy-advanced-focus-timer/id6738797176) or [Google Play](https://play.google.com/store/apps/details?id=com.flipperdevices.busybar).
:::
::::
:::WorkflowBlockItem
Follow the onscreen instructions to pair with your BUSY Bar.
:::
:::WorkflowBlockItem
If you want to add more BUSY Bars, repeat steps 8–12 for each one.
:::
:::::::
***
# Switch between paired BUSY Bars
You can connect multiple BUSY Bars to BUSY App*,* and each BUSY Bar will have its own page in the app to manage it. To switch to a different BUSY Bar in BUSY App:
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Tap your BUSY Bar name, then tap the BUSY Bar you want to switch to.
:::
::::
***
# Unpair your BUSY Bar
You can unpair your BUSY Bar from BUSY App using the BUSY Bar itself or BUSY App on your phone.
## Using BUSY Bar
::::WorkflowBlock
:::WorkflowBlockItem
On your BUSY Bar, go to **Settings → Bluetooth**.
:::
:::WorkflowBlockItem
Select **Forget device**, then confirm your action.
:::
::::
## Using BUSY App on your phone
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** on your phone.
:::
:::WorkflowBlockItem
Tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to **Connection status → Bluetooth**.
:::
:::WorkflowBlockItem
Tap **Forget BUSY Bar**.
:::
::::
# Unpair multiple BUSY Bars
If you want to unpair multiple BUSY Bars, you can do it from each device separately, or from BUSY App on your phone.
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"}** BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Tap your **BUSY Bar name**.
:::
:::WorkflowBlockItem
In the list of your devices, tap the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/60_fBEj_3IEoN1SHNWSnY-20260615-181118.png" alt caption width="96" height="96"} **Unpair** button next to the devices you want to unpair.
:::
::::
[title] BUSY account
[path] /
**BUSY account** is the cloud service that keeps the entire BUSY ecosystem in sync, including BUSY App on mobile and desktop and your BUSY Bar. It syncs your focus sessions, timers, and integrations across all your devices, enables secure remote access to your BUSY Bar over the internet, and manages API access for connected services and automations.
To use these cloud features, connect your BUSY Bar to your account and log in to the account on your mobile and desktop devices.
On this page, you‘ll find:
- [BUSY account features%section%](docId\:GTTBlGHrq0OJUa6qy6MWz)
- [Log in to your BUSY account%section%%section%](docId\:GTTBlGHrq0OJUa6qy6MWz)
- [Delete your BUSY account%section%%section%](docId\:GTTBlGHrq0OJUa6qy6MWz)
***
# BUSY account features
- [Timer and status syncing%page%](docId\:nim7XbdyqIhcQLUXqQlgS)
- [Google Calendar integration%page%](docId\:BLGy7-zUp3bo9IXaMhGea)
- [Automatic ON CALL status over the internet%page%](docId:0NnNZ5TMbSWyAGpJTxljy)
- [BUSY Bar firmware update%page%](docId\:CtPB9O5UzErW5xMxE3Yuw)
- [HTTP API access to BUSY Bar%page%](docId\:H4whpEXTNlYjSR9PlxsAr)
- [API token management%page%](docId:3AUwYBGy9fGU_b8DnFm4h)
***
# Log in to your BUSY account
To sync timers, connect integrations, and enable HTTP API access, you’ll need to create a BUSY account, connect your BUSY Bar to it, and log in on your mobile and desktop devices.
- [Using your phone%section%](docId\:GTTBlGHrq0OJUa6qy6MWz)
- [Using your Mac%section%](docId\:GTTBlGHrq0OJUa6qy6MWz)
- [Using the local web interface (any platform)%section%](docId\:GTTBlGHrq0OJUa6qy6MWz)
## :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/nk9T8iJ680jfUZPTWKQcF_phone-dark.png" alt caption width="56" height="96"} Log in on your phone
Once you’ve paired your BUSY Bar with BUSY App, logging in automatically connects your BUSY Bar to your account — no extra steps needed.
::::WorkflowBlock
:::WorkflowBlockItem
[Download BUSY App on your phone.](https://busy.app/pages/downloads)
:::
:::WorkflowBlockItem
[Pair your BUSY Bar with your phone via Bluetooth.](docId\:Dn-wX8LbZf8DpafRKu7a2)
:::
:::WorkflowBlockItem
[Connect your BUSY Bar to Wi-Fi.](docId\:OAuMOf3wwdbFNBlnqffSy)
:::
:::WorkflowBlockItem
Tap :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Log in** in the top-left corner. The browser will open the sign-in page.
:::
:::WorkflowBlockItem
Log in with your email, or continue with your Google, Apple, or Microsoft account.
:::
::::
Having trouble logging in or creating an account? Please see [BUSY account issues%page%](docId:_XRVFEvMFz0_TJLLA9wxo)
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****ll done!**
You’re now logged in to your BUSY account on your phone, and your BUSY Bar is connected to your account.
:::
## :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/O9ayv-GqUis9aQj5aiUdR_pc-dark.png" alt caption width="88" height="96"} Log in on your Mac
Once you’ve paired your BUSY Bar with BUSY App, logging in automatically connects your BUSY Bar to your account — no extra steps needed.
::::WorkflowBlock
:::WorkflowBlockItem
[Download BUSY App on your Mac.](https://busy.app/pages/downloads)
:::
:::WorkflowBlockItem
[Connect your BUSY Bar to BUSY App.](docId\:thP7SpHuQrzbWrGhlOTAO)
:::
:::WorkflowBlockItem
Connect your BUSY Bar to Wi-Fi: **BUSY Bar tab → Settings → Wi-Fi**.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"}** Log in** in the top-left corner. The browser will open the sign-in page.
:::
:::WorkflowBlockItem
Log in with your email or continue with your Google, Apple, or Microsoft account.
:::
::::
Having trouble logging in or creating an account? Please see [BUSY account issues%page%](docId:_XRVFEvMFz0_TJLLA9wxo)
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****ll done!**
You’re now logged in to your BUSY account on your Mac, and your BUSY Bar is connected to your account.
:::
## :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/6MbcBA4hBEeYXmpjk86-h_web-dark.png" alt caption width="72" height="96"} Log in via the web interface
If you don’t have access to a phone or Mac, you still can log in to your BUSY account and connect your BUSY Bar to it via the BUSY Bar’s local web interface.
::::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.
:::
:::WorkflowBlockItem
Connect your BUSY Bar to Wi-Fi: go to the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/YxZr_qVVu1JDupS58Xuf7-20260304-124207.png" alt caption width="68" height="88"} **Network** tab, then click **Select network**.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** in the top-right corner.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"}. The browser will open the sign-in page.
:::
:::WorkflowBlockItem
Log in with your email or continue with your Google, Apple, or Microsoft account.
:::
:::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**.
:::
::::
Having trouble logging in or creating an account? Please see [BUSY account issues%page%](docId:_XRVFEvMFz0_TJLLA9wxo)
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****ll done!**
You’re now logged in to your BUSY account in the local web interface, and your BUSY Bar is connected to your account.
:::
***
# Delete your BUSY account
:::hint{type="danger"}
**** **This will delete your user data and API tokens and remove your integrations.******
:::
You can delete your account in the mobile BUSY App or from the BUSY account dashboard in a web browser.
## Delete your account using mobile BUSY App
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** on your phone.
:::
:::WorkflowBlockItem
Go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** in the top-left corner.
:::
:::WorkflowBlockItem
Tap **Delete account**.
:::
:::WorkflowBlockItem
In the pop-up, tap **Delete** to confirm.
:::
::::
## Delete your account using a web browser
::::WorkflowBlock
:::WorkflowBlockItem
In your browser, go to [cloud.busy.app](https://cloud.busy.app/)
:::
:::WorkflowBlockItem
Log in to your BUSY account.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** in the top-right corner.
:::
:::WorkflowBlockItem
Go to **Account**.
:::
:::WorkflowBlockItem
Click **Delete account**.
:::
:::WorkflowBlockItem
In the pop-up, click **Delete** to confirm.
:::
::::
## Delete your account using a desktop BUSY App
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} [BUSY App](https://busy.app/pages/downloads) on your computer.
:::
:::WorkflowBlockItem
Click :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/J1uAPYuLxlhU-eIr2JDms_account.png" alt caption width="68" height="96"} **Account** in the top-left corner.
:::
:::WorkflowBlockItem
Click **Delete account**.
:::
:::WorkflowBlockItem
In the pop-up, click **Delete** to confirm.
:::
::::
[title] API tokens
[path] Development/
An API token is a unique key that lets apps and services securely connect to your BUSY Bar over the internet.
On this page, you'll learn how to:
- [Create an API token](docId:3AUwYBGy9fGU_b8DnFm4h) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JOYoOfZBWq8K46a17xtZ8-20260312-164747.png" alt caption width="60" height="88"}
- [Rename a token](docId:3AUwYBGy9fGU_b8DnFm4h) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JOYoOfZBWq8K46a17xtZ8-20260312-164747.png" alt caption width="60" height="88"}
- [Delete a token](docId:3AUwYBGy9fGU_b8DnFm4h) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JOYoOfZBWq8K46a17xtZ8-20260312-164747.png" alt caption width="60" height="88"}
***
# Create an API token
:::::WorkflowBlock
:::WorkflowBlockItem
In the web browser on your PC, go to [cloud.busy.app](https://cloud.busy.app)
:::
:::WorkflowBlockItem
Log in to your BUSY account with your email address, or continue with Google, Apple, or Microsoft.
:::
:::WorkflowBlockItem
In the **API tokens** tab, click **+ Create token**.
:::
:::WorkflowBlockItem
Enter the **Token name**.
:::
:::WorkflowBlockItem
In the **Access scope** list, select the scope for this token. The scope determines which API the token can be used with:
- **BUSY Bar** — remote control of one connected BUSY Bar ([BUSY Bar HTTP API](https://api.busy.app/busybar/docs)).
- **Account** — timer state and profiles synced across your BUSY account ([BUSY account HTTP API](https://api.busy.app/docs)).
:::
:::WorkflowBlockItem
Click **Continue**.
:::
::::WorkflowBlockItem
Copy and save your API token.
:::hint{type="danger"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/qnjdr5-ckAAHFovFCIo6c_danger-icon.png" alt caption width="76" height="88"}** ****Save your API token in a secure place**
It is shown only once for security reasons, as anyone with the token can make requests on your behalf. If you lose it, you‘ll need to generate a new one.
:::
::::
:::::
***
# Rename a token
::::WorkflowBlock
:::WorkflowBlockItem
In the web browser on your PC, go to [cloud.busy.app](https://cloud.busy.app)
:::
:::WorkflowBlockItem
In the **API tokens** tab, click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/_ScZ0XnFsOp19_kqii0gA_bi-edit-fill.png" alt caption width="60" height="60"}** Edit** icon next to the token you want to rename.
:::
:::WorkflowBlockItem
In the pop-up, enter the new name and click **Save**.
:::
::::
***
# Delete a token
:::hint{type="danger"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/qnjdr5-ckAAHFovFCIo6c_danger-icon.png" alt caption width="76" height="88"}** ****Deleting a token is permanent**
Once you delete a token, all requests using this token will stop working permanently. Any apps or services that rely on it will no longer work.
:::
::::WorkflowBlock
:::WorkflowBlockItem
In the web browser on your PC, go to [cloud.busy.app](https://cloud.busy.app)
:::
:::WorkflowBlockItem
In the **API tokens** tab, click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/cauoOCby4ZI9n81jwFS1R_bi-trash-fill.png" alt caption width="60" height="60"}** Delete** icon next to the token you want to delete.
:::
:::WorkflowBlockItem
In the pop-up, click **Delete token **to confirm the action.
:::
::::
[title] About HTTP API
[path] Development/
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/IkfzK-kzJ0SiFV4TF5D3L_busy-bar-http-api.png" size="90" isUploading="false" width="1500" height="1074" darkWidth="1500" darkHeight="1074" showCaption="false"}
The open HTTP API lets you fully control your BUSY Bar using your own scripts, applications, or services in any programming language. The HTTP API is available over USB, Wi-Fi, and the internet.
On this page, you’ll learn about the HTTP API:
- [Capabilities%section%](docId\:H4whpEXTNlYjSR9PlxsAr)
- [Authentication%section%](docId\:H4whpEXTNlYjSR9PlxsAr)
- [HTTP API reference%section%](docId\:H4whpEXTNlYjSR9PlxsAr)
- [Try the API from the HTTP API reference%section%](docId\:H4whpEXTNlYjSR9PlxsAr)
- [Display an image and text using a Python script%section%](docId\:H4whpEXTNlYjSR9PlxsAr)
- [busylib libraries%section%](docId\:H4whpEXTNlYjSR9PlxsAr)
***
# Capabilities
- **Timer control** — control the BUSY and CUSTOM modes
- **Display control** — render text and images on both displays, adjust brightness
- **Audio control** — upload and play audio files, adjust volume
- **Real-time updates** — get display frames and BUSY Bar state changes over WebSocket
- **Input simulation** — emulate button presses and scroll wheel events
- **File management** — upload, organize, and delete files stored on the BUSY Bar
- **Firmware updates** — update firmware from a local file or over the internet
- **Wi-Fi and Bluetooth** — scan and connect the BUSY Bar to Wi-Fi networks, enable BLE advertising, remove BLE pairings, and check connection status
- **BUSY account** — link or unlink the BUSY Bar with your account, get account info
- **Matter integration** — connect the BUSY Bar to your smart home
- **System config** — set the BUSY Bar name, system time, time zone, and more
- **System info** — get BUSY Bar status, power, and firmware details
***
# How it works
The HTTP API follows a client-server architecture. The BUSY Bar acts as an **HTTP Server**, listening for incoming requests from an **HTTP Client**. When the BUSY Bar receives a request, it processes it and generates a response.
The HTTP client can be any application capable of sending HTTP requests, such as a smart home system, a script, a desktop or mobile application, or even a web browser. For the simplest test, connect BUSY Bar to your computer via USB and enter: `10.0.4.20/api/status/firmware`. The browser will send an HTTP request to your BUSY Bar and display its response:
An HTTP request URL consists of:
- **Base URL**, which depends on how BUSY Bar is connected.
- **Endpoint**, which identifies the type of request to BUSY Bar. All available endpoints are listed in the HTTP API reference.
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wDDklXlHPWIs8rxtA6kzI_base-url-and-endpoint-new.jpg" size="90" isUploading="false" position="center" width="1800" height="666" darkWidth="1800" darkHeight="666" showCaption="false"}
## Base URL
The base URL for HTTP API requests depends on how your BUSY Bar is connected:
| **Connection method** | **Base URL** | **Authentication** |
| --------------------- | ------------------------------ | ------------------ |
| USB | `http://10.0.4.20/api` | Not required |
| Wi-Fi (LAN) | `http://XX.XX.XX.XX/api` | Required |
| Internet | `https://api.busy.app/busybar` | Required |
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****For Wi-Fi connections**
To find your BUSY Bar's IP address, go to **Settings → Wi-Fi → [Your Wi-Fi AP name] → View IP Address**.
:::
**Authentication:** Wi-Fi (LAN) and internet connections require authentication. For details, see [Authentication%section%](docId\:H4whpEXTNlYjSR9PlxsAr)
## Wi-Fi access
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****Enable Wi-Fi access to control BUSY Bar over Wi-Fi**
Wi-Fi (LAN) connections to BUSY Bar are **disabled by default for security reasons**.
:::
To enable Wi-Fi access to BUSY Bar:
::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to a computer via USB.
:::
:::WorkflowBlockItem
Open the BUSY Bar local web interface in a web browser: [http://10.0.4.20](http://10.0.4.20)
:::
:::WorkflowBlockItem
On the **Network** tab, in the **HTTP API** section, turn on **HTTP API access**.
:::
:::WorkflowBlockItem
Click **Set password and enable**, and set a password.
:::
::::
From now on, your BUSY Bar will ask for this password every time you log in to the web interface via Wi-Fi. You’ll also need to include this password in all HTTP requests for authentication.
***
# Authentication
Authentication is how the device verifies that an incoming HTTP API request was actually sent by its owner or someone the owner trusts. Without authentication, BUSY Bar returns a `403 Forbidden` error in response to the request.
The authentication method depends on how you connect to BUSY Bar: via USB, Wi-Fi, or the internet.
## :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/E6JCd96P1l0K38ah5ZGX3_usb-header.png" alt caption width="96" height="96"} Via USB
A USB connection is considered a secure communication channel, so authentication is not used over USB. You can send any HTTP API requests to the device at its IP address `10.0.4.20` without authentication.
## :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/HKFo9DlWwktKDMQxhDYyZ_wifi-header.png" alt caption width="96" height="96"} Via Wi-Fi (LAN)
HTTP API requests over Wi-Fi are authenticated using a password that is set in the local web interface. Wi-Fi access must be enabled first. [Learn how to enable Wi-Fi access. ](docId\:H4whpEXTNlYjSR9PlxsAr)
Include this password in the `X-API-Token` header for every HTTP request sent to the BUSY Bar over Wi-Fi.
Here are a few examples:
::::Tabs
:::Tab{title="curl"}
```bash
curl -X GET \
"http://[BUSY Bar IP address]/api/status" \
-H "Accept: application/json" \
-H "X-API-Token: "
```
:::
:::Tab{title="JavaScript"}
```javascript
const response = await fetch("http://[BUSY Bar IP address]/api/status", {
headers: {
"Accept": "application/json",
"X-API-Token": "",
},
});
```
:::
:::Tab{title="Python"}
```python
import requests
response = requests.get(
"http://[BUSY Bar IP address]/api/status",
headers={
"Accept": "application/json",
"X-API-Token": "",
},
)
```
:::
::::
## :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/6MbcBA4hBEeYXmpjk86-h_web-dark.png" alt caption width="72" height="96"} Via internet
When connecting over the internet, requests are authenticated through an API token. You can generate and manage tokens in your BUSY account. [Learn how to manage API tokens.](docId:3AUwYBGy9fGU_b8DnFm4h)
Include your API token in the `Authorization` header using the `Bearer` authentication scheme for every HTTP request sent to the BUSY Bar over the internet.
Here are a few examples:
::::Tabs
:::Tab{title="curl"}
```bash
curl -X GET \
"https://api.busy.app/busybar/status" \
-H "Accept: application/json" \
-H "Authorization: Bearer "
```
:::
:::Tab{title="JavaScript"}
```javascript
const response = await fetch("https://api.busy.app/busybar/status", {
headers: {
"Accept": "application/json",
"Authorization": "Bearer ",
},
});
```
:::
:::Tab{title="Python"}
```python
import requests
response = requests.get(
"https://api.busy.app/busybar/status",
headers={
"Accept": "application/json",
"Authorization": "Bearer ",
},
)
```
:::
::::
***
# HTTP API reference
[HTTP API reference](https://api.busy.app/busybar/docs) is an interactive page where you can:
- **Browse all HTTP API endpoints** — view all supported API requests.
- **View the API schemas** that describe the JSON objects used by the HTTP API.
- **Download the **`openapi.yml`** file**, which contains the HTTP API specification in the OpenAPI format.
- **Test any API request**. Expand the desired endpoint, click **Try it out**, edit the request parameters or body if necessary, and then click **Execute**.
***
## How to open the HTTP API reference
You can open the HTTP API reference in one of two ways:
### **Option 1:** From the BUSY Bar local web interface
Open the following URL in your web browser:
- `http://10.0.4.20/docs` (when connected over USB)
- `http:///docs` (when connected over Wi-Fi)
Alternatively, open the **Network** tab in the local web interface and, in the **HTTP API** section, click either **Over USB** or **Over Wi-Fi**.
This opens the HTTP API reference hosted directly on the BUSY Bar. It documents the version of the HTTP API implemented in the device’s firmware. When you test API requests from the reference page, they are sent directly to the BUSY Bar over Wi-Fi or USB.
### **Option 2:** Public HTTP API reference
Open the following URL in your web browser: [https://api.busy.app/busybar/docs](https://api.busy.app/busybar/docs)
In the page header, select your BUSY Bar firmware version to view the corresponding HTTP API reference.
When you test API requests from the public reference page, the requests are sent to your BUSY Bar over the internet through our cloud service.
***
# Try the API from the HTTP API reference
You can send requests to your BUSY Bar right from the HTTP API reference. In the example below, you’ll show text on the front screen and an image on the back screen.
### **Step 1.** Authenticate (if needed)
To try API requests, you may need to authenticate first, depending on how you access the HTTP API reference:
- **Over USB** (`http://10.0.4.20/docs`) — no authentication needed, just send requests
- **Over Wi-Fi **(`http:///docs`) — click **Authorize** and enter the password you set when [enabling Wi-Fi access](docId\:H4whpEXTNlYjSR9PlxsAr)
- **Over the internet** (`api.busy.app/busybar/docs`) — click **Authorize** and enter an [API token](docId:3AUwYBGy9fGU_b8DnFm4h) generated in your BUSY account. When creating the token, select **BUSY Bar** under **Access scope**
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Y--ixUj8wES9DqYP3lQzL_authorize-new1.jpg" size="90" isUploading="false" position="center" width="1800" height="762" darkWidth="1800" darkHeight="762" showCaption="false"}
### **Step 2.** Upload an image for the back screen
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****for the back screen**
The file must be no larger than 255 KB. You can download our example image:
::File{src="https://archbee-doc-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/niSDzNEL3PyIdPTSodqzx_our-example-image.zip" label="our-example-image.zip"}
:::
Try the endpoint that uploads an image:
:::::WorkflowBlock
:::WorkflowBlockItem
In the **Assets** group, expand **POST** `api/assets/upload` and click **Try it out**.
:::
:::WorkflowBlockItem
In the **Request body**, click **Choose file** and select your file.
:::
::::WorkflowBlockItem
Click **Execute** to upload the file to your BUSY Bar.
:::hint{type="info"}
The image is now in your BUSY Bar’s memory. To show it, continue to Step 3.
:::
::::
:::::
### **Step 3.** Display text and an image on the BUSY Bar screens
::::WorkflowBlock
:::WorkflowBlockItem
Scroll down to the **POST** `/busybar/display/draw` endpoint.
:::
:::WorkflowBlockItem
Expand the endpoint and click **Try it out**.
:::
:::WorkflowBlockItem
*(Optional)* Edit the request body.
For example, change the `text` parameter to show a different text.
:::
:::WorkflowBlockItem
Click **Execute**. Your BUSY Bar will show the text on the front screen and the uploaded image on the back screen.
:::
::::
***
# Display an image and text using a Python script
Now let’s try controlling BUSY Bar with your own code. The Python script below uses the HTTP API to upload a small image and display it on the front screen together with a text message.
### **Step 1.** Create the script file
Copy and paste the contents of this block into a file named `test.py` and save it:
:::ExpandableHeading
*Click here to expand the block with the script code *:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
```python
#!/usr/bin/env python3
import argparse
import requests
APP_NAME = "hello_demo"
IMAGE_FILE = "smile.png"
def make_headers(auth_type: str, token: str | None) → dict:
"""Build HTTP headers for the selected authentication method."""
headers = {
"Accept": "application/json",
}
if auth_type == "usb":
# USB connection does not require authentication.
pass
elif auth_type == "wifi":
if not token:
raise ValueError("--token is required when using --auth wifi")
headers["X-API-Token"] = token
elif auth_type == "cloud":
if not token:
raise ValueError("--token is required when using --auth cloud")
headers["Authorization"] = f"Bearer {token}"
else:
raise ValueError(f"Unknown authentication type: {auth_type}")
return headers
def upload_image(base_url: str, auth_type: str, token: str | None):
url = (
f"{base_url}/assets/upload"
f"?application_name={APP_NAME}"
f"&file={IMAGE_FILE}"
)
with open(IMAGE_FILE, "rb") as f:
response = requests.post(
url,
headers={
**make_headers(auth_type, token),
"Content-Type": "application/octet-stream",
},
data=f,
)
response.raise_for_status()
print("Image uploaded.")
def draw(base_url: str, auth_type: str, token: str | None):
url = f"{base_url}/display/draw"
payload = {
"application_name": APP_NAME,
"elements": [
{
"id": "logo",
"type": "image",
"display": "front",
"path": IMAGE_FILE,
"x": 0,
"y": 0,
},
{
"id": "text",
"type": "text",
"display": "front",
"text": "Hello world!",
"font": "extra_large",
"color": "#00FF00FF",
"width": 54,
"align": "top_left",
"scroll_rate": 800,
"scroll_start_delay": 1000,
"scroll_repeat_delay": 2500,
"x": 18,
"y": 1,
},
],
}
response = requests.post(
url,
headers={
**make_headers(auth_type, token),
"Content-Type": "application/json",
},
json=payload,
)
response.raise_for_status()
print("Display updated.")
def main():
parser = argparse.ArgumentParser(
description="Display an image and text on BUSY Bar."
)
parser.add_argument(
"base_url",
help=(
"Base URL, including the API path prefix "
"(e.g. http://10.0.4.20/api or https://api.busy.app/busybar)"
),
)
parser.add_argument(
"--auth",
choices=["usb", "wifi", "cloud"],
default="usb",
help="Authentication method (default: usb)",
)
parser.add_argument(
"--token",
help="Wi-Fi password or Cloud API token",
)
args = parser.parse_args()
base_url = args.base_url.rstrip("/")
upload_image(base_url, args.auth, args.token)
draw(base_url, args.auth, args.token)
print("Done.")
if __name__ == "__main__":
main()
```
:::
### **Step 2.** Download the image file
Save a 16x16 px PNG image named `smile.png` in the same folder as `test.py`. You can download our example image (:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7JT4wNuWOlcuwa2Bk0a0m_smile.png" alt caption width="16" height="16"}):
::File{src="https://archbee-doc-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wtSegFszF6ygddLHns_EO_example-image.zip" label="example-image.zip"}
### **Step 3.** Set up the Python environment
:::hint{type="info"}
The script requires **Python 3.10 or newer**. If Python is not installed, download it from [python.org](https://www.python.org/downloads/).
:::
Open a terminal in the folder with the script and run:
```bash
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install requests
```
This creates an isolated Python virtual environment and installs the `requests` library that the script depends on.
### **Step 4.** Run the script
Run the command for your connection type. For Wi-Fi, use the password you set when [enabling Wi-Fi access](docId\:H4whpEXTNlYjSR9PlxsAr). For an internet connection, use an [API token](docId:3AUwYBGy9fGU_b8DnFm4h) from your BUSY account.
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/E6JCd96P1l0K38ah5ZGX3_usb-header.png" alt caption width="96" height="96"}** USB**
```bash
python3 test.py http://10.0.4.20/api
```
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/HKFo9DlWwktKDMQxhDYyZ_wifi-header.png" alt caption width="96" height="96"}** Wi-Fi (LAN)**
For Wi-Fi, use the password you set when [enabling Wi-Fi access](docId\:H4whpEXTNlYjSR9PlxsAr).
```bash
python3 test.py http:///api --auth wifi --token ""
```
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/6MbcBA4hBEeYXmpjk86-h_web-dark.png" alt caption width="72" height="96"}** Internet**
For an internet connection, use an [API token](docId:3AUwYBGy9fGU_b8DnFm4h) from your BUSY account. When creating the token, select **BUSY Bar** under **Access scope**.
```bash
python3 test.py https://api.busy.app/busybar --auth cloud --token
```
If everything works, the terminal will print `Image uploaded.`, `Display updated.`, and `Done.`, and your BUSY Bar will show the image and the "Hello world!" text on the front screen.
***
# busylib libraries
**busylib** is the official open-source library for building applications that interact with BUSY Bar. It provides ready-to-use Python and TypeScript APIs that abstract the underlying HTTP API.
## Advantages
- **Simplifies development** by handling HTTP request construction and response processing. Developers can work with a simple, high-level API without worrying about the underlying HTTP protocol.
- **Implements WebSocket communication** for receiving real-time events from the BUSY Bar and for screen streaming.
- **Supports both synchronous and asynchronous interaction** with BUSY Bar, making it suitable for both simple applications and concurrent workflows.
## Get busylib
We maintain busylib for Python and TypeScript:
::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/2nMyL30R83hSoqpG17NSK_ts-logo.jpg"}
[TypeScript library](https://go.busy.app/typescript-library)
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ayHOmRd7ESYDHNI9TSIkL_python-logo.jpg"}
[Python library](https://pypi.org/project/busylib/)
:::
::::
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"} **L********ibraries from the community**
There are also libraries for the BUSY Bar HTTP API, built and maintained by the community:
- [BusyBar .NET](https://busybar-dotnet.homotechsual.dev/)
- [busybar.zig](https://tty.fail/mrus/busybar.zig)
:::
[title] Local web interface issues
[path] Troubleshooting/
Find troubleshooting steps for the BUSY Bar local web interface below.
***
:::ExpandableHeading
### Can’t access the local web interface via Wi-Fi
If you can’t access the local web interface via Wi-Fi, try these steps:
- Make sure your BUSY Bar is connected to Wi-Fi: On your BUSY Bar, go to **Settings → Wi-Fi**.
- If your BUSY Bar is not connected to Wi-Fi, connect it using BUSY App or the local web interface via USB. See [Connect to Wi-Fi](docId\:OAuMOf3wwdbFNBlnqffSy).
- Make sure you are using the correct IP address: On your BUSY Bar, go to **Settings → Wi-Fi → Your\_network\_name → View IP address**. Enter this IP address in your browser.
- Make sure the Wi-Fi access is [enabled in the local web interface.](docId\:H4whpEXTNlYjSR9PlxsAr)
- [Update your BUSY Bar to the latest firmware version.](docId\:CtPB9O5UzErW5xMxE3Yuw)
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::ExpandableHeading
### Can’t access the local web interface via USB
If you can’t access the local web interface via USB, try these steps:
- [Update your BUSY Bar to the latest firmware version.](docId\:CtPB9O5UzErW5xMxE3Yuw)
- Make sure your BUSY Bar is connected to your computer and all required system permissions are granted.
- Try using a different cable or USB port.
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::ExpandableHeading
### Can’t find my Wi-Fi network in the list of networks
If your Wi-Fi network doesn’t appear in the list, try these steps:
- Move your BUSY Bar closer to your Wi-Fi router.
- BUSY Bar only supports 2.4 GHz Wi-Fi networks. Check your router settings to make sure the 2.4 GHz band is enabled.
- Restart your Wi-Fi router.
- Try connecting to Wi-Fi via another method, as listed in [Connect to Wi-Fi](docId\:OAuMOf3wwdbFNBlnqffSy).
- Your Wi-Fi network might be hidden. [Enter the Wi-Fi name and password manually](https://docs.busy.app/bar/basics/connect-wifi#connect-to-a-hidden-wi-fi-network-using-your-phone).
- [Update your BUSY Bar firmware via PC](docId\:CtPB9O5UzErW5xMxE3Yuw).
If the issue persists, [contact support](https://support.busy.app/hc/en-us).
:::
:::::ExpandableHeading
### Forgot password (when accessing the web interface over Wi-Fi)
To change your local web interface password:
::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to your computer using a USB cable.
:::
:::WorkflowBlockItem
Open [http://10.0.4.20](http://10.0.4.20) in your browser.
:::
:::WorkflowBlockItem
Open the user menu in the top-right corner and select **Change Password**.
:::
:::WorkflowBlockItem
Set a new password.
:::
::::
Now you can access the web interface over Wi-Fi using your new password.
:::::
[title] BUSY and CUSTOM modes
[path] /
BUSY Bar comes with two focus modes: :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/FW9F1FGJAPCPxlsfpX144-20260306-150456.png" alt caption width="220" height="110"}. BUSY is intended as your main focus mode, while CUSTOM works as a status indicator for people around you. In practice, both modes offer the same functionality and can be fully adjusted to your preferences.
***
# How to start a focus session on BUSY Bar
::::WorkflowBlock
:::WorkflowBlockItem
Switch your BUSY Bar to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} or :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/FW9F1FGJAPCPxlsfpX144-20260306-150456.png" alt caption width="220" height="110"}.
:::
:::WorkflowBlockItem
Press :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause**.
A focus session starts on your BUSY Bar and, if connected, in the BUSY App on your phone and desktop device.
:::
::::
:::Iframe{iframeHeight="0" code=""}
:::
***
# Control your focus session from BUSY Bar
Once a BUSY session is active, the controls adapt in the following way:
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ZjM_I6D2HlStS7r9sH_9V-20260316-102821.png" alt caption width="140" height="110"}** Start / Pause button** — Pause your focus session.
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7YKaSwNYj7BVY8cjYPl-C-20260316-102822.png" alt caption width="110" height="110"}** Scroll wheel** — Rotate to adjust time, or press to skip the current phase.
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wi7xMxRuIxCMAmRWzm-iW-20260316-102821.png" alt caption width="110" height="110"}** Mode selector** — Move to immediately end your session.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kOjxN6IQrspQMDuqFdM9u-20260316-102821.png" alt caption width="110" height="110"}** Back button **— Immediately end your session.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****bout using the scroll wheel to adjust the time**
In sessions with BUSY and REST phases (interval timer), rotating the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/nsAwZD5PgLJbX9tOp0m-D-20260316-105319.png" alt caption width="96" height="96"} scroll wheel adjusts only the current phase. For example, if you extend a BUSY phase from 20 to 30 minutes, it returns to 20 minutes after the REST phase.
To adjust the time of the entire session, you need to do it in the mode’s settings:
1. Switch your BUSY Bar to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} or :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/FW9F1FGJAPCPxlsfpX144-20260306-150456.png" alt caption width="220" height="110"}.
2. Go to **Setup -> Timer** to set the session duration.
:::
***
# Control a focus session from BUSY App
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="88" height="88"} [BUSY App](https://busy.app/pages/app) and [BUSY account](https://docs.busy.app/bar/account) create a seamless ecosystem across your BUSY Bar, phone, watch, and Mac. Start a focus session on any linked device and continue controlling it from another — all devices stay automatically synchronized.
:::Iframe{iframeHeight="500" code=""}
:::
## Using mobile BUSY App
Before you start, [log in to your BUSY account and link your BUSY Bar to it%page%](https://docs.busy.app/bar/account#log-in-on-your-phone)
With BUSY App on your iOS or Android phone, you can set up, start, and control focus sessions running on your BUSY Bar and other connected devices. You can also choose which apps are blocked on your phone during a focus session. [Learn more%page%](docId\:t7klHajsRwOhzOxjk9OJ6)
## Using BUSY App on your watch
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"} **BUSY App on your phone is required**
BUSY App must be installed on the paired phone for it to work on watches. Currently, BUSY App is not available as a standalone app for watchOS or Wear OS.
:::
With BUSY App on your watchOS or wearOS device, you can start and control focus sessions running on your BUSY Bar and other connected devices. The BUSY App on your watch can’t change the timer settings. For this, use the BUSY App on your phone or the BUSY Bar device, or the BUSY App on your Mac if synced. [Learn more%page%](docId\:t7klHajsRwOhzOxjk9OJ6)
## Using desktop BUSY App (Mac only)
Before you start, [log in to your BUSY account and link your BUSY Bar to it%page%](https://docs.busy.app/bar/account#log-in-on-your-mac)
With BUSY App on your Mac, you can set up, start, and control focus sessions running on your BUSY Bar and other connected devices. [Learn more%page%](docId\:t7klHajsRwOhzOxjk9OJ6)
***
You can reduce distractions by blocking apps, syncing settings with the mobile app, and extending your setup with smart home integrations. Learn how to set up modes and block distracting apps:
::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/KD_zDOCXoKGeYJXdlmoln_setup-on-busy-bar.jpg"}
[Set up modes on BUSY Bar](https://docs.busy.app/bar/modes/setup-on-busy-bar)
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/q4CuySMLbI8AWb7f-Y5ct_setup-mobile-app.jpg"}
[Set up modes via mobile app](https://docs.busy.app/bar/modes/setup-mobile)
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/d5VhG6veXd4QnzHfzJZiX_block-apps.jpg"}
[Block apps and notifications](https://docs.busy.app/bar/modes/block-distractions)
:::
::::
[title] Monitor mount
[path] Basics/
BUSY Bar comes with a built-in monitor mount for quick and secure attachment to the top of your monitor, so others can see your status. Follow the steps below to make sure your BUSY Bar is placed securely:
- [How to place BUSY Bar on a monitor%section%](docId\:OeHWENyLgc275d0UfYofH)
- [How to route the USB cable%section%](docId\:OeHWENyLgc275d0UfYofH)
***
# How to place BUSY Bar on a monitor
The monitor mount is compatible with monitors **up to 21 mm (0.83 inch) **thick at the top edge. If your monitor is thicker but you’d still like to place your BUSY Bar high to show your status, you can get a Wall mount from our [official shop](https://busy.app/products/wall-mount).
:::Iframe{iframeHeight="500" code=""}
:::
To place your BUSY Bar on your monitor:
:::::WorkflowBlock
:::WorkflowBlockItem
Pull the mount outward.
:::
:::WorkflowBlockItem
Place the device on top of the monitor.
:::
::::WorkflowBlockItem
Push the mount inward to secure it against the monitor’s back.
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VMfrpLrpuYMKhr31n5tsa_warning-icon.png" alt caption width="84" height="88"}** ****Important**
Make sure the mount touches the back of the monitor. If it doesn’t, your BUSY Bar could fall.
:::
::::
:::::
When the BUSY Bar sits on top of your monitor, you can still see everything — the back screen mirrors the main one. The back screen also shows your BUSY Bar’s battery level, Wi-Fi status, sound level, and whether Bluetooth is ON.
***
# How to route the USB cable
You might want to keep your BUSY Bar connected via USB while it sits on top of your monitor. To secure the BUSY Bar in place on your monitor, follow these steps based on the thickness of your monitor.
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VMfrpLrpuYMKhr31n5tsa_warning-icon.png" alt caption width="84" height="88"}** ****Make sure the cable is routed correctly**
Incorrect cable routing can prevent BUSY Bar from sitting securely on top of your monitor and may cause it to fall. Follow the steps below to route the cable correctly.
:::
## For monitors under 15 mm (0.6 inch) thick
:::Iframe{iframeHeight="500" code=""}
:::
To place your BUSY Bar on your monitor:
::::WorkflowBlock
:::WorkflowBlockItem
Pull the mount outward.
:::
:::WorkflowBlockItem
Connect the cable to your BUSY Bar’s USB port.
:::
:::WorkflowBlockItem
Route the cable directly to the back of your monitor.
:::
:::WorkflowBlockItem
Place the device on top of the monitor.
:::
::::
## For monitors above 15 mm (0.6 inch) thick
:::hint{type="info"}
The mount is compatible with monitors **up to 21 mm (0.83 inch)** thick at the top edge.
:::
:::Iframe{iframeHeight="500" code=""}
:::
To place your BUSY Bar on your monitor:
::::WorkflowBlock
:::WorkflowBlockItem
Pull the mount outward.
:::
:::WorkflowBlockItem
Connect the cable to your BUSY Bar’s USB port.
:::
:::WorkflowBlockItem
Route the cable into the groove on the bottom side of the BUSY Bar.
:::
:::WorkflowBlockItem
Place your BUSY Bar on top of the monitor, keeping the cable in the groove.
:::
::::
[title] Connect to smart home
[path] Smart home/
To use BUSY Bar in your smart home, you’ll need an Android or iOS phone and a Matter-compatible smart home hub. Some smart speakers, TVs, or TV set-top boxes can be used as a hub.
On this page, you’ll learn how to manage BUSY Bar in your smart home:
- [Add BUSY Bar to your smart home](docId\:o-O1V6N63_pisLlcQJbJN) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JOYoOfZBWq8K46a17xtZ8-20260312-164747.png" alt caption width="60" height="88"}
- [Add BUSY Bar to multiple smart homes](docId\:o-O1V6N63_pisLlcQJbJN) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JOYoOfZBWq8K46a17xtZ8-20260312-164747.png" alt caption width="60" height="88"}
- [Remove BUSY Bar from your smart home](docId\:o-O1V6N63_pisLlcQJbJN) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JOYoOfZBWq8K46a17xtZ8-20260312-164747.png" alt caption width="60" height="88"}~~~~
***
## Add BUSY Bar to your smart home
Before adding your BUSY Bar to a smart home, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/aZEuDhWRzffeAhY_DMvWw_smart-home.png" alt caption width="72" height="96"} [You have a Matter-compatible smart home hub](docId\:JpGMyYSUQyzddmcA_C6oI) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4ylzwhOioPqiUoIdwqS8H-20260302-104633.png" alt caption width="36" height="88"}
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4LSmaeQt0ilTZ-j6q0_hw-20260301-161115.png" alt caption width="88" height="88"} [BUSY Bar is connected to Wi-Fi (same network as your hub)](docId\:OAuMOf3wwdbFNBlnqffSy) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/4ylzwhOioPqiUoIdwqS8H-20260302-104633.png" alt caption width="36" height="88"}
The steps and menu names may differ between smart home apps. Use this guide as a reference. To add BUSY Bar to your smart home:
:::::WorkflowBlock
:::WorkflowBlockItem
On your BUSY Bar, go to **Settings → Smart home → Pair device**.
:::
:::WorkflowBlockItem
On your phone, open your smart home app and go to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-Dgfk5ZHvY1o25eZdA_2n_add.png" alt caption width="76" height="96"}** → Add Accessory → Scan QR code**.
:::
::::WorkflowBlockItem
Scan the QR code on your BUSY Bar’s back screen with your phone.
:::Iframe{iframeHeight="0" code=""}
:::
::::
:::WorkflowBlockItem
Assign the BUSY Bar to a room and name it to help you identify and control it.
Now your BUSY Bar will appear in your smart home app as a **smart light** with two states: ON and OFF. You’re now ready to [set up automations](docId:1t94kLeT1EwOu0b3c0gH5).
:::
:::::
:::hint{type="info"}
For detailed instructions on adding devices to a smart home, see the guide for your system:
- [Google Home](https://support.google.com/googlehome/answer/9159862) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/OJA8iATW5oHWUCncBczrh_link-page.png" alt caption width="40" height="96"}
- [Apple Home](https://support.apple.com/en-gb/104998) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/OJA8iATW5oHWUCncBczrh_link-page.png" alt caption width="40" height="96"}
- [SmartThings](https://www.samsung.com/levant/support/apps-services/add-and-manage-devices-and-appliances-in-smartthings/) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/OJA8iATW5oHWUCncBczrh_link-page.png" alt caption width="40" height="96"}
- [Amazon Alexa](https://www.amazon.co.uk/gp/help/customer/display.html?nodeId=G3RKPNRKF33ECTW7) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/OJA8iATW5oHWUCncBczrh_link-page.png" alt caption width="40" height="96"}
- [Home Assistant](https://www.home-assistant.io/integrations/matter/#adding-a-matter-device-to-home-assistant) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/OJA8iATW5oHWUCncBczrh_link-page.png" alt caption width="40" height="96"}
:::
:::ExpandableHeading
*Can’t add BUSY Bar to your smart home? *:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart the BUSY Bar by holding the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
- Make sure your Wi-Fi network has internet access.
- Update your BUSY Bar to the latest firmware. See [Firmware update](docId\:CtPB9O5UzErW5xMxE3Yuw).
- If this BUSY Bar was previously connected to a smart home system, try to forget all smart home pairings (**Settings → Smart Home → Forget all** **pairings**) and connect it again.
:::
***
## Add BUSY Bar to multiple smart homes
You can connect your BUSY Bar to multiple smart homes by repeating the steps [described above](docId\:o-O1V6N63_pisLlcQJbJN) for each smart home.
***
## Remove BUSY Bar from your smart home
If you no longer want to use BUSY Bar with your smart home setup, you can remove it at any time. This removes the device from your automations and stops any actions triggered by your focus sessions. You can remove your BUSY Bar either through your smart home app or directly from BUSY Bar.
### Using smart home app
::::WorkflowBlock
:::WorkflowBlockItem
Open your smart home app on your phone.
:::
:::WorkflowBlockItem
Choose your BUSY Bar.
:::
:::WorkflowBlockItem
Go to the device settings (usually **Settings** or the gear icon).
:::
:::WorkflowBlockItem
Tap **Remove Accessory**.
:::
::::
### Using BUSY Bar
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VMfrpLrpuYMKhr31n5tsa_warning-icon.png" alt caption width="84" height="88"}** ****Affects all connected smart homes**
This removes your BUSY Bar from all connected smart homes.
:::
::::WorkflowBlock
:::WorkflowBlockItem
On BUSY Bar, go to **Settings → Smart home → Forget all pairings**.
:::
:::WorkflowBlockItem
Confirm action. BUSY Bar will restart.
:::
::::
[title] Basics
[path] /
Learn the basics of how to set up and start using your BUSY Bar:
::::LinkArray{contentSource="CUSTOM" customOrder="UzWDBeTOJ8_jIyfhQaglu,CScZVou9HnKHJpLxQrGzr,wwGXYnwgJcVbKvsNi4Hcg,lQ73CLG-UdMpJUWiE89g7,LhXhkmgHWvJHlSexNH7DJ,wS0-760jrKA3zjX8YibmN,x9SE8WoN_GBIv6yzbmYPT,x1fitUwBBczMeCkeVHhPe"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/SE8j2DsyeuGaRG5iRd3KU-20260313-183231.png"}
[First start](https://docs.busy.app/bar/basics/first-start)
Set up BUSY Bar and learn its core features
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/YFnY6Di3Q6Qe0YpjvrE-I_restart-prev.jpg"}
[Restart](https://docs.busy.app/bar/basics/restart)
Learn how to restart your BUSY Bar
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/hl_ii4MyWka0RSsynWyRc-20260313-185314.png"}
[Controls](https://docs.busy.app/bar/basics/controls)
Learn about BUSY Bar controls and hotkeys
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/nG1bbEXur2gEO4MqS1vMg-20260313-185853.png"}
[Pair with your phone](https://docs.busy.app/bar/basics/pair-phone)
Learn to pair and unpair BUSY Bar with a phone
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/auz3_itNiR1jVurukMO0u-20260313-185456.png"}
[Connect to Wi-Fi](https://docs.busy.app/bar/basics/connect-wifi)
Set up Wi-Fi and forget networks on BUSY Bar
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/XaLA6dpcAKMc81nQPMHwM-20260313-211655.png"}
[Firmware update](https://docs.busy.app/bar/basics/firmware-update)
Keep your BUSY Bar firmware up to date
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/XRbt631mVX7_iKe_kRZCZ-20260313-185401.png"}
[Set up via PC](https://docs.busy.app/bar/basics/setup-on-pc)
Learn how to set up your BUSY Bar via PC
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/LV-68isVHESnuS634Z6pe-20260313-182042.png"}
[Monitor mount](https://docs.busy.app/bar/basics/monitor-mount)
How to place BUSY Bar on your desktop monitor
:::
::::
[title] Connect to Wi-Fi
[path] Basics/
BUSY Bar needs a Wi-Fi connection for firmware updates and remote control. On this page, you’ll learn how to connect your BUSY Bar to Wi-Fi and forget a network:
- [Using your phone%section%](docId\:OAuMOf3wwdbFNBlnqffSy)
- [Using your PC%section%](docId\:OAuMOf3wwdbFNBlnqffSy)
- [Using BUSY App on your Mac%section%](docId\:OAuMOf3wwdbFNBlnqffSy)
***
# Connect to Wi-Fi using BUSY App on your phone
Before connecting your BUSY Bar to Wi-Fi, make sure:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} [Your phone has BUSY App installed%page%](https://busy.app/downloads)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/oxS90xUjCZ8njV3ZCjtxZ-20260305-133742.png" alt caption width="84" height="88"} [Your BUSY Bar is paired with your phone over Bluetooth%page%](https://docs.busy.app/bar/basics/pair-phone)
To connect your BUSY Bar to Wi-Fi:
:::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to **Settings → Wi-Fi → Connect BUSY Bar to Wi-Fi**.
:::
::::WorkflowBlockItem
Select a network from the list, enter the password, then tap **Connect**.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****This step takes time**
Scanning for networks and connecting **may take up to 2 minutes**. This is normal — don't restart your BUSY Bar.
:::
:::ExpandableHeading
*Don’t see your Wi-Fi network? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Move your BUSY Bar closer to your Wi-Fi router.
- BUSY Bar only supports 2.4 GHz Wi-Fi networks. Check your router settings to make sure the 2.4 GHz band is enabled.
- Restart your Wi-Fi router.
- Your Wi-Fi network might be hidden. [Enter the Wi-Fi name and password manually](https://docs.busy.app/bar/basics/connect-wifi#connect-to-a-hidden-wi-fi-network-using-your-phone).
- [Update your BUSY Bar firmware via PC](docId\:CtPB9O5UzErW5xMxE3Yuw).
:::
::::
:::::
## Connect to a hidden Wi-Fi network using your phone
Some wireless networks are hidden and don’t appear in the list of Wi-Fi networks. In this case, you can add your Wi-Fi manually.
To connect your BUSY Bar to a hidden Wi-Fi network:
:::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to **Settings → Wi-Fi → Connect BUSY Bar to Wi-Fi**.
:::
:::WorkflowBlockItem
Tap the plus **＋** button next to **Add hidden network**.
:::
:::WorkflowBlockItem
Enter the name of your Wi-Fi network.
:::
:::WorkflowBlockItem
Select a security protocol — typically WPA2 or WPA3.
:::
::::WorkflowBlockItem
Enter the password, then tap **Connect**.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****This step takes time**
Connecting **may take up to 2 minutes**. This is normal — don't restart your BUSY Bar.
:::
::::
:::::
## Forget a Wi-Fi network using BUSY App on your phone
::::WorkflowBlock
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Go to **Connection status → Wi-Fi**.
:::
:::WorkflowBlockItem
Tap **Forget this device**.
:::
::::
***
# Connect to Wi-Fi using the web interface on your PC
This method works on Windows, macOS, and Linux. You’ll connect your BUSY Bar to your PC using a USB cable and enter your Wi-Fi network credentials through the web interface.
To connect your BUSY Bar to Wi-Fi:
:::::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 web interface will load automatically.
:::ExpandableHeading
*The web interface doesn’t load? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"} **Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/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://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/D07ON6w4lkSzfD2t7BsJs-20260309-093629.png" alt caption width="110" height="110"}**Back** button for 20 seconds.
:::
::::
:::WorkflowBlockItem
In the web interface, in the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/YxZr_qVVu1JDupS58Xuf7-20260304-124207.png" alt caption width="68" height="88"} **Network** tab, click **Select network**.
:::
::::WorkflowBlockItem
Select a network from the list, enter the password, and click **Connect**.
:::ExpandableHeading
*Don’t see your Wi-Fi network? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Move your BUSY Bar closer to your Wi-Fi router.
- BUSY Bar only supports 2.4 GHz Wi-Fi networks. Check your router settings to make sure the 2.4 GHz band is enabled.
- Restart your Wi-Fi router.
- Your Wi-Fi network might be hidden. [Enter the Wi-Fi name and password manually](https://docs.busy.app/bar/basics/connect-wifi#connect-to-a-hidden-wi-fi-network-using-the-web-in).
:::
::::
:::::
## Connect to a hidden Wi-Fi network using the web interface
Some wireless networks are hidden and don’t appear in the list of Wi-Fi networks. In this case, you can add your Wi-Fi manually:
::::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.
:::
:::WorkflowBlockItem
In the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/YxZr_qVVu1JDupS58Xuf7-20260304-124207.png" alt caption width="68" height="88"} **Network** tab, click **Select network**.
:::
:::WorkflowBlockItem
In the window that opens, click the plus **＋** button next to **Add hidden network**.
:::
:::WorkflowBlockItem
Enter the name of your Wi-Fi network.
:::
:::WorkflowBlockItem
Select a security protocol — typically WPA2 or WPA3.
:::
:::WorkflowBlockItem
Enter the password, then click **Connect**.
:::
::::
## Forget a Wi-Fi network using the web interface
::::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.
:::
:::WorkflowBlockItem
In the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/YxZr_qVVu1JDupS58Xuf7-20260304-124207.png" alt caption width="68" height="88"} **Network** tab, click **Forget network**.
:::
::::
***
# Connect to Wi-Fi using BUSY App on your Mac
In this method, you do all the setup within BUSY App on your Mac to connect your BUSY Bar to Wi-Fi.
To connect your BUSY Bar to Wi-Fi:
:::::WorkflowBlock
::::WorkflowBlockItem
Download :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** on your Mac from the App Store:
:::Iframe{iframeHeight="0" code="
"}
:::
Once the app is installed, it will appear in your Mac’s menu bar.
::::
:::WorkflowBlockItem
Click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/L-NjbC1JV-oIwGp-9hBnp-20260304-123534.png" alt caption width="176" height="88"} BUSY App in the menu bar, then click **Connect**.
Alternatively, you can click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** icon in the Dock.
:::
:::WorkflowBlockItem
Connect your BUSY Bar to the PC via USB.
:::
::::WorkflowBlockItem
You’ll see a window asking for your permission to connect the BUSY Bar — click **Connect**.
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VMfrpLrpuYMKhr31n5tsa_warning-icon.png" alt caption width="84" height="88"}** ****Important**
Don’t unplug your BUSY Bar while it’s connecting to your Mac!
:::
::::
:::WorkflowBlockItem
Once your BUSY Bar is connected, go to **Connect to Wi-Fi network → Select network**.
:::
::::WorkflowBlockItem
Select a network from the list, enter the password, and click **Connect**.
:::ExpandableHeading
*Don’t see your Wi-Fi network? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Move your BUSY Bar closer to your Wi-Fi router.
- BUSY Bar only supports 2.4 GHz Wi-Fi networks. Check your router settings to make sure the 2.4 GHz band is enabled.
- Restart your Wi-Fi router.
- Your Wi-Fi network might be hidden. [Enter the Wi-Fi name and password manually](https://docs.busy.app/bar/basics/connect-wifi#connect-to-a-hidden-wi-fi-network-using-the-web-in).
:::
::::
:::::
## Forget a Wi-Fi network using BUSY App on your Mac
::::WorkflowBlock
:::WorkflowBlockItem
Connect your BUSY Bar to your Mac via USB.
:::
:::WorkflowBlockItem
You’ll see a window asking for your permission to connect the BUSY Bar — click **Connect**.
:::
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** on your Mac.
:::
:::WorkflowBlockItem
Click the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/L-NjbC1JV-oIwGp-9hBnp-20260304-123534.png" alt caption width="176" height="88"} BUSY App in the menu bar, then click **BUSY Bar**.
:::
:::WorkflowBlockItem
In the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/DVWTqO745Y9YA0ojh6JNc-20260312-203059.png" alt caption width="144" height="88"} **BUSY Bar** tab, click **Wi-Fi**, then click **Forget network**.
:::
::::
[title] First start
[path] Basics/
Your BUSY Bar has arrived, ready to help you protect your focus and do your best work. Follow the setup steps in this guide to get started in minutes. Enjoy your new BUSY Bar!
::Iframely{originalUrl="https://youtu.be/m_Sv8Km3RkE" embedUrl="https://youtu.be/m_Sv8Km3RkE" title="BUSY Bar Quick Start Guide | Setup and First Focus Session" html=""}
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****If you have glue residue on the screen**
Some BUSY Bars from the first batch may have glue residue on the front screen after you peel off the protective film. [Follow this guide to remove the residue](https://docs.busy.app/bar/troubleshooting/busy-bar#glue-residue-on-the-screen-after-removing-the-prot) :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/OJA8iATW5oHWUCncBczrh_link-page.png" alt caption width="40" height="96"}
:::
***
# Power on
To power your BUSY Bar on, press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** button for 3 seconds — you’ll see a “Hello” message on the screen.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****If your BUSY Bar doesn’t power on, try charging it**
The battery may be fully drained. Charge your BUSY Bar with the provided USB cable — it will turn on automatically
:::
## How to charge BUSY Bar
The USB-C charging port is located on the bottom. BUSY Bar supports Power Delivery (PD) up to 15W. It charges at 5V⎓3A or 9V⎓1.5A, reaching a full charge in about 2.5 hours with an 18W (or higher) PD charger.
## How to restart BUSY Bar
If your BUSY Bar freezes and fails to respond to button presses, try restarting the device by pressing and holding the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
:::Iframe{iframeHeight="500" code=""}
:::
***
# Learn controls
Physical buttons and switches let you control the BUSY Bar without connecting to a computer or the mobile app. The controls are designed for easy use, even without looking at the device.
BUSY Bar controls:
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ZjM_I6D2HlStS7r9sH_9V-20260316-102821.png" alt caption width="140" height="110"}** Start / Pause button** — Start or pause modes, also OK
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wi7xMxRuIxCMAmRWzm-iW-20260316-102821.png" alt caption width="110" height="110"}** Mode selector** — Select modes, open apps, or access settings
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7YKaSwNYj7BVY8cjYPl-C-20260316-102822.png" alt caption width="110" height="110"}** Scroll wheel** — Navigate menus, also OK / Skip
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kOjxN6IQrspQMDuqFdM9u-20260316-102821.png" alt caption width="110" height="112"}** Back button** — Go back or exit apps
***
# Get to know modes
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1lHOkldCxbjGtn_6kPVLT-20260305-111353.png" size="90" width="1800" height="861" darkWidth="1800" darkHeight="861" position="center" showCaption="false"}
Switch between modes, open apps and access settings using the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kBlpLStuBhGmON3SCi0uz-20260316-105319.png" alt caption width="96" height="96"} mode selector:
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="236" height="88"} — Main focus mode, by default set to BUSY interval timer
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/-i3AtQ2KI77_AOwtJ6Bbp-20260313-124654.png" alt="CUSTOM" caption width="135" height="72"} — Second focus mode, by default set to custom status
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wiHRzvPaojWcu051ktoay-20260313-124710.png" alt caption width="63" height="72"} — Sleep mode with both screens off
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Zm41xV8tAoecw1NxD19Ju-20260313-124723.png" alt caption width="138" height="72"} — Clock and user-added apps (coming soon)
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VOcioMEZ3F7MGgkv0lHTq-20260313-124812.png" alt caption width="210" height="72"} — Wi-Fi, Bluetooth, brightness, sound, firmware update, and more
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****About OFF mode**
OFF mode puts the BUSY Bar to sleep, not a full shutdown. Notifications, focus session started in the app, and the ON CALL status will still show.
To shut down your BUSY Bar completely, go to **Settings → System → Power → Shut down**. To power it back on, press and hold the **Back** button for 3 seconds.
:::
***
# Set up BUSY Bar in the mobile app
You need to set up your BUSY Bar to enable syncing across devices over the internet and automatic firmware updates. Setup takes about **6 minutes** and is done in BUSY App on your phone.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****Can’t complete the setup?**
You can resume setup anytime in BUSY App by tapping **Go to setup**. Previous settings are saved automatically.
If you don’t have access to a phone, you can [set up your BUSY Bar using a PC](docId\:thP7SpHuQrzbWrGhlOTAO).
:::
## Download BUSY App on your phone
The app is available on iOS and Android:
:::::VerticalSplit{layout="middle"}
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
* Click here for QR code*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-kWE2mBrqr6Mn1HivQah-b-20250826-103310.png" size="50" width="500" height="500" position="flex-start" darkWidth="500" darkHeight="500" showCaption="false" indent="1"}
:::
::::
::::VerticalSplitItem
:::Iframe{iframeHeight="0" code="
"}
:::
:::ExpandableHeading{indent="1"}
* Click here for QR code*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/3GUDYkC5JgUWgo6RW8piO-YsO7Y3XKK99YQ5yhtpkSC-20250826-103326.png" size="50" width="500" height="500" position="flex-start" darkWidth="500" darkHeight="500" showCaption="false" indent="1"}
:::
::::
:::::
***
## Pair BUSY Bar with your phone
:::::WorkflowBlock
::::WorkflowBlockItem
Switch BUSY Bar to pairing mode: go to **Settings → Bluetooth**.
:::Iframe{iframeHeight="0" code=""}
:::
::::
:::WorkflowBlockItem
On your phone, make sure **Bluetooth **is** ON**.
:::
:::WorkflowBlockItem
Open :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} **BUSY App** and tap the **BUSY Bar icon**.
:::
:::WorkflowBlockItem
Tap the **Connect BUSY Bar** button.
:::
::::WorkflowBlockItem
Your BUSY Bar should appear in the list of devices — tap **Connect**.
:::ExpandableHeading
*BUSY Bar not appearing? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Check the Bluetooth connection on your phone.
- Make sure your BUSY Bar is in Bluetooth pairing mode: Go to **Settings → Bluetooth**.
- Keep your phone and BUSY Bar within 1–2 meters (3–6 ft) for a stable connection.
- [Unpair your BUSY Bar from any other device](docId\:Dn-wX8LbZf8DpafRKu7a2).
- Restart your BUSY Bar: Press and hold the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause **and :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/acizC_ktW4Oi3wrSX9lwA-20260316-105319.png" alt caption width="80" height="96"}** Back** buttons for 3 seconds.
- [Update your BUSY Bar firmware via PC](docId\:CtPB9O5UzErW5xMxE3Yuw).
- Update BUSY App via the [App Store](https://apps.apple.com/us/app/busy-advanced-focus-timer/id6738797176) or [Google Play](https://play.google.com/store/apps/details?id=com.flipperdevices.busybar).
:::
::::
:::WorkflowBlockItem
Follow the onscreen instructions.
:::
:::::
***
## Connect BUSY Bar to Wi-Fi
You’ll see a list of available 2.4 GHz Wi-Fi networks — choose the one you want to connect to, then enter its password.
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****This step takes time**
Scanning for networks and connecting **may take up to 2 minutes**. This is normal — don't restart your BUSY Bar.
:::
:::ExpandableHeading
*Don’t see your Wi-Fi network? Click here for help*:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BnDmvlxd6fDnLVlZlpBnN-20260615-181604.png" alt caption width="96" height="96"}
- Move your BUSY Bar closer to your Wi-Fi router.
- BUSY Bar only supports 2.4 GHz Wi-Fi networks. Check your router settings to make sure the 2.4 GHz band is enabled.
- Restart your Wi-Fi router.
- Your Wi-Fi network might be hidden. [Enter the Wi-Fi name and password manually](https://docs.busy.app/bar/basics/connect-wifi#connect-to-a-hidden-wi-fi-network-using-your-phone).
- [Update your BUSY Bar firmware via PC](docId\:CtPB9O5UzErW5xMxE3Yuw).
:::
***
## Log in to BUSY account
To access advanced features such as synchronizing your focus sessions over the internet, syncing with Google Calendar, and creating API tokens — log in to your BUSY account:
::::WorkflowBlock
:::WorkflowBlockItem
In :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/QHcyDZeejE_E7ndcwFKpR_busy-app-icon.png" alt caption width="96" height="96"} BUSY App, tap **Go to setup**.
:::
:::WorkflowBlockItem
Tap **Link to your account**.
:::
:::WorkflowBlockItem
Sign up for your BUSY account with your email address, or continue with Google, Apple, or Microsoft.
:::
::::
Once you log in using the mobile app, your BUSY Bar will be automatically added to your BUSY account.
***
## Update the firmware
To update the BUSY Bar’s firmware, tap **Update firmware**. The update will begin automatically — the BUSY Bar will download and install it.
:::hint{type="success"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/1aDofAIpvZz_g9fNc-_io_success-icon.png" alt caption width="76" height="88"}** ****All done!**
You have finished setting up your BUSY Bar, and it’s now ready to use!
:::
***
# Explore BUSY App features
BUSY App is a focus timer and distraction-blocking app available on phones, smartwatches, and computers (Mac only). The app lets you divide work into structured intervals of focused sessions and scheduled breaks. During focus sessions, BUSY App can block selected apps and notifications to minimize distractions.
BUSY App works together with BUSY Bar to create a seamless ecosystem: when you start a session on your BUSY Bar, it instantly syncs across all your linked devices. You can also start and manage your focus sessions from any device — the others sync automatically.
:::Iframe{iframeHeight="500" code=""}
:::
BUSY App allows you to remotely customize the focus session, including the duration and the status displayed on the BUSY Bar. It also lets your BUSY Bar automatically display the ON CALL status whenever you use your Mac’s microphone.
***
# Start your first BUSY session
:::Iframe{iframeHeight="0" code=""}
:::
Now that the setup is complete, you can begin using your BUSY Bar with its full functionality. To start your first BUSY session:
::::WorkflowBlock
:::WorkflowBlockItem
Switch your BUSY Bar to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"}.
:::
:::WorkflowBlockItem
Press :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause**.
A focus session starts on your BUSY Bar and, if connected to the BUSY App, also on your phone.
:::
::::
## Control your focus session
You can control the session from any connected device. Try pausing the session by pressing :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9cerr6S5jJu3AvWCAOTer-20260316-105319.png" alt caption width="128" height="96"}** Start / Pause** on your BUSY Bar, then resume it by tapping the :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/Ho8BfLF_pzxZD6cJOtGMV-20260306-114125.png" alt caption width="48" height="88"}** Play** button in BUSY App on your phone.
Once a BUSY session is active, the controls adapt in the following way:
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ZjM_I6D2HlStS7r9sH_9V-20260316-102821.png" alt caption width="140" height="110"}** Start / Pause button** — Pause your focus session.
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/7YKaSwNYj7BVY8cjYPl-C-20260316-102822.png" alt caption width="110" height="110"}** Scroll wheel** — Rotate to adjust time, or press to skip the current phase.
- ****:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/wi7xMxRuIxCMAmRWzm-iW-20260316-102821.png" alt caption width="110" height="110"}** Mode selector** — Move to immediately end your session.
- :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kOjxN6IQrspQMDuqFdM9u-20260316-102821.png" alt caption width="110" height="110"}** Back button **— Immediately end your session.
## Change mode settings
By default, BUSY mode is set to an interval timer: 20 minutes of work and 5 minutes of rest, repeated for 3 cycles. You can change the timer type, its duration, and the status to display:
::::WorkflowBlock
:::WorkflowBlockItem
Switch your BUSY Bar to :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} mode.
:::
:::WorkflowBlockItem
Go to **Setup → Timer** to set the session type and duration.
:::
:::WorkflowBlockItem
Go to **Setup → Theme** to set the status when in a BUSY session.
:::
::::
:::hint{type="info"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/JzzAMWPfMWluW80KVupgz-20260311-152018.png" alt caption width="76" height="88"}** ****How to set up CUSTOM mode**
Setting up :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/vG5NRGbp072W4wJZRQIcT-20260313-130809.png" alt caption width="135" height="72"} mode works the same way as :inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/9kfvnatDJKrHrIouR2b4d-20260306-150519.png" alt caption width="220" height="110"} mode — just follow the same steps.
:::
***
# Place your BUSY Bar on your monitor
BUSY Bar comes with a built-in monitor mount designed for quick and secure attachment to the top of your display, so others can see your current status. The mount is compatible with monitors with a top-edge thickness of **up to 21 mm (0.83 in)**.
:::Iframe{iframeHeight="500" code=""}
:::
To place your BUSY Bar on your monitor:
:::::WorkflowBlock
:::WorkflowBlockItem
Pull the monitor mount outward.
:::
:::WorkflowBlockItem
Place the device on top of the monitor, with the main screen facing away from you.
:::
::::WorkflowBlockItem
Push the monitor mount inward to secure it against the monitor’s back.
:::hint{type="warning"}
:inlineImage[]{src="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/VMfrpLrpuYMKhr31n5tsa_warning-icon.png" alt caption width="84" height="88"}** ****Important**
Make sure the mount touches the back of the monitor. If it doesn’t, the BUSY Bar could fall.
:::
To learn more about the monitor mount and cable management, visit the [Monitor mount](docId\:OeHWENyLgc275d0UfYofH) page.
::::
:::::
***
# Add BUSY Bar to your workflow
::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/ruwPVSmCocb5UdNmIO29F_google-calendar-prev.jpg"}
[Google Calendar integration](https://docs.busy.app/bar/apps-and-integrations/google-calendar)
Get reminders about upcoming events on your BUSY Bar and show your status during meetings
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/BJ7FjkqD74BlXQzohtl8r_smart-home-prev.jpg"}
[Smart home](https://docs.busy.app/bar/smart-home)
Add BUSY Bar to your smart home and trigger automations the moment you start a focus session
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/xj92j92SJomDwb5ljDKRa_on-call-prev.jpg"}
[Auto ON CALL status](https://docs.busy.app/bar/apps-and-integrations/on-call)
Automatically show ON CALL status, clearly signaling to people around you that you’re on a call (macOS only)
:::
::::
***
# Join the community
As we near the launch of BUSY Bar, you can join our communities on:
::::LinkArray{contentSource="CUSTOM" customOrder="zzLMoTaiIFAdxziD0B-qL,1qL8S2Xayc29R7UuZdjac,SDMK6PjPGVhbYd0UyYGnF,3yNf5AX1_pb3ZVvHeHaM1,4nr2r_XaNVk47J33bZgy8,AtalGzz3c12BRxCoCeU-m"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://app.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/doVC8Airf2_FH2IwVxxAV_monosnap-miro-2023-04-13-19-25-16.png"}
[Discord](https://discord.com/invite/jXnEQQ4ahf)
Community chat and voice server
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/eqspsitkGxZ33aspk5yvP-20260313-200247.jpg"}
[Reddit](https://www.reddit.com/r/busyapp/)
Community discussions and support
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://app.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/rHafxEDRcrYcmsUgyQY8k-20251103-185944.png"}
[X](https://x.com/BusyFocusApp)
Updates and project announcements
:::
::::