diff --git a/README.md b/README.md index 80a3bf0..08f372d 100644 --- a/README.md +++ b/README.md @@ -1,25 +1,43 @@ -# Podify ๐ŸŽง +# ๐ŸŽง Podify โ€“ Your Personalized Podcast Hub -## Summary -Podify is a personalized podcast platform that recommends curated podcasts based on user-selected topics. It tracks user listening history, fetches relevant podcasts from YouTube, and ensures fresh daily content, enhancing the overall podcast listening experience. +## ๐Ÿš€ Summary + +**Podify** is a next-gen podcast platform that delivers **personalized, curated podcasts** based on your interests. It tracks your listening habits, fetches relevant podcasts from YouTube, and refreshes content dailyโ€”ensuring a seamless and engaging listening experience. + +## ๐ŸŽฌ Preview +### Home +![Podify Preview](client/public/image1.png) + +### Login +![Podify Preview](client/public/image2.png) + +### Dashboard +![Podify Preview](client/public/image3.png) + +## ๐Ÿ›  Tech Stack -## Tech Stack - **Frontend:** Next.js, React.js, TypeScript, Sass, NextAuth.js (OAuth) -- **Backend:** Java, Spring Boot, PostgreSQL (User & Topic Management), MongoDB (Podcasts Storage) +- **Backend:** Java, Spring Boot, PostgreSQL (User & Topic Management), MongoDB (Podcast Storage) - **APIs & Tools:** YouTube Data API v3, REST APIs, Scheduled Tasks, OAuth Authentication -## Features -- Personalized podcast recommendations per user -- Topic-based organization of podcasts -- Daily refresh of podcasts to keep content up-to-date -- Tracks watch history and progress per user -- Embedded video player for each podcast with smooth scroll and progress tracking -- OAuth login via Google for secure authentication +## โœจ Features + +- ๐ŸŽฏ **Personalized recommendations** based on user-selected topics +- ๐Ÿ“‚ **Topic-based organization** of podcasts for easy discovery +- ๐Ÿ”„ **Daily refresh** of podcasts to keep content fresh and relevant +- โฑ **Watch history & progress tracking** per user +- ๐Ÿ“บ **Embedded video player** with smooth playback and progress syncing +- ๐Ÿ” **OAuth login via Google** for secure authentication + +## โš™๏ธ How It Works -## How It Works 1. Users select topics โ†’ preferences saved in PostgreSQL. 2. Backend fetches top podcasts for each topic from MongoDB. -3. If podcasts are missing or outdated, backend fetches new podcasts from YouTube and updates MongoDB. -4. Frontend displays personalized podcast lists dynamically. -5. Each podcast can be played directly via the embedded video player; progress is tracked and synced to backend. -6. Scheduled daily refresh ensures fresh and relevant content while preserving user watch history. +3. If podcasts are missing or outdated โ†’ fetches new ones from YouTube & updates MongoDB. +4. Frontend dynamically displays **personalized podcast lists**. +5. Play podcasts directly via the embedded video player โ†’ progress synced to backend. +6. Scheduled **daily refresh** ensures fresh content while preserving user history. + +## ๐Ÿ’ก Why Podify? + +Podify isnโ€™t just a podcast appโ€”itโ€™s a **smart, personalized podcast experience** that adapts to your interests and keeps your listening journey fresh every day. diff --git a/client/public/image1.png b/client/public/image1.png new file mode 100644 index 0000000..760b9fb Binary files /dev/null and b/client/public/image1.png differ diff --git a/client/public/image2.png b/client/public/image2.png new file mode 100644 index 0000000..0d95f42 Binary files /dev/null and b/client/public/image2.png differ diff --git a/client/public/image3.png b/client/public/image3.png new file mode 100644 index 0000000..4cc4d90 Binary files /dev/null and b/client/public/image3.png differ