TuneFlow is an AI-powered playlist generator that seamlessly integrates YouTube and Spotify to help you discover, parse, and organize music from videos and comments into personalized playlists. Built with Next.js, Genkit, and a modern UI, TuneFlow is your all-in-one music companion! 🚀
Here are screenshots of the TuneFlow app in both dark and light mode—see the magic in action! 🌙☀️
- 🔍 Parse YouTube Comments & Descriptions
- Extract song titles and artists from YouTube comments, video descriptions, and chapters.
- Supports both direct video links and manual input.
- 🤖 AI-Powered Song Recognition
- Uses Genkit and Google Gemini AI for advanced song identification and smart recommendations.
- 🎵 Spotify Playlist Creation
- Instantly create Spotify playlists from parsed YouTube content.
- Add, remove, and manage tracks directly from the app.
▶️ YouTube Playlist Creation- Instantly create regular YouTube playlists (not YouTube Music) from parsed tracks.
- Authenticate with your Google account and export your playlist with one click.
- 🧠 Smart Caching & Performance
- Uses Redis to cache album art and API responses for fast, efficient browsing.
- 🌙 Dark Mode & Accessibility
- Beautiful, accessible UI with Radix UI and Shadcn/ui, plus dark mode support and Dark Reader compatibility.
- 🔑 Secure Authentication
- OAuth-based Spotify login; API keys and tokens are securely managed.
- 🛠️ Developer-Friendly
- Well-documented codebase with JSDoc comments, clear sectioning, and easy onboarding for contributors.
Here are some ideas and plans for expanding TuneFlow in the future:
| Feature | Status | Notes |
|---|---|---|
| ✅ Done | Create regular YouTube playlists directly from parsed tracks. (YouTube Music not supported.) Note: I need to get the app approved for public use on Google OAuth. | |
| 🌗 Day/Night Toggle | ✅ Done | Implement a seamless toggle between light and dark modes, allowing users to switch themes for optimal comfort and accessibility at any time. |
| 📱 Optimize for Mobile Layouts | 🚧 In Progress | Enhance TuneFlow's UI and user experience for mobile devices. This includes responsive layouts, touch-friendly controls, and streamlined navigation—so you can create and manage playlists seamlessly on any screen, anywhere! |
| 🍏 Apple Music API | 🕒 Planned | Explore adding Apple Music integration for broader playlist export options. |
| 🧠 Advanced Song Detection | 🕒 Planned | Detect songs in videos even without tracklists in description/comments using AI/audio. |
| 🎼 YT Music Connection | 🕒 Planned | Explore connecting to YouTube Music for playlist creation if supported by YouTube. |
| 🎧 SoundCloud API Integration | ⏸️ Paused | Backend implemented, but feature is paused until API keys/support resume after May 2. |
Have more ideas? Feel free to open an issue or submit a pull request!
- Next.js – React framework for building web applications
- Genkit – AI development platform
- Google Gemini – Multimodal AI model
- Radix UI & Shadcn/ui – Accessible, customizable UI components
- Spotify API – Music catalog and playlist management
- YouTube API – Video and comment data extraction
- Redis – Fast caching and data storage
next,react,react-dom@genkit-ai/core,@genkit-ai/googleai,@genkit-ai/next@radix-ui/react-*,shadcn/uiclass-variance-authority,clsx,lucide-react,tailwind-merge,tailwindcss-animateioredis,googleapis,youtube-chapters-finder
-
Clone the repository:
git clone https://github.com/<your-username>/TuneFlow.git cd TuneFlow
-
Install dependencies:
npm install # or yarn install -
Set up environment variables:
- Create a
.env.localfile based on.env.example. - Required variables:
SPOTIFY_CLIENT_ID,SPOTIFY_CLIENT_SECRET,SPOTIFY_REDIRECT_URIYOUTUBE_API_KEYGOOGLE_GENAI_API_KEYREDIS_URL(optional, defaults to local Redis)
- Create a
-
Run the development server:
npm run dev # or yarn dev -
Open http://localhost:3000 and start creating playlists!
Contributions are welcome! Please open issues or submit pull requests for new features, improvements, or bug fixes. Be sure to follow the code style and documentation conventions for consistency.
This project displays its Privacy Policy, Terms of Use, GDPR Policy, and Data Opt-Out as styled pages.
If you clone this repo, you must provide the following markdown files in the public/ directory for these pages to work. You can edit these files to match your own requirements:
- Privacy Policy:
public/PRIVACY_POLICY.md→/privacy-policy - Terms of Use:
public/TERMS_OF_USE.md→/terms-of-use - GDPR Policy:
public/GDPR_POLICY.md→/gdpr-policy - Data Opt-Out:
public/DATA_OPT_OUT.md→/data-opt-out
Each page is accessible from the site footer. For GDPR compliance and user trust, make sure these documents are up to date and provide clear instructions for users to exercise their rights or opt out of data collection.
MIT License. See LICENSE for details.
- Inspired by the power of open music and AI.
- Built with ❤️ by the TuneFlow community.