Forca is a productivity app that blocks distractions and automatically enables focus mode when your meetings end. It runs in the background, detects when you're free, and starts blocking distracting websites and applications so you can focus on what matters.
How it works:
- Install the Forca desktop app and the browser extension.
- Forca runs in the system tray and monitors your calendar (optional).
- When a focus zone activates (automatically after a meeting or manually), the desktop app tells the browser extension which sites to block.
- The extension uses Chrome's declarativeNetRequest API or Firefox's blocking API to prevent access to those sites.
- When the focus zone ends, blocking stops automatically.
No account required. No data leaves your machine unless you enable multi-device sync.
| Feature | Description |
|---|---|
| Automatic Focus Activation | Forca detects when meetings end via calendar integration and starts focus zones automatically |
| Browser Extension | Blocks distracting websites during focus sessions via WebSocket sync with the desktop app |
| App Blocking | Blocks distracting desktop applications during focus sessions |
| Focus Zones | Named focus sessions with configurable timers, triggers, and settings |
| Zone Profiles | Save and switch between presets with blocked apps/sites, timer duration, and ambient sound settings |
| Calendar Integration | Connect Google Calendar or any iCal feed for meeting-based triggers |
| Ambient Focus Modes | Rain, white noise, and forest sounds via Web Audio API |
| Focus Score | Daily, weekly, and monthly productivity scoring with charts |
| Break Reminders | Pomodoro-style break timer (50-minute focus / 10-minute break by default) |
| Do Not Disturb Sync | Automatically enable DND on macOS and Windows during focus sessions |
| System Tray | Colored tray icons, quick controls, and notifications |
| Multi-Device Sync | Firebase-powered sync across computers (optional) |
| Focus Streaks | Consecutive day tracking with milestone rewards |
| Auto-Updater | Seamless updates delivered via GitHub Releases |
| Platform | Desktop App | Browser Extension |
|---|---|---|
| Windows (x64) | Installer (.exe) + Portable (.exe) | Firefox / Chromium |
| macOS (Intel) | DMG + ZIP | Firefox / Chromium |
| macOS (Apple Silicon) | DMG + ZIP | Firefox / Chromium |
| Linux (x64) | AppImage / .deb / .rpm | Firefox / Chromium |
Download the latest release from GitHub Releases:
| Platform | Format | Link |
|---|---|---|
| Windows | Installer | Forca-Setup-x64.exe |
| Windows | Portable | Forca-Portable-x64.exe |
| macOS (Intel) | DMG | Forca-x64.dmg |
| macOS (Apple Silicon) | DMG | Forca-arm64.dmg |
| Linux | AppImage | Forca-x64.AppImage |
| Linux | Debian | forca_amd64.deb |
| Linux | RPM | forca-x86_64.rpm |
On Windows, run Forca as Administrator for website blocking to work correctly.
Install directly from Firefox Add-ons:
The extension installs automatically through the add-ons store.
The Forca Chromium extension is not currently published on the Chrome Web Store. You can install it manually using Developer Mode:
- Download the latest Forca release and extract the ZIP, or clone this repository and use the
browser-extension/chrome-release/folder directly. - Open your browser's extensions page:
- Chrome:
chrome://extensions - Edge:
edge://extensions - Brave:
brave://extensions - Arc:
chrome://extensions - Vivaldi:
vivaldi://extensions - Opera:
opera://extensions
- Chrome:
- Enable Developer mode in the top-right corner.
- Click Load unpacked.
- Select the
chrome-releasefolder from the downloaded/cloned repository. - The Forca extension icon should appear in your toolbar. The extension will automatically connect to the Forca desktop app when it's running.
The extension must remain installed and enabled for browser blocking to work.
- Install the Forca desktop app and browser extension.
- Forca runs in the background/system tray.
- Focus zones activate automatically (after meetings via calendar integration) or manually.
- The desktop app communicates with the browser extension via a local WebSocket connection (port 7432).
- Distracting websites are blocked automatically during focus sessions using the browser's native blocking APIs.
- Focus ends automatically when the configured timer expires or the condition is met.
Forca is designed to be privacy-first:
- All data stays local by default. Focus zones, blocked sites, settings, and session history are stored on your machine using
electron-store. - No external services required. Forca works fully offline. Calendar integration and multi-device sync are optional.
- Browser extension communicates locally. The extension connects to the desktop app over a local WebSocket (
127.0.0.1:7432). No external network requests are made by the extension. - Calendar data is fetched directly from your provider (Google Calendar or iCal) and processed locally. OAuth tokens are stripped before any optional sync upload.
- Multi-device sync (optional) uses Firebase Firestore. OAuth access tokens are never included in sync payloads.
- Open source. The full source code is available for review under the MIT license.
For security vulnerability reports, see SECURITY.md.
- Make sure the Forca desktop app is running.
- Make sure the extension is installed and enabled in your browser.
- Reload the extension on your browser's extensions page.
- In Forca, go to Settings > Extension and click Reconnect.
- Restart both the desktop app and your browser.
- Open
chrome://extensions/(or your browser's equivalent). - Verify Developer mode is toggled on.
- Click Load unpacked and select the
chrome-releasefolder (not the parent directory). - The extension icon should appear. If it says "Forca", it loaded correctly.
Closing or minimizing the Forca window may leave the app running in the system tray, depending on your settings. Look for the Forca icon in your system tray (Windows) or menu bar (macOS/Linux) to access the app again. Right-click the tray icon for quick controls.
- Verify the browser extension is installed and enabled.
- Check that the site is in your zone's blocked list.
- Make sure the zone is active (not paused or ended).
- Make sure Forca is running and the extension shows as connected.
- Try restarting the extension and the desktop app.
# Clone the repository
git clone https://github.com/3iiik/Forca.git
cd Forca
# Install dependencies
npm install# Run in development mode (main + renderer hot reload)
npm run dev
# Build for production
npm run build
# Start the built app
npm start
# Type check
npm run typecheck
# Lint
npm run lintnpm run build:mac # Build for macOS
npm run build:win # Build for Windows
npm run build:linux # Build for Linux
npm run build:all # Build for all platformsThe project website is in the website/ directory and built with Astro.
cd website
npm install
npm run dev # Start dev server
npm run build # Build for production
npm run preview # Preview the buildThe browser extension source is in browser-extension/. Pre-built release copies are in:
browser-extension/chrome-release/-- for Chromium browsers (Chrome, Edge, Brave, etc.)browser-extension/firefox-release/-- for Firefox-based browsers
To load the extension for development, point your browser's "Load unpacked" to the appropriate release folder.
Forca/
├── src/
│ ├── main/ # Electron main process
│ │ ├── main.ts # App entry, window lifecycle
│ │ ├── preload.ts # Context bridge (IPC)
│ │ ├── services/ # Backend services
│ │ │ ├── zone-engine.service.ts
│ │ │ ├── blocker.service.ts
│ │ │ ├── calendar.service.ts
│ │ │ ├── websocket-server.service.ts
│ │ │ ├── tray.service.ts
│ │ │ ├── sync.service.ts
│ │ │ ├── score.service.ts
│ │ │ ├── sound.service.ts
│ │ │ ├── dnd.service.ts
│ │ │ ├── updater.service.ts
│ │ │ └── ...
│ │ ├── store/ # electron-store schema
│ │ └── ipc/ # IPC handler registrations
│ ├── renderer/ # React frontend (Vite)
│ │ ├── App.tsx
│ │ ├── components/ # UI components
│ │ ├── stores/ # Zustand state
│ │ └── hooks/
│ └── shared/ # Shared types
├── browser-extension/ # Browser extension
│ ├── background.js # Extension background script (source)
│ ├── popup/ # Extension popup UI
│ ├── blocked/ # Blocked page UI
│ ├── chrome-release/ # Pre-built Chrome/Edge/Brave package
│ └── firefox-release/ # Pre-built Firefox package
├── website/ # Project website (Astro)
├── assets/ # Icons, branding, screenshots
├── scripts/ # Build and utility scripts
├── .github/ # CI/CD workflows
├── package.json
├── vite.config.ts
├── tsconfig.json
└── README.md
Stable releases are published on GitHub Releases. Each release includes:
- Desktop installers for Windows, macOS, and Linux
- Browser extension packages (load manually for Chromium, install from Firefox Add-ons for Firefox)
The desktop app includes an auto-updater that checks for new releases on startup.
Contributions are welcome. See CONTRIBUTING.md for guidelines.
- Fork the repository.
- Create a branch:
git checkout -b feature/your-feature - Install dependencies:
npm install - Make your changes.
- Test:
npm run dev - Commit using conventional commits:
feat: add new feature - Push:
git push -u origin feature/your-feature - Open a pull request against
main.
MIT -- see LICENSE for details.