Understanding How the Bot Works on YouTube

1. Make sure BotRix is a moderator of your YouTube channel, if not, add him by pasting the url of his channel in the moderator name box ( https://youtube.com/@botrix )
   
2. Public Streams Only: The bot can only join public streams. It won't function if your stream is set to unlisted, private, or any other mode. Make sure your stream is set to public for the bot to work.
3. Joining Time: When your stream is public, the bot may take between 5 to 10 minutes to join the channel. Please be patient, especially if you've just started your stream. It's normal for the bot to take a few minutes to join.
4. Check the bot: If after 10 minutes you believe the bot is still not there, try using a command like !uptime to see if it responds. If the bot doesn’t reply, you can manually force it to join by going to the ChatBot menu on the BotRix website and toggling the bot off and on — make sure to wait about 15 seconds before turning it back on.

   If that doesn't work either, try logging out of BotRix completely, then go back to the homepage and click "Sign in with YouTube". After logging in again, repeat the toggle (off and on with a 15-second pause) and check if the bot joins your stream.

5. First-Time Registration: After initially registering, the bot might not be able to join your channel for at least an hour. If you've just registered, it's advisable to wait at least 60 minutes before starting your stream.
6. Turning the Bot On: If you had the bot turned off and then turned it on again, you may need to wait another 60 minutes for it to join your channel.
7. Widgets and Bot Presence: Widgets like chat, alerts, goals, and labels require the bot to be present in your channel. Ensure that the bot is active and in your chat for these features to work correctly.
8. Scheduled Streams: The bot may encounter issues if your stream is scheduled for a specific time, but you start it earlier or later than scheduled. If you set a start time for 6 PM and start at 6 PM, the bot should ideally join between 6 PM and 6:10 PM. However, if you start at 6:30 PM, it might not join until 7 PM due to the delay. If you're more than 30 minutes late, the bot may assume you've canceled the stream and not join
9. Chat Delay: The YouTube chat does not operate in real-time. It has a delay of between 1 and 10 seconds, depending on the chat activity (more activity results in a shorter delay). If there's constant conversation in your chat, the delay will be minimal (around 1 second). However, with less frequent messages, the delay can increase.
10. Delay for Goals and Alerts: Goals, alerts, and other interactive elements typically have a delay of about 5 minutes. For instance, if you set a goal for likes, the displayed value will reflect data from five minutes ago.
11. Subscriber Alerts: Subscriber alerts on YouTube will only appear for users who subscribe during the live stream and have their subscription sharing set to public (which is disabled by default). Roughly 1 in 5 subscribers might have this setting enabled, so not all new subscribers will trigger alerts during the stream. This behavior is based on individual user settings, and the bot doesn't control it.
12. Valid Token Required: BotRix needs a valid API token to operate. Tokens can become invalid if you change your YouTube password or revoke authorization for the application. To ensure a valid token, log in to BotRix using your YouTube account from the BotRix main page whenever you change your YouTube password.
13. Update of number of subscribers: Due to changes YouTube made to its api a few months ago, the amount every time your subscribers are updated depends on your number of subscribers.If you have less than 1000 subscribers, it updates every 1 subscriber, 1,000-9,999 every 10 subscribers, 10,000-99,999 every 100 subscribers, 100,000-999,999 every 1000 subscribers, if you have more than 1 million subscribers it will update every 10,000 subscribers.This is something that YouTube decides and cannot be changed by third party applications.
14. Subscriber goals & Subathon: Make sure they are visible at all times in your streaming so that they work properly, because if you hide them and show them every now and then they may not work accurately.
    Also, keep in mind that update times will also depend on your subscriber count as mentioned above and once you increase that subscriber threshold it can take up to 5 minutes longer to update.

Understanding these nuances will help you troubleshoot and make the most of your bot and streaming setup on YouTube. Remember that many of these issues are not related to the bot itself but are inherent to YouTube's streaming system and user settings.

If you have further questions or encounter specific issues, feel free to seek assistance or clarifications, and happy streaming!