Flux

A semi-transparent stopwatch that floats above all your windows — perfect for tracking daily tasks or any timed activity without getting in your way.

Features

• Persistent — Remembers your time if you quit and reopen the app
• Always visible — Stays on top of all windows and across all desktops
• Draggable — Position it anywhere on your screen
• Customizable — Change font, size, color, opacity, and shortcuts

Usage

Basic Controls

Action	What it does
Click	Configurable (default: none)
Right-click	Reset to 00:00
Drag	Move the timer

Keyboard Shortcuts

Shortcut	Action
Space	Pause / Resume
⌘C	Copy time (nearest minutes)
⌘S	Set a specific time
⌘Y	View history
⌘,	Open settings
⌘Q	Quit

Global Shortcuts

These work even when Flux is not focused:

Shortcut	Action
⌃⌘T	Toggle pause/resume
⌃⇧T	Copy time + Reset to 00:00

Settings

Press ⌘, to customize:

Appearance

• Font family and size
• Text color
• Opacity (how transparent the timer appears)

Shortcuts

• Rebind any keyboard shortcut
• Customize mouse click actions

General

• Launch at login
• Show in full screen (keep timer visible during fullscreen apps)

Time Display

• Under 1 hour: MM:SS (e.g., 05:30)
• 1 hour or more: H:MM:SS (e.g., 1:30:00)

Requirements

• macOS 15 (Sequoia) or later

Installation

1. Download the latest release
2. Move Flux.app to your Applications folder
3. Open Flux

To quit, press ⌘Q.

Building from Source

Requires Xcode 16+.

git clone https://github.com/user/flux.git
cd flux
xcodebuild -project Flux.xcodeproj -scheme Flux build
open build/Release/Flux.app

Or open Flux.xcodeproj in Xcode and press ⌘R.