Tune Perfect

tuneperfect.org

A modern karaoke game that brings the party to your living room. Perfect your pitch, compete with friends, and have a blast!

Features

• 🎤 Real-time pitch detection with instant feedback
• 🎮 Party modes for competitive fun
• 👥 Online accounts and lobbies
• 🎛️ Customizable settings
• 🏆 Score tracking and leaderboards
• 🖥️ Cross-platform support (Windows, macOS, Linux)

Screenshots

Download

Download the game from tuneperfect.org.

Development

Prerequisites

• mkcert - For local certificates
• Caddy - Reverse proxy for local development
• docker - For running development services
• bun - JavaScript runtime and package manager

Setup

1. Add the following entries to your /etc/hosts file (required for local development):

127.0.0.1 tuneperfect.localhost api.tuneperfect.localhost app.tuneperfect.localhost

2. Install dependencies:

bun install

3. Start development services:

docker compose -f docker-compose.dev.yml up -d

4. Start the development environment (this will automatically):
   • Generate certificates if they don't exist
   • Start the Caddy reverse proxy
   • Start all apps in development mode

bun run tuneperfect dev

To run only specific apps:

bun run tuneperfect dev --filter @tuneperfect/game

Contributing

Contributions are welcome! Feel free to submit issues and pull requests.

License

MIT