MyPomodoro

A simple Pomodoro timer application built with Rust and egui.

Features

• Customizable work and break durations
• Visual timer display with doughnut-shaped progress indicator
• Sound notifications when phases complete
• Simple and intuitive interface

Building from Source

Prerequisites

• Rust and Cargo (https://www.rust-lang.org/tools/install)
• cargo-bundle (cargo install cargo-bundle)

Building for Windows

To build a Windows executable bundle (.exe/.msi):

# On Windows
./build.bat

# On any platform with cross-compilation setup
./build.sh --windows

The Windows bundle will be created in target/release/bundle/msi/.

Building for macOS

To build a macOS application bundle (.app):

# On macOS
./build.sh --macos

# On any platform with cross-compilation setup
./build.sh --macos

The macOS bundle will be created in target/release/bundle/osx/.

Building for All Platforms

To build for all supported platforms:

./build.sh --all

Testing the Generated Bundles

Windows (.exe/.msi)

1. Navigate to target/release/bundle/msi/
2. Run the installer (.msi) file
3. Launch the application from the Start Menu
4. Verify that:
   • The application launches correctly
   • The timer functions properly
   • Sound notifications work when a phase completes
   • Settings can be adjusted

macOS (.app)

1. Navigate to target/release/bundle/osx/
2. Open the .app bundle
3. If prompted about an unidentified developer, right-click the app and select "Open"
4. Verify that:
   • The application launches correctly
   • The timer functions properly
   • Sound notifications work when a phase completes
   • Settings can be adjusted

Platform-Specific Considerations

Windows

• The application uses the Windows subsystem flag to prevent console windows from appearing
• Icons are automatically converted to the appropriate format (.ico)
• The installer includes necessary metadata for proper installation

macOS

• The application is bundled as a standard .app package
• Icons are automatically converted to the appropriate format (.icns)
• The bundle includes proper metadata for macOS application requirements
• Minimum supported macOS version is 10.13 (High Sierra)

Cross-Platform Audio

The application uses the rodio crate for cross-platform audio playback, ensuring sound notifications work consistently across different operating systems.

Thanks to

• Sound of bell: [Springin' Sound Stock] (https://www.springin.org/sound-stock/ )