Release v0.3.2

Full Changelog: v0.3.1...v0.3.2

FreeTimerAlert v0.3.1

Release v0.3.1 with executables for Linux, macOS, and Windows.

Downloads

• Linux: FreeTimer-Linux-v0.3.1.zip
• macOS: FreeTimer-macOS-v0.3.1.zip
• Windows: FreeTimer-Windows-v0.3.1.zip

Changes

• Fixed Unicode encoding issues in build script for Windows
• Switched from print() to logger for build messages
• Improved cross-platform compatibility

Full changelog: v0.3.0...v0.3.1

FreeTimer 0.3.0 – Desktop GUI (Tkinter)

Highlights

• Desktop GUI interface (Tkinter): Main window, timer widgets, and create timer dialog
• System notifications integration and sound handling
• CI stability across Linux, macOS, Windows (Xvfb for Linux; skip GUI on macOS CI when Tcl/Tk missing)
• Terminal interface moved to src/interfaces/terminal

Breaking/Changes

• Entry points: use and
• Requires Python >= 3.11

How to use

• Terminal: \n\n\tuv run python main.py --mute\n\n- GUI: \n\n\tuv run python gui.py\n\nSee README for more.

What's Changed

• feat: Desktop GUI Interface Implementation (Tkinter) by @frbelotto in #5

Full Changelog: 0.2.0...v0.3.0

v0.2.0 - Sound Notifications & Multi-Platform CI

🎉 First Official Release

This is the first production-ready release of FreeTimer, a terminal-based timer application with clean architecture.

---

✨ What's New

🔊 Sound Notifications

• Audio alerts when timers start and finish
• Graceful error handling (continues working even without audio backend)
• Mute support via --mute flag or FREETIMER_MUTE environment variable
• Included sound assets: clock-start.mp3 and timer-terminer.mp3

🤖 Continuous Integration

• Automated testing on Ubuntu, Windows, and macOS
• GitHub Actions workflow ensures cross-platform compatibility
• Tests run automatically on every Pull Request to main branch

🧪 Enhanced Testing

• Added unit tests for notification system
• Mock-based testing for audio playback
• Verification of required sound assets

---

🔧 Improvements

• Documentation: Updated README with Linux audio requirements and architecture diagrams
• Project Structure: Cleaned up .gitignore for better organization
• Code Quality: Comprehensive test coverage for all core functionality

---

📦 Installation

git clone https://github.com/frbelotto/FreeTimerAlert.git
cd FreeTimerAlert
uv sync
uv run python main.py

---

🖥️ Platform Compatibility

• ✅ Linux (tested)
• ✅ macOS
• ✅ Windows

---

📋 Requirements

• Python 3.11+
• Dependencies: playsound3, rich (auto-installed via uv sync)

---

🚀 What's Next?

Future versions will include:

• Desktop GUI (Tkinter or Pyside6)
• Web interface
• Additional timer features