StroepWafel

Portfolio & Creative Works

Privacy Policy

© 2025 StroepWafel (Max Kuchel)

Commands

Learn how to use LYTE commands to queue music in your livestream.

Basic Command Syntax

The basic command format is:

<PREFIX><QUEUE_COMMAND> <VIDEO_ID>

Default syntax: !queue <VIDEO_ID>

Where:

  • <PREFIX> is the command prefix (default: !)
  • <QUEUE_COMMAND> is the queue command (default: queue)
  • <VIDEO_ID> is the YouTube video ID

!queue Command

The default command to queue a song is !queue <VIDEO_ID>, where <VIDEO_ID> is the ID for the YouTube music video (everything after ?v= in the URL).

Example Usage

If a viewer wants to queue a song with the URL https://www.youtube.com/watch?v=dQw4w9WgXcQ, they would type:

!queue dQw4w9WgXcQ

Finding Video IDs

From YouTube URL:

  • Full URL: https://www.youtube.com/watch?v=dQw4w9WgXcQ
  • Video ID: dQw4w9WgXcQ (the part after ?v=)

From YouTube Music URL:

  • Full URL: https://music.youtube.com/watch?v=dQw4w9WgXcQ
  • Video ID: dQw4w9WgXcQ (the part after ?v=)

From Short URL:

  • Short URL: https://youtu.be/dQw4w9WgXcQ
  • Video ID: dQw4w9WgXcQ (the part after /)

Important: By default, this command only works with IDs of videos that are on YouTube Music; regular videos will not play. This is because YouTube blocks links in livestream chats.

Customizing Commands

Changing the Prefix

You can change the command prefix in the configuration:

  1. Open LYTE Settings
  2. Find the PREFIX setting
  3. Change it to your desired prefix (e.g., ?, lyte , etc.)
  4. Save and restart

Examples:

  • ?queue dQw4w9WgXcQ (with prefix ?)
  • lyte queue dQw4w9WgXcQ (with prefix lyte )

Changing the Command Name

You can change the queue command name in the configuration:

  1. Open LYTE Settings
  2. Find the QUEUE_COMMAND setting
  3. Change it to your desired command (e.g., play, add, request)
  4. Save and restart

Examples:

  • !play dQw4w9WgXcQ (with command play)
  • !add dQw4w9WgXcQ (with command add)
  • !request dQw4w9WgXcQ (with command request)

Using Full URLs

If ALLOW_URLS is enabled in your configuration, viewers can use full YouTube URLs instead of just video IDs:

!queue https://www.youtube.com/watch?v=dQw4w9WgXcQ

Note: This feature is disabled by default because YouTube blocks links in livestream chats.

Command Restrictions

Rate Limiting

If RATE_LIMIT_SECONDS is set (not 0), users must wait the specified number of seconds between requests.

Example: If set to 30, a user can only queue one song every 30 seconds.

Membership Requirements

If REQUIRE_MEMBERSHIP is enabled, only channel members can request songs.

Super Chat Requirements

If REQUIRE_SUPERCHAT is enabled, users must send a Super Chat to request songs. The minimum amount is set by MINIMUM_SUPERCHAT.

Whitelist Restrictions

  • If ENFORCE_USER_WHITELIST is enabled, only whitelisted users can request songs
  • If ENFORCE_ID_WHITELIST is enabled, only whitelisted videos can be requested

Ban Restrictions

  • Users in banned_users.json cannot request songs
  • Videos in banned_IDs.json cannot be requested
  • If AUTOBAN_USERS is enabled, users who request banned videos are automatically banned

Troubleshooting Commands

Command Not Working

  1. Check the prefix: Make sure you're using the correct prefix (default: !)
  2. Check the command: Make sure you're using the correct command name (default: queue)
  3. Check the video ID: Ensure the video ID is correct (11 characters, alphanumeric)
  4. Check restrictions: Verify you meet all requirements (membership, Super Chat, whitelist, etc.)
  5. Check rate limiting: Make sure you haven't exceeded the rate limit

Video Not Playing

  1. YouTube Music: Ensure the video is available on YouTube Music (not just regular YouTube)
  2. Video availability: Check that the video is not private, deleted, or region-restricted
  3. Banned video: Check if the video is in the banned list
  4. Whitelist: If whitelist is enforced, ensure the video is whitelisted

User Cannot Request

  1. Banned user: Check if the user is in the banned users list
  2. Whitelist: If user whitelist is enforced, ensure the user is whitelisted
  3. Membership: If membership is required, ensure the user is a channel member
  4. Super Chat: If Super Chat is required, ensure the user sent a Super Chat

Best Practices

  1. Clear instructions: Let your viewers know the command format in your stream description or overlay
  2. Rate limiting: Use rate limiting (30-60 seconds) to prevent spam
  3. Moderation: Regularly check and update your banned lists
  4. Whitelist: Consider using whitelists for exclusive events or member-only requests
  5. Test commands: Test commands yourself before going live

Example Stream Setup

For a public stream, you might use:

  • Prefix: !
  • Command: queue
  • Rate Limit: 30 seconds
  • Membership: Not required
  • Super Chat: Not required
  • Whitelist: Not enforced

Command format: !queue <VIDEO_ID>

For an exclusive member stream:

  • Prefix: !
  • Command: request
  • Rate Limit: 60 seconds
  • Membership: Required
  • Super Chat: Not required
  • Whitelist: Not enforced

Command format: !request <VIDEO_ID>