YouTube Live Chat Client

Installation and First Steps

1. Restart NVDA after installing the add-on.
   The add-on will automatically detect NVDA's language (Turkish, English, or German).
2. Press the NVDA + Shift + CTRL + Y keys or run the add-on from the NVDA Tools menu.
3. You will be asked to enter an API Key on the first launch.
   The system will automatically direct you to the Settings window.
4. Paste the YouTube Data v3 API key you obtained from the Google Cloud Console here and press the "Save Settings" button.

How to Get an API Key? (Detailed Guide)

This guide explains step-by-step how to get the free API key required for the add-on to connect to YouTube chats.
Even if you have no technical knowledge, you can easily create your key by following these steps in order.
Note: Do not share your API key with anyone.

Step 1: Logging into Google Cloud Platform

1. Click the "Open Google Cloud Console in Browser" button in the add-on or go to https://console.cloud.google.com in your browser.
2. Log in with an existing Google (Gmail) account.
   If you are logging into the system for the first time, a terms of service or welcome screen may appear; confirm to continue.

Step 2: Creating a New Project

1. Click the "Select a project" button at the top of the screen. Find and click the "New Project" button in the top right corner of the window that opens.
2. In the "Project Name" field, type a simple name to help you remember the add-on (For example: "NVDA Youtube Chat").
3. Click the "Create" button at the bottom. Creating the project may take a few seconds; wait for it to complete.

Step 3: Enabling the YouTube API

1. After your project is created, click on "APIs & Services" from the left navigation menu, then click the "Library" tab.
2. Type "YouTube Data API v3" into the search box that appears and search.
3. Click on the "YouTube Data API v3" link from the search results.
4. Click the "Enable" button on the page that opens.
   This process will grant your created project the authorization to fetch YouTube live chat data.

Step 4: Generating the API Key

1. After the API is enabled, click on the "Credentials" tab on the page you are redirected to or in the left menu.
2. Click the "Create Credentials" button at the top of the screen.
3. Select the "API key" option from the small menu that opens.

Step 5: Copying the Key and Adding It to the Add-on

1. A window saying "API key created" will open on the screen, and a complex, long code starting with the letters "AIza" will appear.
2. This long text is your API key.
   Copy it by clicking the copy button next to the text or by selecting the text completely.
3. Now return to the NVDA add-on settings, paste this copied key into the "Google API Key" box, and save the settings.

IMPORTANT SECURITY NOTE:
This key is completely private to you. Please do not share it with others or on public platforms.
Google provides this service completely free of charge for personal use, and the daily quota allocated for the add-on to fetch messages is more than sufficient for personal use.

Main Window Usage

• URL Field: Paste the link of the YouTube live stream you want to track here.
• Options Menu: You can quickly access all sub-windows such as Settings, Version History, API Guide, About, and Website from this menu.
• Start/Stop: Starts or stops the chat flow.
  The flow works in the background without straining NVDA.
• Chat List: Incoming messages fall here in an accessible list.
  You can navigate between messages using the arrow keys.

Settings Menu

• API Key: Appears masked (asterisks) for security reasons.
  You can read the content with the "Show" button, and instantly clear it with the "Clear" button.
• Timestamp: Determines whether the send time is written at the beginning of the messages.
• Auto Read: Controls whether the screen reader automatically reads the message when a new message arrives.
• Move Focus to Last Message: Important! If you are scrolling up the list to read older messages, turn this setting off.
  If turned on, the screen reader focus will forcibly be moved to the end of the list with every new incoming message.
• API Request Interval: Determines how often in seconds data will be fetched from YouTube servers (Default is 10 seconds).
  If you keep this value too low, your daily API limit will be exhausted very quickly.
  It is recommended to use it in the range of 5 to 15 seconds.
• Reset to Defaults: Resets all your changes, returning the settings to their initial installation state.