title	description	language	library	license	repo	author	email
HebrewCard	A fun and interactive Hebrew letters training program written in C++ using Allegro and AllegroPP.	C++	Allegro	GPL v2.0	https://github.com/eduardoaguiar-oss/hebrewcard	Eduardo Aguiar	aguiar@protonmail.ch

HebrewCard

HebrewCard is a fun and interactive Hebrew letters training program written in C++ using the Allegro game library and the AllegroPP C++ wrapper library. Whether you're learning Hebrew or just want to practice your letter recognition, HebrewCard provides an engaging way to master the Hebrew alphabet.

---

Features

• Interactive Flashcards: Practice Hebrew letters with a visually appealing flashcard system.
• Randomized Order: Letters are presented in random order to enhance learning.
• Simple and Intuitive Interface: Easy-to-use interface designed for learners of all ages.
• Cross-Platform: Built with Allegro, HebrewCard runs on Windows, macOS, and Linux.

---

Screenshots

Main screen showing a Hebrew letter flashcard.

---

Installation

Prerequisites

Before building HebrewCard, ensure you have the following installed:

• Allegro 5: The core game library.
• AllegroPP: The C++ wrapper library for Allegro (available at AllegroPP GitHub).

Building from Source

1. Clone the repository:

   git clone https://github.com/eduardoaguiar-oss/hebrewcard.git
   cd hebrewcard

2. Build the project:

   mkdir build
   cd build
   cmake ..
   make

3. Run the program:

   ./hebrewcard

---

Usage

• Start the Program: Launch HebrewCard to begin your Hebrew letter training session.
• Navigate Flashcards: Use the arrow keys or mouse to flip through the flashcards.
• Exit: Press ESC or close the window to exit the program.

---

Contributing

Contributions are welcome! If you'd like to contribute to HebrewCard, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Commit your changes.
4. Submit a pull request.

For major changes, please open an issue first to discuss your ideas.

---

License

HebrewCard is licensed under the GNU General Public License v2.0. See the LICENSE file for details.

---

Acknowledgments

• Allegro: For providing a powerful and easy-to-use game development library.
• AllegroPP: For simplifying Allegro usage in C++.
• You: For using HebrewCard and supporting open-source software!

---

Contact

For questions, suggestions, or feedback, feel free to reach out:

• GitHub Issues: Open an Issue
• Email: aguiar@protonmail.ch

---

Happy learning! 📖✨