Melody AI là ứng dụng nghe nhạc thông minh được thiết kế đặc biệt cho âm nhạc Việt Nam. Với giao diện Apple Vision Pro hiện đại và tích hợp AI, ứng dụng mang đến trải nghiệm nghe nhạc độc đáo với lời bài hát đồng bộ, câu chuyện bài hát, hiệu ứng hình ảnh và nhiều tính năng sáng tạo khác.

• Tích hợp YouTube Player với chất lượng cao
• Lời bài hát đồng bộ thời gian thực (từ LrcLib + OpenAI)
• Giao diện tối minimalist theo phong cách Apple Vision Pro
• Điều khiển phát nhạc đầy đủ (play/pause, seek, volume)

• MoodAura: Hào quang màu sắc theo tâm trạng bài hát
• EmotionParticles: Nốt nhạc bay với hiệu ứng độ sâu 3D
• AnimatedGradient: Nền gradient động theo nhạc
• Thiết kế Liquid Glass theo Apple Vision Pro

• Bộ điều chỉnh EQ (Bass, Mid, Treble)
• Hiệu ứng âm thanh: Reverb, Delay, Distortion, Flanger
• Preset nhanh: Telephone, Vinyl, Underwater, Chipmunk, Echo, Robot...
• Giao diện glass morphism cao cấp

• Tự động tạo câu chuyện về bài hát với AI
• Thông tin nghệ sĩ, lịch sử sáng tác
• Dữ liệu từ Wikipedia, MusicBrainz và nguồn đáng tin cậy

• Trải nghiệm nghe nhạc theo chủ đề
• Câu chuyện nghệ sĩ với hình ảnh và nội dung phong phú
• Danh sách phát được tuyển chọn

• Node.js: 18.0 trở lên
• npm hoặc yarn hoặc pnpm
• Trình duyệt: Chrome, Firefox, Safari, Edge (phiên bản mới nhất)

git clone https://github.com/your-username/melody-ai.git
cd melody-ai

npm install
# hoặc
yarn install
# hoặc
pnpm install

Tạo file .env.local từ mẫu:

cp .env.example .env.local

Mở .env.local và điền API key của bạn:

# Bắt buộc - OpenAI API Key
OPENAI_API_KEY=sk-your-openai-api-key-here

# Tùy chọn - YouTube Data API (để tìm kiếm nâng cao)
YOUTUBE_API_KEY=your-youtube-api-key

# Chế độ Demo (true = không cần API key)
NEXT_PUBLIC_DEMO_MODE=false

# Chế độ phát triển
npm run dev

# Hoặc build và chạy production
npm run build
npm start

Truy cập ứng dụng tại: http://localhost:3000

1. Truy cập platform.openai.com
2. Đăng nhập hoặc tạo tài khoản
3. Vào Settings → API Keys
4. Nhấn Create new secret key
5. Copy key và dán vào .env.local

Lưu ý: API key được lưu trữ an toàn và không bao giờ được gửi đến server của bên thứ ba. Tất cả API calls được thực hiện trực tiếp từ server Next.js của bạn.

1. Truy cập Google Cloud Console
2. Tạo project mới hoặc chọn project có sẵn
3. Bật YouTube Data API v3
4. Tạo credentials (API Key)
5. Copy key và dán vào .env.local

melody-ai/
├── app/                    # Next.js App Router
│   ├── api/               # API Routes
│   │   ├── lyrics/        # API lời bài hát
│   │   ├── search/        # API tìm kiếm
│   │   ├── song-story/    # API câu chuyện bài hát
│   │   └── album-story/   # API album story
│   ├── player/            # Trang trình phát nhạc
│   ├── album-story/       # Trang album story
│   └── synesthesia/       # Trang hiệu ứng âm thanh-hình ảnh
├── components/
│   ├── player/            # Components trình phát
│   ├── visual/            # Components hiệu ứng hình ảnh
│   ├── dj/                # Components DJ Mixer
│   ├── album-story/       # Components album story
│   ├── setup/             # Components thiết lập
│   └── background/        # Components nền
├── lib/
│   ├── audio/             # Xử lý âm thanh
│   ├── cache/             # Hệ thống cache
│   ├── database/          # Cơ sở dữ liệu nội dung
│   └── services/          # Dịch vụ bên ngoài
└── types/                 # TypeScript definitions

• Danh sách phát tùy chỉnh
• Chế độ offline
• Chia sẻ lên mạng xã hội
• Nhận diện bài hát bằng giọng nói
• Tích hợp Spotify/Apple Music

Chúng tôi hoan nghênh mọi đóng góp! Vui lòng:

1. Fork repository
2. Tạo branch mới (git checkout -b feature/amazing-feature)
3. Commit thay đổi (git commit -m 'Thêm tính năng mới')
4. Push lên branch (git push origin feature/amazing-feature)
5. Mở Pull Request

• Không bao giờ commit file .env.local hoặc API keys
• File client_secret.json đã được gitignore
• API keys được mã hóa khi lưu trữ local
• Tất cả API calls được thực hiện qua server-side

Dự án này được phân phối dưới giấy phép MIT. Xem file LICENSE cho chi tiết.

• Issues: GitHub Issues
• Email: your-email@example.com