/OpenHarmoni

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

Primary LanguageDart

🎵 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:

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

  2. Navigate to the project directory:

    cd OpenHarmoni

  3. Install dependencies:

    flutter pub get

  4. Run the app:

    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 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 file for details.

🙏 Acknowledgements

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

  • Flutter - UI toolkit for building natively compiled applications
  • Provider - State management solution
  • AudioPlayers - Audio playback library
  • SQLite - Database solution for local storage
  • flutter_local_notifications - Notifications plugin
  • All our contributors and users who make this project possible!

📬 Contact

Matin Mollapur - @MatinMollapur - matinmollapur01@proton.me

Project Link: https://github.com/MatinMollapur01/OpenHarmoni

Made with ❤️ by Matin Mollapur

Flutter Logo