a-mabe/OpenHIIT

OpenHIIT

Integration Tests Nightly Build Pre-Release Release

https://raw.githubusercontent.com/a-mabe/OpenHIIT/HEAD/assets/icon/openhiit-ios.png

https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png https://raw.githubusercontent.com/a-mabe/OpenHIIT/HEAD/docs/images/Google_Play_Badge.svg Get it at IzzyOnDroid https://raw.githubusercontent.com/a-mabe/OpenHIIT/HEAD/docs/images/Download_on_the_App_Store_Badge_US-UK_RGB_blk_092917.svg

OpenHIIT is a free, open-source interval timer app built with Flutter. Create unlimited workout timers with custom audio/visual cues. No ads, no paywalls, no subscriptions.

▶️ The background timer package is developed separately here.

Table of Contents

1. Why OpenHIIT?
2. Features
3. Roadmap
4. Installation
5. Usage
6. Support
7. Contributing
8. License

---

Why OpenHIIT?

• No limits — create as many timers and workouts as you want.
• No paywalls — every feature is free, forever.
• No ads or subscriptions — open-sourced under the MIT license.

---

Features

⏲️ Customizable Timers	Build interval timers.
🔊 Visual & Audio Cues	Stay on track with cues for every interval transition.
💾 Save & Load	Store unlimited timer configurations.
📱 Export & Import	Export and share timer configs or import configs.
🖌️ Color Coding	Color-code your timers to keep your routines organized.
🏋️ Exercise Labels	Add exercise names that display on-screen while the timer runs.

https://github.com/user-attachments/assets/2d64f356-526b-419e-8b71-cc43bf8da65b     https://github.com/user-attachments/assets/8ada8439-deae-47ea-b76c-96c49cfdf914     https://github.com/user-attachments/assets/4b470c2f-96db-4e01-95c9-228cccb65316     https://github.com/user-attachments/assets/a74e76e5-4608-4303-a751-e156f1645335

---

Roadmap

Check out the OpenHIIT Roadmap to see planned features, work in progress, and ideas under consideration. Have a suggestion? Open an issue or start a discussion.

---

Installation

Download the App

https://raw.githubusercontent.com/a-mabe/OpenHIIT/HEAD/docs/images/Google_Play_Badge.svg    https://raw.githubusercontent.com/a-mabe/OpenHIIT/HEAD/docs/images/Download_on_the_App_Store_Badge_US-UK_RGB_blk_092917.svg

Build from Source

1. Install Flutter — follow the official Flutter installation guide to set up Flutter and the Dart SDK.

2. Clone the repository:

   git clone https://github.com/a-mabe/openhiit.git
   cd openhiit
   

3. Install dependencies:

   flutter pub get
   

4. Run the app — connect a device or start an emulator, then:

   flutter run
   

---

Usage

1. Create a timer — tap the "+" button to start a new interval timer.
2. Customize intervals — set your work, rest, and transition durations.
3. Add exercises — label each interval with the exercise name to display on screen.
4. Save your config — save the timer for quick access in future sessions.
5. Start your workout — follow the visual and audio cues through each interval.
6. Share or reuse — export your timers to share with others or import them on a new device.

---

Support

Encountering an issue? Visit the support page for troubleshooting guidance and known issues.

---

Contributing

Contributions are welcome! Please open an issue before creating a PR. To begin working on an issue:

1. Fork the repository on GitHub.
2. Create a new branch with a descriptive name (e.g., feature/rest-round-alerts).
3. Make your changes, following the project's coding style.
4. Commit and push your changes to your fork.
5. Open a pull request describing what you changed and why.

Please check the Roadmap and open issues before starting work to avoid duplication.

---

License

OpenHIIT is released under the MIT License. You're free to use, modify, and distribute this app under those terms. See the LICENSE file for full details.