Support & Documentation

Getting Started

Installation

1. Download JukeKaraoke from the Microsoft Store
2. Launch the app from your Start Menu
3. Click "Add Folder" to scan your music library
4. Start mixing!

First Steps

Add Your Music: Click the "Add Folder" button in the library panel and select your music folder. JukeKaraoke will scan for MP3, FLAC, WAV, M4A, and karaoke files.

Load Tracks: Drag tracks from the library to Deck A or Deck B, or double-click to load to the next available deck.

Start Playing: Click the Play button on either deck or press the spacebar.

Common Questions

Audio Setup

Q: How do I select my audio device?
A: Go to Settings → Audio and select your output device. For best results, use WASAPI Exclusive mode with a buffer size of 256-512 samples.

Q: I'm experiencing audio dropouts or stuttering
A: Try increasing the buffer size in Settings → Audio. Also ensure no other programs are using exclusive audio control.

Library Management

Q: How do I organize my library?
A: Use the search box to filter tracks, or create playlists by clicking "New Playlist" and dragging tracks into them.

Q: Can I import playlists from other software?
A: Yes! JukeKaraoke supports M3U, M3U8, and PLS playlist formats. Click "Import Playlist" to load them.

Karaoke Features

Q: How do I display lyrics on a second screen?
A: Load an MP3+G track (MP3 with paired .CDG file) or a track with LRC/SRT lyrics, then click "Show Karaoke Display" in the menu. Drag the window to your second monitor and press F11 for fullscreen.

Q: My CDG graphics look pixelated
A: CDG is a low-resolution format (300×216). The app automatically upscales to fit your screen. You can adjust scaling settings in Settings → Karaoke Display.

Mixing & DJ Features

Q: How do I set hot cue points?
A: While a track is loaded, press Ctrl+1 through Ctrl+8 to set cue points. Press the corresponding number key to jump to that cue point.

Q: What's the difference between Tempo and Pitch?
A: Tempo changes the speed without affecting pitch (key). Pitch changes the musical key. Use Tempo for beatmatching, Pitch for harmonic mixing.

Keyboard Shortcuts

Troubleshooting

App Won't Start

1. Ensure Windows 10 version 1809 or later
2. Check Windows Event Viewer for error details
3. Try reinstalling from Microsoft Store
4. Verify audio drivers are up to date

Audio Issues

• No sound: Check output device in Settings → Audio
• Distortion: Lower master gain or deck gains
• Latency: Enable WASAPI Exclusive mode, reduce buffer size
• Stuttering: Increase buffer size, close other audio apps

Karaoke Display Issues

• No lyrics showing: Ensure track has .CDG or .LRC file with same name
• Timing off: Adjust sync offset in Settings → Karaoke
• Display on wrong screen: Drag window to correct monitor before fullscreen

System Requirements

Minimum

• Windows 10 (version 1809 or later)
• Intel Core i3 or AMD equivalent
• 4 GB RAM
• 500 MB disk space
• Audio interface with WASAPI support

Recommended

• Windows 11
• Intel Core i5 or AMD Ryzen 5
• 8 GB RAM
• SSD storage
• Dedicated audio interface (Focusrite, PreSonus, etc.)

Supported File Formats

Audio

• MP3 (.mp3)
• FLAC (.flac)
• WAV (.wav)
• AIFF (.aif, .aiff)
• M4A/AAC (.m4a)
• OGG Vorbis (.ogg)

Karaoke

• MP3+G (.mp3 + .cdg)
• LRC lyrics (.lrc)
• SubRip (.srt)
• ASS/SSA subtitles (.ass, .ssa)

Playlists

• M3U (.m3u)
• M3U8 (.m3u8) - UTF-8 encoding
• PLS (.pls)

Contact Support

Need more help? We're here to assist:

• Email: support@jukekaraoke.com
• Response Time: Within 24 hours on business days
• Include: Your Windows version, error messages, and steps to reproduce the issue

Feature Requests

Have an idea for JukeKaraoke? We'd love to hear it! Send feature requests to features@jukekaraoke.com

Report a Bug

Found a bug? Help us fix it by reporting it to bugs@jukekaraoke.com with:

• Steps to reproduce the bug
• Expected vs. actual behavior
• Screenshots or error messages
• Your Windows version and JukeKaraoke version