---
title: Luxafor Flag manual
description: The Luxafor Flag is a small busy light that gets its power from your computer over USB. A magnet holds it on your laptop, a cubicle partition or another surface. This manual covers setup, the Luxafor desktop app, phone control…
url: "https://luxafor.com/help/manuals/flag-manual/"
updated: "2026-11-16"
category: Manuals
---

# Luxafor Flag manual

The Luxafor Flag is a small busy light that gets its power from your computer over USB. A magnet holds it on your laptop, a cubicle partition or another surface. This manual covers setup, the Luxafor desktop app, phone control and troubleshooting.

![Luxafor Flag attached to a magnet, side view](https://luxafor.com/wp-content/uploads/2026/11/flag-manual-front-01.webp)

## What's in the box

![Luxafor Flag, magnet and USB data cable](https://luxafor.com/wp-content/uploads/2026/11/flag-manual-box-01.webp)

- 1 Luxafor Flag
- 1 USB data cable, 0.5 m (20 in) or 1.5 m (60 in) [CHECK: cable type and length]
- 1 magnet with double-sided tape

## Set up

1. Download the Luxafor desktop app for your computer from the [Luxafor software page](https://luxafor.com/software/). Install the latest version. [CHECK: software page URL]
2. Remove the plastic from the double-sided tape on the magnet.
3. Stick the magnet on the surface where you want the Flag, for example your laptop or a cubicle partition. You can remove the magnet at any time. It leaves no residue.
4. Open the Luxafor desktop app on your computer.
5. Connect the Flag to your computer with the USB cable from the box. Use only this cable. The Flag does not work with other cables.

## Use the Luxafor desktop app

#### Choose a mode

Open **General** in the app to choose a mode. Each mode takes control of the Flag, so only one mode can be active at a time. **Notifications** and **Settings** (hotkeys) work at the same time as the active mode.

#### Solid Color mode

Choose a preset color, such as red for busy and green for available. For your own color meanings, use **Custom Color** and move the slider to pick from 16 million colors. Solid Color mode works on Windows and Mac.

#### Timer mode

Use the timer to plan your day. Set the times when you cannot be disturbed and when you are available.

1. Click **Add new timer**.
2. Enter the times.
3. Choose a color. The Flag changes color at those times.

Timer mode works on Windows and Mac.

#### Tomato Timer mode

Set the length of your Pomodoro sessions and breaks to fit your work pace. The Flag blinks in a pattern you choose when a session starts. It turns red during a session, so people know not to disturb you. It turns green during a break. You can start, pause or reset a session. Tomato Timer mode works on Windows and Mac.

#### Microsoft Teams mode

The Flag shows your Teams status. Follow the steps in [Microsoft Teams mode](https://luxafor.com/help/integrations/microsoft-teams-mode/). Teams mode works on Windows and Mac.

If you use Teams in Teams Only mode, use Zapier mode instead. Connect the services on the Zapier platform. The Flag can then light up when a new message is posted to a channel or a new channel is created.

#### Zapier mode

Each action can be **Play Pattern**, **Solid Color** or **Blink Color**. Choose a color or pattern for each action.

1. Copy your Luxafor ID from the Zapier tab.
2. Paste it into your zap on [Zapier](https://zapier.com/apps/luxafor/integrations).
3. Test the connection on Zapier.

For more steps, read [Luxafor integration to Zapier](https://luxafor.com/help/integrations/luxafor-integration-to-zapier/). Zapier mode works on Windows and Mac.

#### Webhook mode

Webhook mode lets you build your own solutions and control other devices with the Luxafor Web API. Read the [Webhook API basics](https://luxafor.com/help/developers/webhook-api-basics-and-guidelines/). Webhook mode works on Windows and Mac.

#### Cisco Jabber mode

The Flag changes color with your Jabber presence status and blinks red during a call. Follow the steps in [Cisco Jabber integration](https://luxafor.com/help/integrations/cisco-jabber-integration/). Jabber mode works on Windows.

#### Zoom mode

1. Install Zoom and log in to your Zoom account.
2. Install and open the Luxafor desktop app on your computer.
3. Click **Zoom** in the left menu of the app.
4. Click **Log in to Zoom** and sign in with your Zoom account. [CHECK: button name in the current app]
5. Click **ALLOW** when the app asks you to authorize the connection.
6. Match each Zoom status to a color. For example, Busy is red and Available is green.

The Flag now follows your Zoom status. You can change the colors at any time in the app. The Flag shows your Zoom status only while the Zoom tab is open. To change the color another way, open a different tab, such as **Solid Color**. For more steps, read [Luxafor integration with Zoom](https://luxafor.com/help/integrations/luxafor-integration-with-zoom/).

#### Email notifications

The Flag can blink when you get email. Open **Notifications** in the app. Works on Windows and Mac.

1. Click **Gmail** if you have a Gmail account. Click **Mail** for any other email account.
2. Fill in the fields in the pop-up window.
3. Choose when the Flag blinks: while there is an unread email in your inbox, or only when a new email arrives.
4. To get alerts only for certain emails, set a keyword. For example, use the word `order` to see only sales emails.

#### Hotkeys

Hotkeys change the color without opening the app, so you stay on your task. Define them in **Settings** in the app. Type the shortcut you want to use, and the light changes to the color you set. Hotkeys work on Windows and Mac.

## Control the Flag from your phone

You can change the color of the Flag on your computer from the Luxafor app on your phone.

1. Open the Luxafor app on your phone. [CHECK: link to the phone app]
2. Go to the **Settings** tab and turn on **Allow to send commands to computer**.
3. Tap the smaller gear icon next to the toggle. A window opens.
4. Tap the QR code icon in the window. The camera opens.
5. On your computer, open the Luxafor desktop app and go to the **Webhook** tab.
6. Scan the QR code in the Webhook tab with your phone.
7. Select a solid color in the phone app. The Flag changes color.

**Note:** Your phone controls the color only while the **Webhook** tab is open in the desktop app. To use another trigger, such as Teams, Zoom or manual colors, open that tab.

## Compatibility

You can use the Flag with a computer that runs one of these systems. [CHECK: compatibility list is current]

- Windows: Windows 7, 8, 8.1, 10 and 11
- Mac: Mountain Lion, Mavericks, Yosemite, El Capitan, Sierra, Mojave, Catalina, Big Sur and Monterey

## Technical specifications

| Specification | Value |
| --- | --- |
| Dimensions | 48 × 15 × 34 mm |
| Weight | 8 g |
| Light | 6 RGB LEDs |
| Power | USB powered, through the USB data cable from the box |
| Power consumption | Up to 0.5 W |

## Troubleshooting

For more help, read [Luxafor Flag troubleshooting](https://luxafor.com/help/troubleshooting/luxafor-flag-troubleshooting/).

#### Nothing happens when I plug in the Flag

1. Use the USB cable from the box.
2. Plug a keyboard or a mouse into the same USB port. If it does not work, the port has a problem.
3. Plug the Flag into other USB ports on your computer or hub.
4. Plug the Flag into another computer with the same operating system and version.
5. Install the latest Luxafor desktop app from the [Luxafor software page](https://luxafor.com/software/).
6. Open the tab for the mode you want in the Luxafor desktop app. For example, to show your Zapier status, open the **Zapier** tab.

#### The Flag does not work after a cold start

1. In the Luxafor desktop app, open **Settings** and turn on **Start Luxafor when I start Windows**.
2. On Windows, make sure the USB ports do not go to sleep. Open **Device Manager** and click the **+** next to **Universal Serial Bus controllers**. Click a **Root Hub** and select **Properties**. Open the **Power Management** tab and turn on **Allow the computer to turn off this device to save power**. Do this for each **Root Hub**.
3. In the Control Panel, open **Power Options**, go to the **Hibernation** tab and turn off **Enable hibernate support**.

#### Gmail notifications do not work

Use these steps if Gmail notifications fail on Windows, or if a pop-up asks you to log in to Gmail again.

1. Turn on IMAP in Gmail. Read [how to turn on IMAP](https://support.google.com/mail/answer/7126229?hl=en).
2. If you use two-step verification, make an app password. Use this password in the Luxafor settings, not your Gmail password. Read [how to make an app password](https://support.google.com/accounts/answer/185833).
3. In the Luxafor desktop app, open **Notifications** and click **Mail**.
4. Fill in the fields as shown below. Click **Test Connection** to check, then click **OK**.
    ![Mail settings window with IMAP server imap.gmail.com, port 993 and Use SSL turned on](https://luxafor.com/wp-content/uploads/2026/11/flag-manual-mail-settings-01.webp)

## Still need help?

[Send us a message](https://luxafor.com/help/contact/) and tell us:

- which device you have and where you bought it
- what you see, and what you expected to see
- which steps on this page you have already tried
- your operating system and Luxafor app version, if it is a software problem
- your order number, if you have one

A short video or photo of the problem helps us fix it faster. If the problem is with the connection, film the device at the moment it tries to connect.
