🎧 PodStream

PodStream is a sleek and intuitive podcast discovery app built with Angular. It allows users to search for podcasts, view details, and listen to episodes directly from the browser. Powered by the iTunes Search API, PodStream delivers a smooth experience for podcast lovers.

🌟 Features

• 🔍 Search for podcasts by name, topic, or keyword using the iTunes API
• 📋 Display a list of matching podcasts with titles, artwork, and publisher info
• 🎧 View and browse episodes of a selected podcast
• ▶️ Play and pause podcast episodes within the app
• ⏭ Navigate between episodes using next/previous controls
• 📂 View episode details including title, release date, and description
• 🔄 Dynamic update of podcast list based on new searches
• 📱 Fully responsive design support.

🧩 Tech Stack

Frontend

• Angular 19
• Angular Material
• HTML + SCSS

Backend

• Java Spring Boot
• REST API integration with iTunes Search API

🚀 Getting Started

Prerequisites

• Node.js & npm
• Angular CLI
• Java 17+
• Maven

Run Frontend

cd podstream-frontend
npm install
ng serve

Run Backend

cd podstream-backend
./mvnw spring-boot:run

🌐 API Used

• iTunes Search API Docs: https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api/

📷 Screenshots

📄 License

This project is open-source and available under the MIT License.

👥 Contributing

We welcome contributions to PodStream! Whether it's fixing bugs, improving UI, optimizing performance, or suggesting new features—your help makes this project better.

🛠 How to Contribute

1. Fork the repository

2. Clone your fork locally

   git clone https://github.com/your-username/podstream.git
   cd podstream

3. Create a new branch

   git checkout -b your-feature-name

4. Make your changes

5. Commit your changes

   git commit -m "Add: short description of feature"

6. Push to your fork

   git push origin your-feature-name

7. Create a Pull Request with a clear title and description

📌 Guidelines

• Follow the Angular style guide
• Write meaningful commit messages
• Test your code before submitting
• Link related issues in your PR if applicable

👤 Author

Owner: Dharaneesh J
Role: Developer, Designer, and Maintainer of PodStream

If you have any feedback, ideas, or just want to say hi—feel free to open an issue or reach out!

Contact

For questions or collaboration, please reach out: Email: j.dharaneesh12@gmail.com
GitHub: https://github.com/J-DHARANEESH