The FBI is watching your screen.
Try to open Discord? Reddit? Twitter? FBI OPEN UP blasts at full volume until you get back to work.
Stay focused = lofi beats. Get distracted = FBI raid.
- 🎵 Lofi Mode - Chill YouTube stream while you work
- 🚨 FBI Mode - Classic meme video when you slack off (full volume, of course)
- 📊 Stats - Track focus time, distractions, and FBI trigger count
- ⚙️ Custom Blocklist - Block whatever distracts you (regex support)
- 💻 Cross-Platform - Windows 11 and macOS (Intel + Apple Silicon)
- 🔒 Privacy - No telemetry, no data collection, just judgement
- Download the latest release from Releases Page
- macOS:
- Download
vigilant-darwin-universal-vX.X.X.zip - Extract and move
vigilant.appto Applications - On first run, grant Accessibility permissions when prompted
- System Preferences → Security & Privacy → Accessibility → Add Vigilant
- Download
- Windows 11:
- Download
vigilant-windows-amd64-vX.X.X.zip - Extract and run
vigilant.exe - Click "More info" → "Run anyway" if SmartScreen blocks it
- Download
Requirements:
- Go 1.23+
- Node.js 18+ (for frontend)
- Make
Steps:
# Clone repository
git clone https://github.com/mgiovani/vigilant.git
cd vigilant
# Build and install (one command)
make install
# Or step by step:
make setup # Install dependencies
make build # Build for your OS
make dev # Development mode with hot reloadOut of the box, the FBI will raid you for:
- Apps: Discord, Steam, Battle.net
- Social: YouTube, Twitter/X, Reddit, Instagram, TikTok, Facebook, Twitch
- Streaming: Netflix, Prime Video, Disney+, Hulu, HBO Max, Paramount+
-
Locate config file:
- First launch creates:
~/.vigilant/config.yaml - Or use bundled default:
config/default.yaml
- First launch creates:
-
Edit config.yaml:
# All patterns are regex-based and case-insensitive # Patterns match both window titles AND process names blocklist: patterns: - "discord" # Matches Discord app or browser tabs - "reddit" # Matches reddit.com in browser - "youtube" # Matches YouTube (except exceptions below) - "my-game\\.exe" # Custom regex pattern # Exceptions bypass the blocklist when matched exceptions: - "youtube music" # YouTube Music won't trigger FBI - "youtube studio" # Allow content creation player: lofi_playlist: "https://www.youtube.com/watch?v=jfKfPfyJRdk" default_volume: 0.5 # 0.0-1.0 monitor: poll_interval: 100ms # Check window every 100ms grace_period: 500ms # 500ms delay before FBI meme
-
Restart Vigilant to apply changes
| Setting | Type | Default | Description |
|---|---|---|---|
blocklist.patterns |
List | See above | Regex patterns (case-insensitive, match title & process) |
exceptions |
List | [] | Regex patterns that bypass blocklist |
player.lofi_playlist |
URL | Lofi Girl stream | YouTube video/playlist URL |
player.default_volume |
Float | 0.5 | Volume level (0.0-1.0) |
monitor.poll_interval |
Duration | 100ms | How often to check active window |
monitor.grace_period |
Duration | 500ms | Delay before triggering FBI meme |
- Start Vigilant - App opens with lofi beats playing
- Work - Focus time goes up, you're being productive
- Get tempted - Switch to Discord, Reddit, YouTube...
- Grace period - You have 500ms to reconsider your life choices
- FBI OPEN UP - Meme plays at full volume until you alt-tab away
- Back to work - Lofi resumes, FBI counter increases, shame ensues
Q: YouTube says "error 153" or video won't load A: This is a common Wails issue with YouTube embedding. Try:
- Check internet connection
- Restart Vigilant
- Update to latest version
- If persists, YouTube may have changed policies (check releases)
Q: App says "Accessibility Permission Denied" (macOS) A: Grant permission:
- System Preferences → Security & Privacy → Accessibility
- Click the lock to unlock
- Click "+" button and select Vigilant application
- Restart Vigilant
Q: Windows app doesn't open / shows nothing A: The app requires Windows 11 and Microsoft Edge WebView2 runtime (pre-installed on Win11).
- Run from Command Prompt to see error messages:
.\vigilant.exe - If WebView2 is missing, the embedded bootstrapper should auto-install it
- Manual install: https://developer.microsoft.com/en-us/microsoft-edge/webview2/
Q: Windows Defender blocks the app A: This is a SmartScreen false positive for unsigned apps. You can:
- Click "More info" → "Run anyway"
- Sign the executable (future release)
- Build from source (requires Go compiler)
Q: App is using too much CPU/memory A: This shouldn't happen. Try:
- Increase
poll_intervalin config (e.g.,200msinstead of100ms) - Restart Vigilant
- Check for runaway processes in Activity Monitor / Task Manager
- Report issue on GitHub with your system specs
Q: Can I use Vigilant on Linux? A: Not yet. Linux support is planned for Phase 2.
- GitHub Issues: https://github.com/mgiovani/vigilant/issues
- Discussions: https://github.com/mgiovani/vigilant/discussions
vigilant/
├── main.go # Wails application entry point
├── internal/
│ ├── app/ # Orchestrator and bindings
│ ├── config/ # Configuration loading
│ ├── monitor/ # Window monitoring (Windows/macOS)
│ ├── blocker/ # Blocklist matching and state
│ ├── player/ # Media player control
│ └── stats/ # Statistics tracking
├── frontend/ # Svelte + Tailwind UI
│ ├── src/
│ │ ├── App.svelte # Main layout
│ │ ├── lib/components/ # UI components
│ │ ├── stores/ # State management
│ │ └── types/ # TypeScript types
│ └── package.json # Frontend dependencies
├── config/ # Configuration files
├── assets/ # Embedded assets (FBI video)
├── build/ # Build output
├── Makefile # Build automation
└── README.md # This file
make dev # Development server with hot reload
make test # Run tests
make build # Build for your platform
make clean # Clean build artifacts- Frontend changes in
frontend/src/auto-reload when usingmake dev - Run
make helpfor all available commands - See
docs/for architecture details and contributing guidelines
MIT License - See LICENSE file for details
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Commit changes with clear messages
- Push to your fork
- Open a Pull Request
Stay vigilant. The FBI is watching. 👀