> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.flowace.ai/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Troubleshooting Flowace on Mac

Fix common install, permission, menu-bar and auto-start problems on macOS.

| Item | Details |
| ---- | ---- |
| Feature area | Troubleshooting · macOS |
| Where to find it | Terminal app, and System Settings › Privacy & Security |

Use this article when the Flowace app on a Mac will not open, shows “No Permission”, loses its menu-bar icon, or does not start by itself. Each problem below lists the likely cause and the fix.
---

### Before you start

Most fixes use the **Terminal app**. Open Terminal, paste a command, then press Enter.

Some fixes are different for the two versions of the app. Where they differ, both full commands are written out. Use the one that matches the version you installed.

| Version | App location | Permission name used in commands |
| ---- | ---- | ---- |
| Flowace app (XMI) | /Applications/Flowace.app | com.flowace.app |
| Plugin app (XMS) | /Applications/Plugin.app | com.plugin.app |

![The terminal app](https://storage.crisp.chat/users/helpdesk/website/-/6/7/1/e/671eefeed0317800/the-terminal-app-mac_11wnxg2.png)
---

### Problems at a glance

| Symptom | Likely cause | Fix |
| ---- | ---- | ---- |
| “App is damaged” / won’t open | Quarantine flag from download | Remove the flag with the command for your app. |
| Install fails on old macOS | Needs macOS 10.13 or newer | Upgrade macOS. |
| App quits and reopens once right after install | Normal: handing off to auto-start | No action neede |
| Activity shows but browser URLs are blank | URL tracking reads the browser’s history files and needs disk access | Turn on Full Disk Access for the app. |
| “No Permission” entries even after granting permissions | Stale macOS permission cache | Reset and re-grant the permissions. |
| Login Items shows Flowace Technologies Pvt Ltd switched off | Background permission off | Turn Allow in the Background ON. |
| Menu-bar icon missing but process is running (Flowace app) | Icon hidden / crowded menu bar | Quit and reopen Flowace; check the menu bar isn’t full. |
| App restarts in a loop / Dock icon flickers | Old leftover startup configuration | Write to support@flowace.ai. |
| Wrong activity times after sleep/lock | Older build | Update the app. |

---

### Install and open

**“App is damaged” or the app won’t open**
The cause is usually a quarantine flag that macOS adds to a downloaded app. One command removes it.
1. **Open Terminal**. Open the Terminal app.
2. **Paste the command for your version.** Use the Flowace app command or the Plugin app command below.
3. **Press Enter**
**Flowace app (XMI)**
```
xattr -dr com.apple.quarantine /Applications/Flowace.app
```
**Plugin app (XMS)**
```
xattr -dr com.apple.quarantine /Applications/Plugin.app
```

![Example - Flowace App (XMI) - The quarantine command](https://storage.crisp.chat/users/helpdesk/website/-/6/7/1/e/671eefeed0317800/the-quarintine-command-for-the_4hy1qq.png)
**Install fails on an older Mac**
The app needs macOS 10.13 or newer. If the install fails, check your macOS version and upgrade macOS.

**The app quits and reopens once after install**
This is normal. The app is handing off to auto-start. No action is needed.
---

### Permissions

**Browser URLs are blank**
Activity shows, but the browser URLs are empty. URL tracking reads the browser’s history files, so the app needs disk access.
1. **Open System Settings.** Go to **Privacy & Security**.
2. **Choose Full Disk Access.**
3. **Switch on the app.** Turn on the Flowace app, or the Plugin app if that is the version you installed.

![Full Disk Access, with the app switched on](https://storage.crisp.chat/users/helpdesk/website/-/6/7/1/e/671eefeed0317800/full-disk-access_10vhr33.png)

**“No Permission” entries even after granting permissions**
A stale macOS permission cache can keep the old state. Reset each permission, then grant it again.
1. **Open Terminal.** Open the Terminal app.
2. **Run the necessary commands for your version.** Paste each one, then press Enter.
3. **Open the app again.**
4. **Turn the permissions back on.** In **System Settings › Privacy & Security**, turn Screen Recording, Accessibility and Input Monitoring back ON for the app.

**Flowace app (XMI) — run the commands**
```
tccutil reset ScreenCapture com.flowace.app
tccutil reset Accessibility com.flowace.app
tccutil reset ListenEvent com.flowace.app
```

**Plugin app (XMS) — run the commands**
```
tccutil reset ScreenCapture com.plugin.app
tccutil reset Accessibility com.plugin.app
tccutil reset ListenEvent com.plugin.app
```

![Example - Flowace App (XMI) - Reset Commands](https://storage.crisp.chat/users/helpdesk/website/-/6/7/1/e/671eefeed0317800/the-reset-commands_inm68j.png)
![The Privacy & Security List](https://storage.crisp.chat/users/helpdesk/website/-/6/7/1/e/671eefeed0317800/the-privacy-security-list_16mpolr.png)
**If a line says "failed"**
Grant Full Disk Access to the Terminal app in Privacy & Security, then run the command again.

---

### Startup, menu bar and accuracy

**Login Items shows Flowace Technologies Pvt Ltd switched off**
The background permission is off, so the app will not start by itself.
1. **Open Login Items**. Find **Flowace Technologies Pvt Ltd** under **Allow in the Background.**
2. **Switch it on.** Turn **Allow in the Background** ON, or the app won’t auto-start.

![Allow in the Background, switched on](https://storage.crisp.chat/users/helpdesk/website/-/6/7/1/e/671eefeed0317800/allow-in-the-background_oiv7pt.png)
**Menu-bar icon is missing but the app is running**
This applies to the Flowace app. The icon may be hidden in a crowded menu bar.
1. Quit and reopen Flowace.
2. Check the menu bar. Make sure it isn’t full.

**The app restarts in a loop, or the Dock icon flickers**
An old startup configuration is left over. Write to support@flowace.ai and describe what you see.

**Activity times are wrong after sleep or lock**
An older build can record the wrong times. Update the app.
---

### Good to know
* Use the command that matches the version you installed. The Flowace app and the Plugin app have different commands for the same fix.
* After a permission reset, open the app again and turn **Screen Recording, Accessibility and Input Monitoring** back ON.
* If a command line says “failed”, grant **Full Disk Access** to the **Terminal app**, then run it again.
* The app quitting and reopening once right after install is normal.
---

### FAQs
* **Which command do I use, Flowace app or Plugin app?**
Use the one for the version you installed. The Flowace app is XMI and the Plugin app is XMS. Both full commands are shown in each fix.
* **I reset the permissions. Why does the app show “No Permission” again?**
After a reset you need to turn Screen Recording, Accessibility and Input Monitoring back ON in System Settings › Privacy & Security.
* **A command says “failed”. What should I do?**
Grant Full Disk Access to the Terminal app in Privacy & Security, then run the command again.
* **The app closed and opened again right after I installed it. Is something wrong?**
No. This is normal. The app is handing off to auto-start.
* **Which macOS version does the app need?**
macOS 10.13 or newer.
---

### Related articles
* [Troubleshooting Flowace on Ubuntu](https://help.flowace.ai/en/article/troubleshooting-flowace-on-ubuntu-1xbmt3n/)

**Need more help?** Reach out to <support@flowace.ai> and our team will be happy to assist.
---
© Flowace Technologies Pvt Ltd | flowace.ai