Skip to content

Adding a readme #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
SarthDhakade963 merged 2 commits into from
Sep 22, 2025
Merged

Adding a readme #3

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c2d0a8e
Create README.md
SarthDhakade963 Sep 22, 2025
97d84ea
Equalizing commits on dev branch
SarthDhakade963 Sep 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Podify 🎧

## 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.

## Tech Stack
- **Frontend:** Next.js, React.js, TypeScript, Sass, NextAuth.js (OAuth)
- **Backend:** Java, Spring Boot, PostgreSQL (User & Topic Management), MongoDB (Podcasts 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

## 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.
Loading