🔌 Adapter Setup

Reminders (for myself)

1. If we switch owner parameter or default value - we have to run the bot with force_subscribe=True once. The conduits stay alive only for 72 hours. So it's almost certain the subscriptions will be dead for the other account when we decide to switch.

Adapter-Host Setup Guide (for myself, I will forget)

1. Decide whether we use local adapter (localhost) or remote (currently "free pleb" option - ngrok); Remote allows other people to authorize the bot permissions, but requires a web app running.

2. Twitch Developer Console at @Irene_Adler__ account -> OAuths Redirect URLs:

   • local: http://localhost:4343/oauth/callback
   • ngrok: https://parrot-thankful-trivially.ngrok-free.app/oauth/callback

3. Now:

   • local: no actions needed;
   • ngrok: Run ngrok http --url=parrot-thankful-trivially.ngrok-free.app 4343 in PC/VPS's terminal. Note that the port should be 4343, as twitchio adapter works on it as well. Ignore ngrok dashboard saying port 80, it's just an example.

4. Simply run the bot, i.e. uv run src/main.py. Now users should be able to visit a link like this

   • local: http://localhost:4343/oauth?scopes=channel:bot&force_verify=true
   • ngrok: https://parrot-thankful-trivially.ngrok-free.app/oauth?scopes=channel:bot&force_verify=true

   to authorize the bot. Note, to get a proper link with ALL proper scopes - launch the bot in -s (--scopes-only) mode.