StroepWafel

Portfolio & Creative Works

Privacy Policy

© 2025 StroepWafel (Max Kuchel)

Troubleshooting & FAQ

Common issues and solutions for LYTE.

Frequently Asked Questions

General Questions

Q: Is LYTE free?

A: Yes, LYTE is completely free and open-source. No API keys or cookies required.

Q: What platforms does LYTE support?

A: LYTE currently supports Windows only. Linux support is not available yet. We would greatly appreciate any help making it work on Linux! If you're interested in contributing, please check out the GitHub repository and consider opening an issue or pull request. macOS support is not currently planned.

Q: Do I need a YouTube API key?

A: No! LYTE works without any API keys or authentication. It reads chat directly from YouTube livestreams.

Q: Can I use LYTE offline?

A: No, LYTE requires an internet connection to connect to YouTube livestreams, fetch video information, and download and stream audio.

Q: Does LYTE work with regular YouTube videos or only YouTube Music?

A: By default, LYTE only works with videos available on YouTube Music. Regular YouTube videos may be blocked by YouTube's chat link filtering. However, if ALLOW_URLS is enabled, full URLs might work in some cases.

Installation Issues

Q: The installer won't run / Windows says it protected my PC

A: This is a common Windows Defender false positive. Solutions:

Q: Installation fails with an error

A:

  • Ensure you have administrator privileges
  • Check that your antivirus isn't blocking the installation
  • Try running the installer as administrator
  • See Other Installation Methods for manual installation

Q: LYTE won't start after installation

A:

  • Check the Windows Event Viewer for error messages
  • Ensure Python is installed and added to PATH (for Python installation)
  • Verify VLC is installed with the correct architecture (x64 if Python is x64)
  • Check log files: Exe installation: %LOCALAPPDATA%\LYTE\logs\ or Portable installation: Src/logs/
  • Try running as administrator

Q: "Python not found" or "pip not found" errors

A:

  • Ensure Python is installed from python.org
  • During Python installation, check "Add Python.exe to PATH"
  • Verify installation: Run python --version and pip --version in Command Prompt
  • If still not working, reinstall Python with PATH option checked

Q: VLC architecture mismatch

A: VLC's architecture MUST match Python's architecture (usually x64):

  • Check Python architecture: python -c "import platform; print(platform.architecture()[0])"
  • Download matching VLC version: On VLC download page, click arrow next to "Download VLC" and select "Windows 64bit" for x64 Python
  • Reinstall VLC with correct architecture

Connection Issues

Q: Can't connect to livestream

A:

  • Verify your internet connection
  • Check that YOUTUBE_VIDEO_ID is correct (11 characters after ?v= in URL)
  • Ensure the livestream is actually live (not ended or scheduled)
  • Check if the livestream is private or restricted
  • Try refreshing or restarting LYTE

Q: Chat commands not being detected

A:

  • Verify the livestream ID is correct
  • Check that viewers are using the correct command format: !queue <VIDEO_ID>
  • Ensure the prefix (PREFIX) matches what viewers are typing
  • Check if rate limiting is preventing requests
  • Review log files for error messages

Audio Issues

Q: No audio output

A:

  • Check Windows volume is not muted
  • Verify VOLUME setting in configuration (0-100)
  • Check VLC is installed correctly
  • Ensure audio device is working (test with other applications)
  • Try adjusting volume slider in LYTE's control panel
  • Check Windows audio mixer settings

Q: Audio is choppy or stuttering

A:

  • Check your internet connection speed (needs stable connection for streaming)
  • Close other resource-intensive applications
  • Ensure VLC architecture matches Python (x64/x32)
  • Check if other applications are using audio device
  • Try reducing system load

Command Issues

Q: Commands not working

A:

  • Verify command format: <PREFIX><QUEUE_COMMAND> <VIDEO_ID>
  • Check PREFIX setting (default: !)
  • Check QUEUE_COMMAND setting (default: queue)
  • Ensure no extra spaces or characters
  • Check if user is rate-limited
  • Verify user meets requirements (membership, Super Chat, whitelist)

Common Error Messages

"Connection Failed"

  • Check internet connection
  • Verify livestream ID is correct
  • Ensure livestream is active
  • Check firewall settings

"Video Not Found"

  • Verify video ID is correct (11 characters)
  • Ensure video exists and is accessible
  • Check if video is on YouTube Music
  • Verify video is not private or deleted

"VLC Not Found" or "VLC Error"

  • Ensure VLC is installed
  • Verify VLC architecture matches Python (usually x64 on Windows)
  • Reinstall VLC with correct architecture
  • Check VLC is in system PATH

Getting Help

If you're still experiencing issues:

  1. Check log files: Look in the logs folder for error messages:
    • Exe installation: %LOCALAPPDATA%\LYTE\logs\
    • Portable installation: Src/logs/
  2. Review documentation:
  3. Search GitHub Issues: Check GitHub Issues for similar problems
  4. Create a new issue: Include description, steps to reproduce, log file contents, system information, and configuration

Disabling Windows Real-time Protection

Due to the installer file not yet being signed, windows may flag it as a virus. If you would still like to use the installer, you can follow these simple steps:

For Windows 10:

  1. Press Windows + S to open Search, type Windows Security in the text field, and click on the relevant result.
  2. Click on Virus & threat protection.
  3. Click on Manage settings under Virus & threat protection settings.
  4. Disable the toggle under Real-time protection.
  5. Confirm the action if prompted by User Account Control (UAC).
  6. Re-enable the toggle under Real-time protection once you have finished installing.

For Windows 11:

  1. Press Windows + I to open Settings.
  2. Go to Privacy & Security > Windows Security.
  3. Click on Virus & threat protection.
  4. Under Virus & threat protection settings, click Manage settings.
  5. Toggle Real-time protection to Off.
  6. Confirm the action if prompted by User Account Control (UAC).
  7. Re-enable the toggle under Real-time protection once you have finished installing.