Skip to content

jasurlive/PlaylistGo

Repository files navigation

🎧 DJ YouTube Music Player 🎡 (in TypeScript)

Reinventing the bike 🚲 with beats and code!

Welcome to PlaylistGo, an open-source, web-based music player built in TypeScript that lets you search and play songs directly from YouTube using a simple Excel playlist sheet. Whether you're here to vibe or to code, this project is for you! πŸŽ‰βœ…πŸ”β™»οΈ

DJ YouTube Player UI


πŸ“œ Features

  • 🎢 Search and play YouTube music tracks.
  • πŸ“„ Load playlists from an Excel sheet.
  • πŸ” Uses YouTube Data API for song lookup.
  • ⚑ TypeScript-based architecture.
  • 🧩 Fully open to contributions and feature ideas.

πŸ“ How It Works

  1. Excel Sheet as Playlist
    The app reads an Excel (public/python/songs.xlsx) file where each row represents a song with details like:

    • Song Name
    • Artist
    • YouTube Link
  2. YouTube Search
    If no direct link is provided, the app will automatically search YouTube using the song name and artist, and play the best result.

  3. Music Player UI
    Simple and intuitive player interface with custom playlist support.


πŸ› οΈ Setup & Run

Pre-requisites:

  • Node.js
  • YouTube API Key
  • A .xlsx playlist file
git clone https://github.com/jasurlive/PlaylistGo.git
cd PlaylistGo
npm install
npm run dev

πŸ§‘β€πŸ’» Contributing

  1. Fork the repository.
  2. Create a new branch: git checkout -b feature/your-feature.
  3. Make your changes and add comments.
  4. Submit a Pull Request.

🐞 Reporting Bugs

Please report any issues through the Issues page.


πŸ“œ License

This project is licensed under the Apache-2.0 License.

About

Stylish Music Player to add a list of your favorite songs from YouTube. πŸŽ§πŸ–€

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published