0.4

🚀 Tileen v0.4 — Official Release Notes

Tileen is a modern, feature-packed macOS focus and timer sequence manager designed to boost productivity with multi-step workflows, full-screen break enforcement, dynamic audio ringtones, global shortcuts, and real-time focus analytics.

⸻

✨ Key Features & Highlights

⏱️ Advanced Multi-Step Timer Sequences
• Flexible Step Workflows: Create multi-step routines combining Focus, Short Break, Long Break, and custom tasks with custom durations, emojis, and colors.
• Progression Modes:
• Auto-Advance: Seamlessly transition from one step to the next upon completion.
• Manual Progression: Require user confirmation before proceeding to the next step.
• Loop Sequence: Automatically restart the sequence upon reaching the final step.
• In-Place Library Editing & Wiggle Mode:
• Edit sequence titles, descriptions, and step timers directly in the dashboard card.
• Interactive Wiggle Animation when editing steps for intuitive drag-and-drop reordering.
• Quick Action Toolbar: Cut, Copy, Paste, Duplicate, and Delete timer steps with one click.
• Favorites & Smart Sorting: Star favorite sequences and sort your library by Last Modified, Name (A-Z), or Favorites First.
• Active State Tracking: Real-time detection of unsaved sequence modifications with convenient "Save Active to Library" prompt.

⸻

🔔 Custom Audio Ringtones & File Chooser
• Ringtone Picker: Choose from a variety of built-in system sound effects (Glass, Chime, Bell, Gong, Synth, Radar, Beacon, and more).
• Custom Audio Files: Select any .mp3, .wav, or .aiff file from your Mac via native file picker.
• Loop & Repeat Controls: Set ringtone repeat counts (1x, 2x, 3x, 5x, 10x) or configure infinite looping until manually silenced.

⸻

🛡️ Full-Screen Focus Shield Overlay
• Immersive Overlay: Option to trigger a full-screen focus overlay on completion or break start to eliminate screen distractions.
• Background Media Options:
• Current desktop wallpaper / screensaver background style.
• Custom image file selector.
• Preset color gradients & solid dark backdrop.
• Enforced Skip Controls:
• Unskippable Mode: Forces you to complete your designated break before returning to work.
• Timed Skip: Enable skip button only after a specified time threshold (e.g., must rest for at least 30 seconds).
• Instant Skip: Skip anytime with customizable confirmation.
• Preset Management: Save custom overlay configurations as reusable presets.

⸻

⌨️ Global Background Hotkeys
• System-Wide Control: Control your timer from any app using global macOS hotkeys.
• ⏯️ Play / Pause
• 🔄 Reset Step
• ⏭️ Skip Step
• 📝 Jot Quick Note
• Shortcut Picker: Pick shortcuts from a handy dropdown list or record custom key combinations.
• Accessibility Health Check: Live indicator showing macOS Accessibility permission status with direct grant access prompts.

⸻

📊 Smart Session Analytics & Notes
• Focus vs. Break Ratio: Visual distribution bar comparing focus time against break time and pause duration.
• Session History Log: Automatically logs completed sessions with detailed breakdowns of real elapsed time vs focus time.
• Timer Session Notes:
• Quick timestamped note creation sheet during active sessions.
• Dedicated Session Notes management view with sorting by Date, Step Title, or Sequence Name.
• Standalone floating window controller for note reflections.

⸻

🖥️ macOS Menu Bar & Glassy UI
• Menu Bar Popover: Quick-access popover with live dynamic timer gauge ring and countdown display.
• Clean Center Gauge: Minimalist icon-only note toggle inside the menu bar timer ring.
• Dynamic Menu Bar Text: Shows live countdown formatted right in the macOS menu bar status item.
• App Theme Selector: Supports Light Theme, Dark Theme, and System Default.

⸻

🛠️ Technical Details & Requirements
• OS Requirement: macOS 13.0 (Ventura) or later.
• Architecture: Native Apple Silicon & Intel Universal Binary.
• Frameworks: SwiftUI, AppKit, AVFoundation, Carbon Global Hotkeys.

⸻

📥 Installation

1. Download Tileen.app or release zip from GitHub Releases.
2. Drag Tileen.app into your /Applications folder.
3. Open Tileen and grant Accessibility permissions when prompted if you wish to enable global background hotkeys.

⸻