rap-name-generator

Rap Name Generator

Generate unique rapper stage names instantly

🌐 Try Online  |  🇺🇸 English  |  🇨🇳 中文  |  🇯🇵 日本語

✨ Features

• 🎯 Smart Generation - Creates unique, meaningful rapper names
• 🌍 Trilingual - Supports English, Chinese (中文) and Japanese (日本語)
• 📦 Zero Dependencies - Lightweight and fast
• 🔧 Dual Usage - Use as library or CLI tool
• 💪 TypeScript - Full type definitions included
• ⚡ ESM & CJS - Works with any module system

📦 Installation

npm install rap-name-generator

Or use directly with npx:

npx rap-name-generator

🚀 Quick Start

Library Usage

import { generateRapNames, generateRandomRapName } from 'rap-name-generator';

// Generate a single random name
const name = generateRandomRapName();
console.log(name); // => "Lil' FlowMaster"

// Generate multiple names with descriptions
const names = generateRapNames({ count: 5 });
// => [{ name: "Big FlowKing", description: "Represents dominance..." }, ...]

// Chinese rap names (中文说唱名)
const chineseNames = generateRapNames({ language: 'zh', count: 5 });
// => [{ name: "MC龙飞", description: "象征着力量..." }, ...]

// Japanese rap names (日本語ラップ名)
const japaneseNames = generateRapNames({ language: 'ja', count: 5 });
// => [{ name: "龍王 Flow", description: "龍の王、最強のラッパー..." }, ...]

CLI Usage

# Generate 8 random names
rap-name

# Single random name
rap-name -r

# Chinese names
rap-name -l zh

# Japanese names
rap-name -l ja

# Personalized
rap-name -n Alex -a Wild

# JSON output
rap-name -j -c 5

📖 API

generateRandomRapName(language?)

generateRandomRapName();        // English
generateRandomRapName('zh');    // Chinese
generateRandomRapName('ja');    // Japanese

generateRapNames(options?)

Option	Type	Default	Description
language	'en' | 'zh' | 'ja'	'en'	Language
count	number	8	Number of names
firstName	string	-	Your name
adjective	string	-	Style word

Returns: Array<{ name: string, description: string }>

🎯 CLI Options

Option	Alias	Description
--help	-h	Show help
--random	-r	Single random name
--count <n>	-c	Number of names
--lang <en|zh|ja>	-l	Language
--name <name>	-n	Your first name
--adjective <word>	-a	Style word
--json	-j	JSON output

🎨 Name Examples

English	Chinese	Japanese
Big FlowKing	MC龙飞	龍王 Flow
Lil' Phoenix	狂野虎	ヤング ドラゴン
Young Dragon	街头霸王	雷神 King
Ice Storm	雷神韵	炎帝マスター
Shadow Ghost	火焰哥	侍 Boss

📄 License

MIT

🎤 Try it online → generaterapname.xyz