Skip to content

docs: Add Basic Setup (HDMI to TV, no microphones) - #10

Draft
mdz wants to merge 4 commits into
mainfrom
docs/basic-hdmi-setup
Draft

docs: Add Basic Setup (HDMI to TV, no microphones)#10
mdz wants to merge 4 commits into
mainfrom
docs/basic-hdmi-setup

Conversation

@mdz

@mdz mdz commented Dec 23, 2025

Copy link
Copy Markdown
Owner

Adds a Basic Setup section for the simplest possible karaoke setup - just a computer and TV, no microphones.

Status: Draft - needs verification that this actually works with decent audio quality.

Open questions:

  • Pi HDMI audio (vc4hdmi0) is known to be poor quality
  • Laptop HDMI audio support varies
  • USB-C to HDMI adapters may not expose audio as a separate device
  • DisplayLink adapters need investigation for macOS

Parking this until we can verify a working setup.

mdz and others added 4 commits December 23, 2025 12:48
Simplest possible setup for casual home karaoke:
- Just a computer, HDMI cable, and TV
- TV provides both display and audio
- Singers sing into the room without amplification
- Perfect for small rooms, kids' parties, practice sessions
The previous setup assumed HDMI audio to TV speakers, but laptop HDMI
output is typically video-only. Revised to use the laptop's headphone
jack with an aux cable to a powered speaker for audio, while keeping
HDMI for lyrics display on the TV. Also added a "Why a Laptop?" section
explaining the advantages over a Raspberry Pi for this minimal setup.

Co-authored-by: Cursor <cursoragent@cursor.com>
Bluetooth is more accessible for casual users - most people already own
a Bluetooth speaker and know how to pair it. Aux cable moved to a tip
for those who prefer zero latency or don't have Bluetooth.

Co-authored-by: Cursor <cursoragent@cursor.com>
No longer "the most accessible setup" since the laptop + Bluetooth
speaker setup is simpler. Reworded to "the simplest setup that includes
a microphone."

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant