Skip to content

v0.2.0 - Sound Notifications & Multi-Platform CI

Choose a tag to compare

View all tags
@frbelotto frbelotto released this 02 Dec 02:56
· 21 commits to main since this release
0.2.0
74894c0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🎉 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
Assets 2
Loading