🎧 Ytosko's Groove

Ytosko's Groove: Your personal AI DJ. Describe any mood, genre, or vibe, and let our AI generate the perfect custom playlist and album art for you. Discover and create music like never before.

🌐 Live Demo: https://music.ytosko.ix.tc/

---

🚀 Features

• 🎶 Generate AI-powered music playlists based on mood, genre, or vibe
• 🖼️ Automatically generate custom album art using AI
• 💾 Works offline using IndexedDB for data storage
• ⚡ Built with React 19 and Vite 6 for speed and simplicity
• 🔐 Gemini AI integration via secure API key

---

🧪 Tech Stack

• React 19
• Vite 6
• Gemini AI (@google/genai)
• idb (IndexedDB wrapper)
• TypeScript

---

📦 Getting Started

🔧 Prerequisites

• Node.js (LTS recommended)
• A Gemini API key

---

💻 Run Locally

1. Clone the repository:

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

2. Install dependencies:

   npm install

3. Configure environment variables:

   Create a .env.local file and add your Gemini API key:

   GEMINI_API_KEY=your_api_key_here

   📺 YouTube API Setup

   To enhance functionality with YouTube data, you'll need a RapidAPI key for the YouTube v3 Alternative API. Follow these steps:

   1. Sign up at RapidAPI:
      👉 https://rapidapi.com/auth/sign-up

   2. Visit the API page:
      👉 YouTube v3 Alternative API

   3. Subscribe to the API:
      Click the Subscribe to Test button (No credit card required).

   4. Get your API key:
      On the API's endpoint page, look at the code examples on the right. Find the header named x-rapidapi-key.

   5. Copy your key
      This is a long string next to x-rapidapi-key.

   6. Add the key to your project:
      Open /services/youtubeService.ts and paste the API key where it's needed.

   ---

4. Start the development server:

   npm run dev

   Open http://localhost:5173 in your browser.

---

🔨 Build for Production

To generate a production-ready build:

npm run build

To preview the production build locally:

npm run preview

---

🌐 Deployment

You can deploy this app to any static hosting provider such as:

• Vercel
• Netlify
• GitHub Pages

After building, upload the dist/ folder to your host.

Live Version is hosted at:
🔗 https://music.ytosko.ix.tc/

---

📜 Metadata

{
  "name": "Ytosko's Groove",
  "description": "Ytosko's Groove: Your personal AI DJ. Describe any mood, genre, or vibe, and let our AI generate the perfect custom playlist and album art for you. Discover and create music like never before.",
  "requestFramePermissions": []
}

---

📄 License

This project is licensed under the MIT License.