Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.focusme.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Supported Distributions

FocusMe supports Debian-based Linux distributions:
  • Ubuntu 20.04+
  • Linux Mint
  • Debian 11+
  • Pop!_OS
  • Other Debian derivatives

​
Display Server Support

Display ServerStatus
X11Full support — window detection, title matching, global shortcuts
WaylandSupported with some limitations

​
Installation

chmod +x FocusMe-*.sh
sudo ./FocusMe-*.sh
The installer:
  • Installs FocusMe to /Applications/
  • Configures FocusMe to start automatically on login
  • Adds desktop integration (application menu entry, icons)
  • Bundles all required Qt libraries (no separate Qt installation needed)

​
Troubleshooting

​
Window detection not working

On X11, FocusMe uses X11 APIs to detect the active window. If detection isn’t working:
  1. Check that xdotool or xprop can see your windows
  2. Some tiling window managers may need additional configuration
  3. On Wayland, window detection may be limited depending on your compositor

​
Browser extension not connecting

The native messaging host manifest needs to be in the correct location:
  • Chrome/Chromium: ~/.config/google-chrome/NativeMessagingHosts/
  • Firefox: ~/.mozilla/native-messaging-hosts/
Reinstalling FocusMe should set these up automatically.

​
Uninstalling

sudo /Applications/FocusMe/focusme_uninstall_linux.sh