Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/matinmollapur01/openharmoni

OpenHarmoni is a feature-rich Flutter application designed to enhance your productivity and relaxation experience.
https://github.com/matinmollapur01/openharmoni

android app application flutter flutter-app flutter-apps ios linux macos pomodoro pomodoro-timer relaxation sounds windows

Last synced: 14 days ago
JSON representation

OpenHarmoni is a feature-rich Flutter application designed to enhance your productivity and relaxation experience.

Awesome Lists containing this project

README 

        
# 🎵 OpenHarmoni





  OpenHarmoni Logo






  Harmonize Your Productivity and Relaxation






  Flutter Version

  Dart Version

  License: MIT

  GitHub stars






  Key Features •

  Installation •

  How To Use •

  Customization •

  Localization •

  Roadmap •

  Contributing •

  License •

  Acknowledgements




## 🌟 Key Features



OpenHarmoni is a feature-rich Flutter application designed to enhance your productivity and relaxation experience:



- 🎶 **Immersive Sound Mixing**: Create your perfect ambiance with our extensive library of relaxing sounds.

- ⏱️ **Pomodoro Technique Integration**: Boost your productivity with customizable work and break intervals.

- 🌓 **Adaptive Theming**: Seamlessly switch between dark and light modes for optimal viewing comfort.

- 🌍 **Global Accessibility**: Enjoy the app in multiple languages, making it accessible worldwide.

- 📊 **Progress Tracking**: Monitor your productivity with detailed daily statistics.

- 🎚️ **Advanced Audio Customization**: Fine-tune your audio experience with our built-in equalizer.

- 💾 **Personalized Sound Mixes**: Save and load your favorite sound combinations.

- 🔔 **Custom Notifications**: Set unique alert sounds for different Pomodoro phases.

- 📱 **Cross-Platform Compatibility**: Available on both iOS and Android devices.



## 🚀 Installation



Get started with OpenHarmoni in just a few steps:



### Prerequisites



Ensure you have the following installed:

- Flutter SDK (^3.5.1)

- Dart SDK (^3.5.1)

- Android Studio / Xcode (for mobile development)



### Setup



1. Clone the repository:

   ```bash

   git clone https://github.com/MatinMollapur01/OpenHarmoni.git

   ```



2. Navigate to the project directory:

   ```bash

   cd OpenHarmoni

   ```



3. Install dependencies:

   ```bash

   flutter pub get

   ```



4. Run the app:

   ```bash

   flutter run

   ```



## 💻 How To Use



OpenHarmoni offers a user-friendly interface with three main sections:



### 1. Relaxing Sounds



- Explore diverse sound categories: Nature, Ambient, and White Noise.

- Adjust individual sound volumes to create your perfect mix.

- Save custom mixes for quick access in future sessions.

- Use the equalizer to personalize your audio experience.



### 2. Pomodoro Timer



- Customize work and break durations to suit your productivity style.

- Start, pause, and reset the timer as needed.

- Track your daily progress with detailed statistics.

- Receive notifications when each Pomodoro session ends.



### 3. Settings



- Toggle between dark and light themes.

- Select your preferred app language.

- Customize notification sounds for work and break periods.

- Adjust general app preferences to tailor your experience.



## 🎨 Customization



OpenHarmoni is designed with customization in mind:



- **Themes**: Easily switch between dark and light modes or create your own custom theme.

- **Sound Library**: Add your own sounds to the existing library for a truly personalized experience.

- **Pomodoro Settings**: Adjust work/break ratios, long break intervals, and more to match your workflow.

- **Notification Preferences**: Set custom sounds and vibration patterns for different alerts.



## 🌐 Localization



OpenHarmoni speaks your language! Currently supported languages include:



- English (en)

- Arabic (ar)

- Azerbaijani (az)

- Spanish (es)

- Persian (fa)

- Russian (ru)

- Turkish (tr)

- Chinese (zh)



To add or modify translations:

1. Navigate to the `lib/l10n/` directory.

2. Edit the corresponding `.arb` file for your language.

3. If adding a new language, create a new `.arb` file and update `lib/l10n.yaml`.



## 🤝 Contributing



We welcome contributions from the community! Here's how you can help:



1. Fork the Project

2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)

3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)

4. Push to the Branch (`git push origin feature/AmazingFeature`)

5. Open a Pull Request



Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.



## 📄 License



This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.



## 🙏 Acknowledgements



OpenHarmoni stands on the shoulders of giants. We'd like to thank:



- [Flutter](https://flutter.dev/) - UI toolkit for building natively compiled applications

- [Provider](https://pub.dev/packages/provider) - State management solution

- [AudioPlayers](https://pub.dev/packages/audioplayers) - Audio playback library

- [SQLite](https://pub.dev/packages/sqflite) - Database solution for local storage

- [flutter_local_notifications](https://pub.dev/packages/flutter_local_notifications) - Notifications plugin

- All our contributors and users who make this project possible!



## 📬 Contact



Matin Mollapur - [@MatinMollapur](https://twitter.com/matin_mollapur) - [email protected]



Project Link: [https://github.com/MatinMollapur01/OpenHarmoni](https://github.com/MatinMollapur01/OpenHarmoni)



---





  Made with ❤️ by Matin Mollapur






  Flutter Logo