🎤 KantoQueue

Ang Tambayan ng mga Biritero.

The easiest way to manage a karaoke party queue from any device. Guests scan a QR code, join the room, and add songs instantly. Built by a PH Dev for the Filipino party culture, focusing on 1080p playback and bypassing regional "Video Blocked" restrictions.

📽️ Demo

✨ Features

• Social Queueing: Guests join via QR/Code using their phone's browser.
• Hybrid Engine: Combines Supabase or Local SQLite data with yt-dlp caching for 100% reliable 1080p playback.
• Auto-Cache Management: Automatically clears old video files (older than 7 days or > 5GB) while protecting active songs in the queue.
• Offline Local Mode: Run the app entirely on your local network with Zero Config.
• Party Mode: Clean, non-intrusive fullscreen interface for the real Birit stars.
• PH Optimized: Specifically designed to bypass "Watch on YouTube" errors common in the Philippines.

🚀 Quick Start

1. Run the Setup Wizard to choose your engine (Online vs Local):
   • Windows: Run setup-kanto.bat
   • Linux/Termux: Run bash setup-kanto.sh
2. Start the app:
   • Windows: Run start-karaoke.bat
   • Other: npm run dev

🛠️ Tech Stack

• Frontend: Next.js 16 (App Router), Tailwind CSS v4, Lucide Icons.
• Database: Supabase (PostgreSQL + Realtime).
• Video Engine: yt-dlp + FFmpeg.

📖 Documentation

• PH Release Guide - Start Here!

• Supported Platforms - Setup for Windows, Android, Mac, and Linux.

• Supabase Setup

• Blocklist Setup

⚖️ Disclaimer

This project is for educational and personal use only. It does not host any media content. Users are responsible for complying with local laws and third-party Terms of Service. See the full DISCLAIMER.md for more details.

---

Made for the karaoke-loving community. 🎤🔥

Developed by HarrysHQ