Skip to content

monokaijs/musicbox

Repository files navigation

MusicBox

MusicBox is an open-source music player built on Next.js that allows you to play MP3 files and stream tracks from YouTube. With features like playlists, favorites, real-time listening with PeerJS, YouTube video playback, search functionality, and robust track organization, MusicBox provides a full-featured music player experience.

Crafted with <3 by @delimister a.k.a @monokaijs

Getting Started

Prerequisites

Before you begin, make sure you have the following installed:

  • Node.js
  • npm (Node Package Manager)

Installation

  1. Clone the repository:

    git clone https://github.com/monokaijs/musicbox.git
  2. Navigate to the project directory:

    cd musicbox
  3. Install dependencies:

    npm install

Usage

  1. Start the Next.js development server:

    npm run dev
  2. Open your browser and navigate to http://localhost:3000 to use MusicBox.

Features

Playlists

Create and manage playlists for a customized listening experience.

Favorites

Mark your favorite tracks for quick access.

Real-time Listening

Enjoy tracks together with friends in real-time using PeerJS.

YouTube Integration

Listen to your favorite tracks directly from YouTube videos.

Search

Efficiently find and discover new tracks with the built-in search functionality.

Organizing Tracks

Organize your music library with ease, ensuring a seamless listening experience.

Full Controls

MusicBox provides full controls as a comprehensive music player, giving you command over playback and settings.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details on how to contribute to this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Special thanks to the open-source community for their continuous support and contributions.

Contact

For any inquiries or issues, please open an issue on GitHub.

Enjoy MusicBox! 🎵🎧