LuanRT · Illusion137 · Aug 12, 2026 · Aug 12, 2026 · Aug 12, 2026 · Aug 12, 2026
diff --git a/examples/youtube-studio-web/package.json b/examples/youtube-studio-web/package.json
@@ -0,0 +1,17 @@
+{
+  "name": "youtube-studio-web",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {},
+  "devDependencies": {
+    "@types/jsdom": "^27.0.0",
+    "typescript": "^5.0.4"
+  },
+  "dependencies": {
+    "bgutils-js": "^4.0.3",
+    "cookie-eater": "^1.0.0",
+    "jsdom": "^28.1.0",
+    "youtubei.js": "file:../../"
+  }
+}
diff --git a/examples/youtube-studio-web/src/GetSessionToken.ts b/examples/youtube-studio-web/src/GetSessionToken.ts
@@ -0,0 +1,16 @@
+import Innertube, { UniversalCache } from 'youtubei.js';
+import { botguard_solver, get_channel_id, youtube_cookies } from './utils.ts';
+
+
+(async () => {
+  const COOKIES = await youtube_cookies();
+
+  const yt = await Innertube.create({ cache: new UniversalCache(false), cookie: COOKIES });
+
+  const CHANNEL_ID = await get_channel_id(yt);
+
+  const yt_studio_web = yt.studioWeb(CHANNEL_ID);
+  yt_studio_web.setBotGuardSolver(botguard_solver);
+  const session_token = await yt_studio_web.getSessionToken();
+  console.log(session_token);
+})();
diff --git a/examples/youtube-studio-web/src/UploadVideo.ts b/examples/youtube-studio-web/src/UploadVideo.ts
@@ -0,0 +1,40 @@
+import Innertube, { UniversalCache } from 'youtubei.js';
+import { botguard_solver, get_channel_id, get_file_named_buffer_base64, get_file_named_buffer_reader } from "./utils.ts";
+
+const COOKIES = ""; // ?? Place your YouTube cookies here
+const VIDEO_FILE_PATH = ""; // ?? Place your video file path here
+const THUMBNAIL_FILE_PATH = ""; // ?? Place your thumbnail file path here
+const SRT_FILE_PATH = ""; // ?? Place your srt file path here
+
+(async () => {
+  const yt = await Innertube.create({ cache: new UniversalCache(false), cookie: COOKIES });
+
+  const CHANNEL_ID = await get_channel_id(yt);
+
+  const yt_studio_web = yt.studioWeb(CHANNEL_ID);
+  yt_studio_web.setBotGuardSolver(botguard_solver);
+
+  console.log('creating...');
+
+  const created_response = await yt_studio_web.uploadVideo(await get_file_named_buffer_reader(VIDEO_FILE_PATH), {
+    title: "This is a test upload",
+    thumbnail: await get_file_named_buffer_reader(THUMBNAIL_FILE_PATH),
+    subtitles: {
+      synced: true,
+      data: await get_file_named_buffer_base64(SRT_FILE_PATH)
+    },
+    description: "This is a test description",
+    visibility: "PRIVATE"
+  }, (written_bytes, total_bytes) => {
+    // NOTE this callback only fires around every 100mb
+    console.log(`${(written_bytes / total_bytes) * 100}%`);
+  }, async (full_created) => {
+    // NOTE this cycle fires every 2s-ish
+    await yt_studio_web.uploadFeedbackCycle([full_created.feedback_token], (content) => {
+      if(content[0].transfer_progress_bar?.progress_message) console.log(content[0].transfer_progress_bar?.progress_message);
+      if(content[0].is_processing) console.log("processing...");
+      return true;
+    });
+  });
+  console.log(created_response);
+})();
diff --git a/examples/youtube-studio-web/src/utils.ts b/examples/youtube-studio-web/src/utils.ts
@@ -0,0 +1,85 @@
+import { BotGuardClient } from "bgutils-js/botguard";
+import { USER_AGENT } from "bgutils-js/utils";
+import { JSDOM, VirtualConsole } from "jsdom";
+import Innertube, { type Types } from 'youtubei.js';
+import path from "path";
+import fs from 'fs/promises';
+import { get_cookies } from 'cookie-eater';
+
+export const botguard_solver: Types.BotGuardSolver<string> = {
+  solve: async(botguard_challenge, binding) => {
+    const virtual_console = new VirtualConsole();
+    const dom = new JSDOM('<!DOCTYPE html><html lang="en"><head><title></title></head><body></body></html>', { url: "https://www.youtube.com", referrer: "https://www.youtube.com/", userAgent: USER_AGENT, resources: "usable", runScripts: "dangerously", virtualConsole: virtual_console });
+
+    Object.assign(globalThis, { window: dom.window, document: dom.window.document, location: dom.window.location, origin: dom.window.origin });
+
+    if (!("navigator" in globalThis)) {
+      Object.defineProperty(globalThis, "navigator", { value: dom.window.navigator });
+    }
+
+    Object.defineProperty(dom.window.HTMLCanvasElement.prototype, "getContext", { value: () => null, writable: true });
+
+    let interpreter_url = botguard_challenge.interpreter_url ?? "";
+
+    if (interpreter_url.startsWith("//")) interpreter_url = `https:${interpreter_url}`;
+
+    const bg_script_response = await fetch(interpreter_url);
+    const interpreter_javascript = await bg_script_response.text();
+
+    new Function(interpreter_javascript)();
+
+    const botguard = await BotGuardClient.create({ program: botguard_challenge.program, globalName: botguard_challenge.global_name, globalObject: globalThis });
+
+    const botguard_response = await botguard.snapshot({ contentBinding: { atr_challenge: binding } });
+    return botguard_response;
+  }
+};
+
+export async function get_channel_id(yt: Innertube, index?: number): Promise<string> {
+  const account_info = await yt.account.getInfo(true);
+  const account = account_info[index ?? 0];
+  if (account === undefined) throw new Error("No accounts found");
+  const resolve_url = `https://www.youtube.com/${account.channel_handle.text}`;
+  const resolved = await yt.resolveURL(resolve_url);
+  const channel_id = resolved.payload.browseId as string;
+  return channel_id;
+}
+
+export async function get_file_named_buffer_reader(file_path: string): Promise<Types.FileNamedBufferReader> {
+  const stats = await fs.stat(file_path);
+  return {
+    file_name: path.basename(file_path),
+    source: {
+      total_bytes: stats.size,
+      read_chunk: async (position: number, length: number) => {
+        let handle: fs.FileHandle | undefined = undefined;
+        try {
+          handle = await fs.open(file_path, "r");
+          const buffer = Buffer.allocUnsafe(length);
+          const { bytesRead } = await handle.read(buffer, 0, length, position);
+          return new Uint8Array(buffer.buffer, buffer.byteOffset, bytesRead);
+        } finally {
+          await handle?.close();
+        }
+      }
+    }
+  };
+}
+
+export async function get_file_named_buffer_base64(file_path: string): Promise<Types.FileNamedBufferBase64> {
+  return {
+    file_name: path.basename(file_path),
+    source: {
+      base64: (await fs.readFile(file_path, { encoding: "base64" })).toString()
+    }
+  };
+}
+
+export async function youtube_cookies(): Promise<string|undefined> {
+  const HOST_NAME = '.youtube.com';
+  const cookies_map = await get_cookies([HOST_NAME]);
+  const cookies = cookies_map?.[HOST_NAME].toString() ?? undefined;
+
+  if(cookies) console.log(`Successfully found ${cookies_map?.[HOST_NAME].getCookies().length} cookies`);
+  return cookies;
+}
diff --git a/examples/youtube-studio-web/tsconfig.json b/examples/youtube-studio-web/tsconfig.json
@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "moduleResolution": "bundler",
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "noEmit": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "skipLibCheck": true,
+    "allowImportingTsExtensions": true
+  }
+}
diff --git a/protos/generated/youtube/api/pfiinnertube/user_info.ts b/protos/generated/youtube/api/pfiinnertube/user_info.ts
diff --git a/protos/youtube/api/pfiinnertube/user_info.proto b/protos/youtube/api/pfiinnertube/user_info.proto
@@ -14,6 +14,20 @@ message UserInfo {
 
   message KidsParent { }
   message DelegatePurchases { }
-  message DelegationContext { }
+
+  message DelegationContext {
+    optional string external_channel_id = 2;
+    optional RoleType role_type = 5;
+
+    message RoleType {
+      optional ChannelRoleType channel_role_type = 1;
+
+      enum ChannelRoleType {
+        CHANNEL_ROLE_TYPE_UNKNOWN = 0;
+        CREATOR_CHANNEL_ROLE_TYPE_OWNER = 8;
+      }
+    }
+  }
+
   message CredentialTransferToken { }
 }
diff --git a/src/Innertube.ts b/src/Innertube.ts
@@ -1,6 +1,6 @@
 import Session from './core/Session.js';
 
-import { Kids, Music, Studio } from './core/clients/index.js';
+import { Kids, Music, Studio, StudioWeb } from './core/clients/index.js';
 import { AccountManager, InteractionManager, PlaylistManager } from './core/managers/index.js';
 import { Feed, TabbedFeed } from './core/mixins/index.js';
 
@@ -143,7 +143,7 @@ export default class Innertube {
           signatureTimestamp: session.player?.signature_timestamp
         }
       },
-      client: options?.client  
+      client: options?.client
     };
 
     if (options?.po_token) {
@@ -155,7 +155,7 @@ export default class Innertube {
         poToken: session.po_token
       };
     }
-    
+
     const watch_response = await watch_endpoint.call(session.actions, extra_payload);
 
     const cpn = generateRandomString(16);
@@ -296,7 +296,7 @@ export default class Innertube {
         'Cookie': session.cookie || ''
       }
     });
-    
+
     const text = await response.text();
 
     const data = JSON.parse(text.replace('window.google.ac.h(', '').slice(0, -1));
@@ -560,10 +560,10 @@ export default class Innertube {
     const payload: Record<string, any> = {
       engagementType: engagement_type
     };
-    
+
     if (ids)
       payload.ids = ids;
-    
+
     return this.actions.execute('/att/get', { parse: true, ...payload });
   }
 
@@ -590,6 +590,14 @@ export default class Innertube {
     return new Studio(this.#session);
   }
 
+  /**
+   * An interface for interacting with YouTube Studio Web.
+   * @param channel_id - the channel id to interface with
+   */
+  studioWeb(channel_id: string) {
+    return new StudioWeb(this.#session, channel_id);
+  }
+
   /**
    * An interface for interacting with YouTube Kids.
    */