Skip to content

Focus Mode App v1.0.0

Choose a tag to compare

View all tags
@gorlix gorlix released this 01 Nov 23:14
· 77 commits to main since this release
v1.0.0
1fac5f2
This commit was signed with the committer’s verified signature.
gorlix Alessandro Gorla
SSH Key Fingerprint: wHlAKc4wAYzYHTMPpXxk1S9PJUPaNwd2szm0eJeN8fY
Verified
Learn about vigilant mode.

First stable release - Block distracting apps and websites to boost your productivity on Linux.

✨ Features

Core Functionality

  • 🚫 Block Native Apps - Stop any Linux application (Firefox, Telegram, Steam, etc.)
  • 🌐 Block Web Apps - Block specific websites and web applications
  • ⚡ Real-time Monitoring - Automatic process checking every 2 seconds
  • 🔄 Instant Toggle - Enable/disable blocking without closing the app

Interface

  • 🎨 Material 3 GUI - Modern, clean interface with ttkbootstrap
  • ⌨️ Full CLI - Complete command-line interface with rich formatting
  • 🖱️ System Tray - KDE Plasma native tray icon with PyQt6
  • 📋 List Management - Add, remove, and view blocked items easily

Advanced

  • 💾 Persistent Config - Your settings are automatically saved
  • 🔄 Session Restore - Restore killed apps with original window positions (X11)
  • 📊 Status Display - See blocking state and item count at a glance

🚀 Quick Start

# Install
git clone https://github.com/gorlix/focus-mode-app-linux
cd focus-mode-app-linux
pip install -r requirements.txt

# Run GUI
python main.py

# Or use CLI
./study-mode-cli.py add firefox app
./study-mode-cli.py start

📋 Requirements

  • Linux (KDE Plasma recommended)
  • Python 3.9+
  • X11 (Wayland has limited features)
  • Dependencies: ttkbootstrap, psutil, PyQt6, Pillow, rich

🐛 Known Issues

  • System tray may not work on Wayland (use X11)
  • Session restore requires xdotool package
  • Browser tabs are not restored (coming in v1.1.0)

📄 License

MIT License - Free to use, modify, and distribute.

Full Changelog: https://github.com/gorlix/focus-mode-app-linux/commits/v1.0.0

Assets 2
Loading