📖 Surah Rehman Recitation App

A beautifully designed Streamlit web application that displays each verse of Surah Rehman in Arabic, synchronized with audio playback.

---

🌟 Features

• 🎧 Full audio playback of the Surah Rehman (055.mp3)
• 🕋 Almost all 78 verses appear synchronized with audio using OPENAI whisper
• 🌙 Elegant UI with stylish Arabic font and centered layout
• ✅ Built with Streamlit — easy to run locally

---

📥 Clone the Project

git clone https://github.com/iqra-khan740/surah-rehman-app.git
cd surah-rehman-app

---

🛠 Installation

Make sure Python and streamlit are installed:

pip install streamlit

---

🚀 Run the App

Run it using either of the following commands:

streamlit run surah_rehman_app.py

or

python -m streamlit run surah_rehman_app.py

---

🗂 Project Structure

📁 surah-rehman-app/
│
└── surah_rehman_app.py          # Main Streamlit app file
└── 055.mp3                     # Surah Rehman recitation audio file
└── README.md                   # Project documentation
└── requirements.txt            # Required dependencies
└── Dockerfile                  # For better development and production
📁 data/
│
└── verses_with_delay.json            # Pre-generated verse transcripts with timestamps

---

🎧 Transcript Generation

The verse transcripts with timestamps (stored in verses_with_delay.json) were generated using OpenAI Whisper in Google Colab.
This preprocessing step was performed separately and is not part of the main app code.
The Streamlit app only consumes the pre-generated file to display verses in sync with audio.

---

🐳 Run with Docker

1. Build the Docker image:

   docker build -t surah-rehman-app .

2. Run the container (mapping container port 8501 to host port 8080):

   docker run -p 8080:8501 surah-rehman-app

3. Open your browser and visit: http://localhost:8080

---

📌 Credits

• 📝 Developed by: Iqra Khan
• 💡 Inspired by: Hamza Mehmood
• 💻 Built using: Streamlit

---

“فَبِأَيِّ آلَاءِ رَبِّكُمَا تُكَذِّبَانِ”
"Then which of the favors of your Lord will you deny?"

---

🔗 You can check it out using this link:
👉 https://surah-rehman-app.streamlit.app/

🌐 Follow for updates and contributions are welcome!