youtube-music-list

A simple yet powerful utility that provides a categorized list of songs (mostly from YouTube), allowing easy access, listing, searching, and random selection of music titles.

These songs are collected from YouTube. Category assignments may not be perfect. You're likely to recognize at least one song here. Enjoy!

📦 Installation

npm install youtube-music-list

🚀 Usage

const music = require("youtube-music-list");

console.log(music.list.kpop.pink_venom); // Pink Venom

console.log(music.getCategories());
// ['karakter_vs', 'sad_edit', 'kpop', 'phonk_funk', 'others']

console.log(music.getFlatList().length);
// total number of songs

console.log(music.search("ruby"));
// [{ category: 'others', key: 'ruby_chan', title: 'Ruby-Chan' }]

console.log(music.getRandom());
// e.g. "Hotel Room Service"

🧠 Features

• Structured Access
  Access song titles using dot notation:
  music.list.kpop.echo → "ECHO!"

• Get All Songs
  Returns the full nested object:

  music.getAll()

• List Categories
  Returns available genre/category keys:

  music.getCategories()

• Flattened List
  Returns all song titles in a flat array:

  music.getFlatList()

• Search
  Search song titles by keyword:

  music.search("Drip")

• Random Song
  Get a random song title from the full list:

  music.getRandom()

🗂️ Categories

• character_vs
• sad_edit
• kpop
• phonk_funk
• others

Each key holds multiple songs as camelCase properties mapped to original song names.

🧾 Notes

• Some songs may appear in unexpected categories.
• All titles are purely for educational/demonstrative use.
• No audio/video content is hosted or linked.
• Intended for playlist organization, filters, or UX demos.

Enjoy the music vibes 🎧