Skip to content

ZerNico/tuneperfect

Repository files navigation

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

Home Screen

Game Screen

Song List

Download

Download the game from tuneperfect.org.

Development

Prerequisites

  • caddy - For local development routing
  • 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
  1. Install dependencies:
bun install
  1. Start development services:
docker compose -f docker-compose.dev.yml up -d
caddy start
  1. Start the development server:
bun run dev

To run only specific apps, use the following commands:

bun run dev --filter @tuneperfect/web --filter @tuneperfect/api # run only web and api

Contributing

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

License

MIT