Focus Timer (Rust)

A modern, desktop-based focus timer application built with Rust and Dioxus. This application helps you manage your time using the Pomodoro technique, tracking your focus sessions and breaks with a clean, unobtrusive interface.

Features

• Focus & Break Timer: Default 25-minute work sessions and 2-minute breaks (customizable).
• Visual Progress: Circular progress indicator for easy time visualization.
• Task Management: Built-in daily task list to keep track of your goals.
• Session History: automatic tracking of daily focus and break duration.
• System Tray Support: Minimizes to the system tray to keep your taskbar clean while running in the background.
• Native Notifications:
  • Windows: Interactive Toast notifications (Start next session directly from notification).
  • macOS: Native system notifications.
• Auto-Start: Option to launch automatically on system startup.
• Cross-Platform: Fully supported on Windows and macOS.

Tech Stack

• Language: Rust
• UI Framework: Dioxus (HTML/CSS/Rust)
• Async Runtime: Tokio
• Platform Integration: tray-icon, notify-rust, tauri-winrt-notification (Windows), winreg (Windows Registry).

Building from Source

Prerequisites

• Rust Toolchain (cargo, rustc) installed.

Development

To run the application in development mode:

cargo run

Building for Release

To build an optimized release version:

cargo build --release

The executable will be located in:

• Windows: target/release/focus-timer-rust.exe
• macOS: target/release/focus-timer-rust

Note: The application requires the assets folder (containing styles and icons) to be in the same directory as the executable, which is taken care of by the build.rs file at build time.

Packaging (Manual)

If you move the executable, ensure you copy the assets directory with it:

/MyTimerApp
  ├── focus-timer-rust.exe  (or focus-timer-rust on macOS)
  └── assets/
       ├── style.css
       └── timer-svgrepo-com.svg

Configuration

Settings are saved automatically to focus_timer_config.json in the application directory. You can configure:

• Work duration
• Break duration
• Notification style (Persistent/Transient/Popup Window)
• Window size
• Startup behavior