# Automated Page Turn Audio Player for Performers and Composers

This project aims to create a seamless experience for performers and composers by automating page turns and synchronizing score and audio files in real-time. The tool allows performers to add markers to their score, eliminating the need for manual tracking and ensuring smoother coordination during performances.

## Features

- **Automated Page Turns**: Add markers to automatically trigger page turns in the score.
- **Audio and Score Synchronization**: Coordinates audio playback with score progression, reducing missed cues.
- **Customizable Markers**: Users can set custom markers for specific locations in the score, linking them to audio playback.
- **Improved Performer Experience**: Streamlines the performance workflow by eliminating distractions related to page-turning and manual tracking.

## Installation

To run this project locally, clone the repository and follow these steps:

### Prerequisites

- **Operating System**: Works on Windows, macOS, and Linux.
- **Dependencies**: Make sure you have the following installed:
  - [JUCE](https://juce.com/) for audio processing and UI
  - [Poppler](https://poppler.freedesktop.org/) for PDF rendering (if used)
  - [FFTW](http://www.fftw.org/) (optional, for FFT operations in audio processing)

### Steps

1. Clone the repository:
   ```bash
   git clone https://github.com/yourusername/project-name.git

2. Open the project in JUCE's Projucer:

   open project-name.jucer

3. Build the project in your preferred IDE (e.g., Xcode, Visual Studio).

4. Run the audio player and start adding markers to your scores!

Usage

1. Add Audio and Score Files: Drag and drop your audio and score files into the player.
2. Add Markers: Place markers at specific points in the score where you want automatic page turns.
3. Synchronize Audio: Play the audio, and the tool will automatically track the playback and trigger the corresponding page turns in the score.
4. Customize: Adjust the settings for marker types, playback preferences, and display options according to your needs.

Contributing

We welcome contributions! If you'd like to improve the project, fix bugs, or add new features, feel free to open a pull request.

Steps to contribute:

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

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• JUCE Framework
• Poppler Library for PDF handling
• FFTW Library for FFT operations (optional)

Author

• Enqi Lian
• enqilian619@gmail.com

---

© 2024 Enqi. All rights reserved.

You can now directly paste this into your `README.md` file, and it will be formatted correctly on GitHub.