From 16b5389dfade1979a91457e48b6b5f8b6f01e4cd Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:26:19 +1100
Subject: [PATCH 01/12] feat: add configurable Plex client identifier and token
 header

- Add PLEX_CLIENT_IDENTIFIER config option (defaults to 'SchroStream')
- Include X-Plex-Token in FFmpeg HTTP headers for authenticated requests
- Makes client identifier configurable instead of hardcoded
---
 src/config.ts                | 1 +
 src/stream/video-streamer.ts | 3 ++-
 src/types/index.ts           | 1 +
 3 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/config.ts b/src/config.ts
index 922d9d0..0f7f836 100644
--- a/src/config.ts
+++ b/src/config.ts
@@ -31,6 +31,7 @@ export const config: Config = {
   plex: {
     url: getEnvOrThrow('PLEX_URL').replace(/\/$/, ''),
     token: getEnvOrThrow('PLEX_TOKEN'),
+    clientIdentifier: getEnvOrDefault('PLEX_CLIENT_IDENTIFIER', 'SchroStream'),
   },
   stream: {
     defaultQuality: parseInt(getEnvOrDefault('DEFAULT_QUALITY', '1080'), 10),
diff --git a/src/stream/video-streamer.ts b/src/stream/video-streamer.ts
index 3f3c45c..f127255 100644
--- a/src/stream/video-streamer.ts
+++ b/src/stream/video-streamer.ts
@@ -77,11 +77,12 @@ class VideoStreamer {
       // Build headers string for FFmpeg (must be before -i)
       const headers = [
         'Accept: application/json',
-        'X-Plex-Client-Identifier: SchroStream',
+        'X-Plex-Client-Identifier: ' + config.plex.clientIdentifier,
         'X-Plex-Product: Plex Web',
         'X-Plex-Version: 4.0',
         'X-Plex-Platform: Chrome',
         'X-Plex-Device: Linux',
+        'X-Plex-Token: ' + config.plex.token,
       ].join('\r\n') + '\r\n';
 
       const ffmpegArgs = [
diff --git a/src/types/index.ts b/src/types/index.ts
index 73643ba..0f9f264 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -75,6 +75,7 @@ export interface Config {
   plex: {
     url: string;
     token: string;
+    clientIdentifier: string;
   };
   stream: {
     defaultQuality: number;

From fc27a59805ac171f7abb6732b61fc64733129e18 Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:27:41 +1100
Subject: [PATCH 02/12] feat: add multi-user and role support with help command

- ALLOWED_USERS: comma-separated list of user IDs who can use the bot
- ALLOWED_ROLES: comma-separated list of role IDs that grant access
- Added !help command to show all available commands
- Updated .env.example with new config options
- Bot account always has access, plus any allowed users/roles
---
 .env.example              | 12 ++++++++---
 src/bot/client.ts         | 42 ++++++++++++++++++++++++++++++++-------
 src/bot/commands/help.ts  | 30 ++++++++++++++++++++++++++++
 src/bot/commands/index.ts |  4 ++++
 src/config.ts             | 12 +++++------
 src/types/index.ts        |  3 ++-
 6 files changed, 86 insertions(+), 17 deletions(-)
 create mode 100644 src/bot/commands/help.ts

diff --git a/.env.example b/.env.example
index 523139b..f525db9 100644
--- a/.env.example
+++ b/.env.example
@@ -2,9 +2,15 @@
 # WARNING: Using self-bots violates Discord ToS - use at your own risk
 DISCORD_TOKEN=your_discord_user_token_here
 
-# Owner ID - Your MAIN account's user ID (the account that controls the bot)
-# Right-click your profile → Copy User ID (requires Developer Mode)
-OWNER_ID=your_main_account_user_id_here
+# Allowed Users - Comma-separated user IDs who can control the bot
+# Right-click user → Copy User ID (requires Developer Mode)
+# Leave empty to only allow the bot's own account
+ALLOWED_USERS=
+
+# Allowed Roles - Comma-separated role IDs that can control the bot
+# Right-click role → Copy Role ID (requires Developer Mode)
+# Users with ANY of these roles can use the bot
+ALLOWED_ROLES=
 
 # Allowed Guilds - Comma-separated server IDs (leave empty for all servers)
 # Right-click server → Copy Server ID (requires Developer Mode)
diff --git a/src/bot/client.ts b/src/bot/client.ts
index fb6affc..23f99e0 100644
--- a/src/bot/client.ts
+++ b/src/bot/client.ts
@@ -10,20 +10,48 @@ export const client = new Client({
 client.on('ready', async () => {
   console.log(`[SchroStream] Logged in as ${client.user?.tag}`);
   console.log(`[SchroStream] Prefix: ${config.discord.prefix}`);
-  console.log(`[SchroStream] Owner: ${config.discord.ownerId || client.user?.id} (${config.discord.ownerId ? 'external' : 'self'})`);
+  
+  if (config.discord.allowedUsers.length > 0) {
+    console.log(`[SchroStream] Allowed users: ${config.discord.allowedUsers.join(', ')}`);
+  } else {
+    console.log(`[SchroStream] Allowed users: ${client.user?.id} (self only)`);
+  }
+  
+  if (config.discord.allowedRoles.length > 0) {
+    console.log(`[SchroStream] Allowed roles: ${config.discord.allowedRoles.join(', ')}`);
+  }
+  
   console.log(`[SchroStream] Allowed guilds: ${config.discord.allowedGuilds.length > 0 ? config.discord.allowedGuilds.join(', ') : 'all'}`);
   console.log(`[SchroStream] Video streaming enabled (Go Live)`);
   
   initVideoStreamer(client);
 });
 
-client.on('messageCreate', async (message) => {
-  const isOwner = config.discord.ownerId 
-    ? message.author.id === config.discord.ownerId
-    : message.author.id === client.user?.id;
+function hasPermission(message: import('discord.js-selfbot-v13').Message): boolean {
+  // Always allow the bot's own account
+  if (message.author.id === client.user?.id) return true;
+  
+  // Check if user is in the allowed users list
+  if (config.discord.allowedUsers.length > 0) {
+    if (config.discord.allowedUsers.includes(message.author.id)) return true;
+  }
+  
+  // Check if user has any of the allowed roles (only in guilds)
+  if (config.discord.allowedRoles.length > 0 && message.guild && message.member) {
+    const memberRoles = message.member.roles.cache;
+    const hasAllowedRole = config.discord.allowedRoles.some(roleId => memberRoles.has(roleId));
+    if (hasAllowedRole) return true;
+  }
+  
+  // If no users or roles configured, only bot account can use
+  return config.discord.allowedUsers.length === 0 && config.discord.allowedRoles.length === 0;
+}
 
-  if (!isOwner) return;
+client.on('messageCreate', async (message) => {
+  // Check user permissions
+  if (!hasPermission(message)) return;
 
+  // Check guild restrictions
   if (config.discord.allowedGuilds.length > 0 && message.guild) {
     if (!config.discord.allowedGuilds.includes(message.guild.id)) return;
   }
@@ -39,7 +67,7 @@ client.on('messageCreate', async (message) => {
     await handleCommand(commandName, message, args);
   } catch (error) {
     console.error(`[Command Error] ${commandName}:`, error);
-    await message.edit(`❌ Error: ${error instanceof Error ? error.message : 'Unknown error'}`).catch(() => {});
+    await message.channel.send(`❌ Error: ${error instanceof Error ? error.message : 'Unknown error'}`).catch(() => {});
   }
 });
 
diff --git a/src/bot/commands/help.ts b/src/bot/commands/help.ts
new file mode 100644
index 0000000..f5eaa0c
--- /dev/null
+++ b/src/bot/commands/help.ts
@@ -0,0 +1,30 @@
+import type { Message } from 'discord.js-selfbot-v13';
+import config from '../../config.js';
+
+export async function helpCommand(message: Message, _args: string[]): Promise<void> {
+  const prefix = config.discord.prefix;
+  
+  const helpText = `
+**📺 SchroStream Commands**
+
+**Media Search & Playback:**
+\`${prefix}search <query>\` - Search for movies or TV shows
+\`${prefix}play <number>\` - Play a result from your search
+\`${prefix}stop\` - Stop the current stream
+
+**Playback Controls:**
+\`${prefix}pause\` - Pause/resume playback
+\`${prefix}seek <time>\` - Seek to time (e.g., \`1:30:00\` or \`45:00\`)
+\`${prefix}skip\` - Skip to next episode (TV shows only)
+\`${prefix}np\` - Show what's currently playing
+
+**Example:**
+1. \`${prefix}search breaking bad\`
+2. \`${prefix}play 1\`
+3. Enjoy the stream! 🎬
+
+*Note: You must be in a voice channel to start playback.*
+  `.trim();
+
+  await message.channel.send(helpText);
+}
diff --git a/src/bot/commands/index.ts b/src/bot/commands/index.ts
index c80853a..f2d5a1c 100644
--- a/src/bot/commands/index.ts
+++ b/src/bot/commands/index.ts
@@ -6,10 +6,14 @@ import { pauseCommand } from './pause.js';
 import { seekCommand } from './seek.js';
 import { skipCommand } from './skip.js';
 import { nowPlayingCommand } from './nowplaying.js';
+import { helpCommand } from './help.js';
 
 export type CommandHandler = (message: Message, args: string[]) => Promise<void>;
 
 const commands: Record<string, CommandHandler> = {
+  help: helpCommand,
+  h: helpCommand,
+  commands: helpCommand,
   search: searchCommand,
   s: searchCommand,
   play: playCommand,
diff --git a/src/config.ts b/src/config.ts
index 0f7f836..ae4f52f 100644
--- a/src/config.ts
+++ b/src/config.ts
@@ -15,18 +15,18 @@ function getEnvOrDefault(key: string, defaultValue: string): string {
   return process.env[key] || defaultValue;
 }
 
-function parseAllowedGuilds(): string[] {
-  const guilds = process.env.ALLOWED_GUILDS;
-  if (!guilds || guilds.trim() === '') return [];
-  return guilds.split(',').map((g) => g.trim()).filter(Boolean);
+function parseCommaSeparated(value: string | undefined): string[] {
+  if (!value || value.trim() === '') return [];
+  return value.split(',').map((item) => item.trim()).filter(Boolean);
 }
 
 export const config: Config = {
   discord: {
     token: getEnvOrThrow('DISCORD_TOKEN'),
     prefix: getEnvOrDefault('PREFIX', '!'),
-    ownerId: process.env.OWNER_ID || null,
-    allowedGuilds: parseAllowedGuilds(),
+    allowedUsers: parseCommaSeparated(process.env.ALLOWED_USERS),
+    allowedRoles: parseCommaSeparated(process.env.ALLOWED_ROLES),
+    allowedGuilds: parseCommaSeparated(process.env.ALLOWED_GUILDS),
   },
   plex: {
     url: getEnvOrThrow('PLEX_URL').replace(/\/$/, ''),
diff --git a/src/types/index.ts b/src/types/index.ts
index 0f9f264..11e28e9 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -69,7 +69,8 @@ export interface Config {
   discord: {
     token: string;
     prefix: string;
-    ownerId: string | null;
+    allowedUsers: string[];
+    allowedRoles: string[];
     allowedGuilds: string[];
   };
   plex: {

From be4120708da27fa4bb02369c48dcb905fb261d14 Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:31:27 +1100
Subject: [PATCH 03/12] fix: initialize Plex transcode session before FFmpeg
 accesses stream

- Fetch m3u8 first to tell Plex to start transcoding
- Extract actual stream URL from m3u8 response
- Pass proper headers to both fetch and FFmpeg
---
 src/stream/video-streamer.ts | 41 +++++++++++++++++++++++++++++++-----
 1 file changed, 36 insertions(+), 5 deletions(-)

diff --git a/src/stream/video-streamer.ts b/src/stream/video-streamer.ts
index f127255..a4b1731 100644
--- a/src/stream/video-streamer.ts
+++ b/src/stream/video-streamer.ts
@@ -73,16 +73,47 @@ class VideoStreamer {
     try {
       console.log('[VideoStreamer] Stream URL:', session.streamUrl.substring(0, 100) + '...');
 
-      // Spawn FFmpeg manually to handle HLS input properly
-      // Build headers string for FFmpeg (must be before -i)
+      // Initialize Plex session by fetching the m3u8 first
+      // This tells Plex to start the transcode session
+      console.log('[VideoStreamer] Initializing Plex transcode session...');
+      const initResponse = await fetch(session.streamUrl, {
+        headers: {
+          'Accept': '*/*',
+          'X-Plex-Client-Identifier': config.plex.clientIdentifier,
+          'X-Plex-Product': 'Plex Web',
+          'X-Plex-Version': '4.0',
+          'X-Plex-Platform': 'Chrome',
+          'X-Plex-Device': 'Linux',
+        }
+      });
+      
+      if (!initResponse.ok) {
+        throw new Error(`Failed to initialize Plex session: ${initResponse.status} ${initResponse.statusText}`);
+      }
+      
+      const m3u8Content = await initResponse.text();
+      console.log('[VideoStreamer] Session initialized, m3u8:', m3u8Content.substring(0, 200));
+      
+      // Extract the actual stream URL from m3u8 (it's relative)
+      const lines = m3u8Content.split('\n');
+      const streamPath = lines.find(l => l.endsWith('.m3u8') && !l.startsWith('#'));
+      
+      let actualStreamUrl = session.streamUrl;
+      if (streamPath) {
+        // Convert relative path to absolute URL
+        const baseUrl = session.streamUrl.split('?')[0].replace('/start.m3u8', '');
+        actualStreamUrl = `${config.plex.url}/video/:/transcode/universal/${streamPath}?X-Plex-Token=${config.plex.token}`;
+        console.log('[VideoStreamer] Using stream URL:', actualStreamUrl.substring(0, 100) + '...');
+      }
+
+      // Build headers string for FFmpeg
       const headers = [
-        'Accept: application/json',
+        'Accept: */*',
         'X-Plex-Client-Identifier: ' + config.plex.clientIdentifier,
         'X-Plex-Product: Plex Web',
         'X-Plex-Version: 4.0',
         'X-Plex-Platform: Chrome',
         'X-Plex-Device: Linux',
-        'X-Plex-Token: ' + config.plex.token,
       ].join('\r\n') + '\r\n';
 
       const ffmpegArgs = [
@@ -102,7 +133,7 @@ class VideoStreamer {
       }
 
       ffmpegArgs.push(
-        '-i', session.streamUrl,
+        '-i', actualStreamUrl,
         // Video output
         '-c:v', 'libx264',
         '-preset', 'veryfast',

From b79b940014d8e6a07a6263c1e2444d7a1d066b5f Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:32:56 +1100
Subject: [PATCH 04/12] feat: add volume command (0-200%, default 100%)

- !volume <0-200> to set volume
- !volume (no args) to show current volume
- Aliases: !vol, !v
- Updated help command with volume info
---
 src/bot/commands/help.ts     |  1 +
 src/bot/commands/index.ts    |  4 ++++
 src/bot/commands/volume.ts   | 42 ++++++++++++++++++++++++++++++++++++
 src/stream/video-streamer.ts | 16 ++++++++++++++
 4 files changed, 63 insertions(+)
 create mode 100644 src/bot/commands/volume.ts

diff --git a/src/bot/commands/help.ts b/src/bot/commands/help.ts
index f5eaa0c..b746a5d 100644
--- a/src/bot/commands/help.ts
+++ b/src/bot/commands/help.ts
@@ -17,6 +17,7 @@ export async function helpCommand(message: Message, _args: string[]): Promise<vo
 \`${prefix}seek <time>\` - Seek to time (e.g., \`1:30:00\` or \`45:00\`)
 \`${prefix}skip\` - Skip to next episode (TV shows only)
 \`${prefix}np\` - Show what's currently playing
+\`${prefix}volume <0-200>\` - Set volume (default: 100%)
 
 **Example:**
 1. \`${prefix}search breaking bad\`
diff --git a/src/bot/commands/index.ts b/src/bot/commands/index.ts
index f2d5a1c..18d27e2 100644
--- a/src/bot/commands/index.ts
+++ b/src/bot/commands/index.ts
@@ -7,6 +7,7 @@ import { seekCommand } from './seek.js';
 import { skipCommand } from './skip.js';
 import { nowPlayingCommand } from './nowplaying.js';
 import { helpCommand } from './help.js';
+import { volumeCommand } from './volume.js';
 
 export type CommandHandler = (message: Message, args: string[]) => Promise<void>;
 
@@ -27,6 +28,9 @@ const commands: Record<string, CommandHandler> = {
   np: nowPlayingCommand,
   nowplaying: nowPlayingCommand,
   playing: nowPlayingCommand,
+  volume: volumeCommand,
+  vol: volumeCommand,
+  v: volumeCommand,
 };
 
 export async function handleCommand(
diff --git a/src/bot/commands/volume.ts b/src/bot/commands/volume.ts
new file mode 100644
index 0000000..6e47411
--- /dev/null
+++ b/src/bot/commands/volume.ts
@@ -0,0 +1,42 @@
+import type { Message } from 'discord.js-selfbot-v13';
+import { getVideoStreamer } from '../../stream/video-streamer.js';
+
+export async function volumeCommand(message: Message, args: string[]): Promise<void> {
+  if (!message.guild) {
+    await message.channel.send('❌ This command can only be used in a server');
+    return;
+  }
+
+  const guildId = message.guild.id;
+  const videoStreamer = getVideoStreamer();
+  const session = videoStreamer.getSession(guildId);
+
+  if (!session) {
+    await message.channel.send('❌ Nothing is currently playing');
+    return;
+  }
+
+  // If no args, show current volume
+  if (args.length === 0) {
+    const currentVolume = session.volume ?? 100;
+    await message.channel.send(`🔊 Current volume: **${currentVolume}%**`);
+    return;
+  }
+
+  const volumeArg = args[0].replace('%', '');
+  const volume = parseInt(volumeArg, 10);
+
+  if (isNaN(volume) || volume < 0 || volume > 200) {
+    await message.channel.send('❌ Volume must be a number between 0 and 200');
+    return;
+  }
+
+  const success = videoStreamer.setVolume(guildId, volume);
+
+  if (success) {
+    const icon = volume === 0 ? '🔇' : volume < 50 ? '🔈' : volume < 100 ? '🔉' : '🔊';
+    await message.channel.send(`${icon} Volume set to **${volume}%**`);
+  } else {
+    await message.channel.send('❌ Failed to set volume');
+  }
+}
diff --git a/src/stream/video-streamer.ts b/src/stream/video-streamer.ts
index a4b1731..71d23dc 100644
--- a/src/stream/video-streamer.ts
+++ b/src/stream/video-streamer.ts
@@ -13,6 +13,7 @@ export interface VideoStreamSession {
   startedAt: number;
   currentTime: number;
   duration: number;
+  volume: number;
   ffmpegCommand: any | null;
 }
 
@@ -56,6 +57,7 @@ class VideoStreamer {
       startedAt: Date.now(),
       currentTime: startTimeMs,
       duration: mediaItem.duration || 0,
+      volume: 100,
       ffmpegCommand: null,
     };
 
@@ -114,6 +116,7 @@ class VideoStreamer {
         'X-Plex-Version: 4.0',
         'X-Plex-Platform: Chrome',
         'X-Plex-Device: Linux',
+        'X-Plex-Token: ' + config.plex.token,
       ].join('\r\n') + '\r\n';
 
       const ffmpegArgs = [
@@ -293,6 +296,19 @@ class VideoStreamer {
 
     return { current, total, percentage };
   }
+
+  setVolume(guildId: string, volume: number): boolean {
+    const session = this.sessions.get(guildId);
+    if (!session) return false;
+
+    session.volume = Math.max(0, Math.min(200, volume));
+    
+    // Volume change requires restarting the stream with new FFmpeg settings
+    // For now, just store the value - it will be applied on next play/seek
+    console.log(`[VideoStreamer] Volume set to ${session.volume}% (will apply on next playback)`);
+    
+    return true;
+  }
 }
 
 let videoStreamerInstance: VideoStreamer | null = null;

From 8112a94bb304910e35e6bd15d45338f15db5548c Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:34:35 +1100
Subject: [PATCH 05/12] feat: improve search results - separate Movies/TV
 Shows, show ALL results
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Movies shown in separate section with 🎬 icon
- TV Shows shown in separate section with 📺 icon
- Episodes shown in separate section with 📼 icon
- Removed result truncation - shows all results
- Global numbering maintained for !play command
---
 src/plex/search.ts | 39 +++++++++++++++++++++++++++++++--------
 1 file changed, 31 insertions(+), 8 deletions(-)

diff --git a/src/plex/search.ts b/src/plex/search.ts
index 0163f0b..e1a0768 100644
--- a/src/plex/search.ts
+++ b/src/plex/search.ts
@@ -42,11 +42,20 @@ export function formatSearchResults(items: PlexMediaItem[]): string {
     return 'No results found.';
   }
 
-  const lines = items.slice(0, 10).map((item, index) => {
-    const num = `**${index + 1}.**`;
+  // Separate by type
+  const movies = items.filter(item => item.type === 'movie');
+  const shows = items.filter(item => item.type === 'show');
+  const episodes = items.filter(item => item.type === 'episode');
+
+  const sections: string[] = [];
+  let globalIndex = 0;
+
+  // Format a single item
+  const formatItem = (item: PlexMediaItem): string => {
+    globalIndex++;
+    const num = `**${globalIndex}.**`;
     const title = item.title;
     const year = item.year ? ` (${item.year})` : '';
-    const type = item.type.charAt(0).toUpperCase() + item.type.slice(1);
 
     let extra = '';
     if (item.type === 'episode') {
@@ -56,14 +65,28 @@ export function formatSearchResults(items: PlexMediaItem[]): string {
       extra = ` - ${show} ${season}${episode}`;
     }
 
-    return `${num} [${type}] ${title}${year}${extra}`;
-  });
+    return `${num} ${title}${year}${extra}`;
+  };
+
+  // Movies section
+  if (movies.length > 0) {
+    const movieLines = movies.map(formatItem);
+    sections.push(`**🎬 Movies (${movies.length})**\n${movieLines.join('\n')}`);
+  }
+
+  // TV Shows section
+  if (shows.length > 0) {
+    const showLines = shows.map(formatItem);
+    sections.push(`**📺 TV Shows (${shows.length})**\n${showLines.join('\n')}`);
+  }
 
-  if (items.length > 10) {
-    lines.push(`\n*...and ${items.length - 10} more results*`);
+  // Episodes section (if any direct episode matches)
+  if (episodes.length > 0) {
+    const episodeLines = episodes.map(formatItem);
+    sections.push(`**📼 Episodes (${episodes.length})**\n${episodeLines.join('\n')}`);
   }
 
-  return lines.join('\n');
+  return sections.join('\n\n');
 }
 
 export default {

From 4b713c0d67084cd7b5f1c66276d261b6b3e137f7 Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:38:12 +1100
Subject: [PATCH 06/12] feat: add playback position tracking and fix
 pause/resume

- Track playback position across sessions (7 day expiry)
- Pause now properly preserves session (isStopping flag)
- Resume works correctly after pause
- Play command offers to resume from where user left off
- !play resume / !play start for continue or restart
- Position saved on stop/pause/error
---
 src/bot/commands/play.ts     | 85 +++++++++++++++++++++++++++++++-----
 src/stream/video-streamer.ts | 53 ++++++++++++++++++++--
 2 files changed, 123 insertions(+), 15 deletions(-)

diff --git a/src/bot/commands/play.ts b/src/bot/commands/play.ts
index 8e8f6b3..4be2c7d 100644
--- a/src/bot/commands/play.ts
+++ b/src/bot/commands/play.ts
@@ -1,10 +1,13 @@
 import type { Message } from 'discord.js-selfbot-v13';
 import { getSearchResult, clearSearchSession } from '../../plex/search.js';
-import { getVideoStreamer } from '../../stream/video-streamer.js';
+import { getVideoStreamer, getPlaybackPosition, clearPlaybackPosition } from '../../stream/video-streamer.js';
 import { formatDuration } from '../../plex/library.js';
 import plexClient from '../../plex/client.js';
 import type { PlexMediaItem } from '../../types/index.js';
 
+// Store pending resume prompts (mediaItem ratingKey -> { message, mediaItem, guildId, channelId })
+const pendingResume = new Map<string, { userId: string; mediaItem: PlexMediaItem; guildId: string; channelId: string; position: number }>();
+
 export async function playCommand(message: Message, args: string[]): Promise<void> {
   if (!message.guild) {
     await message.channel.send('❌ This command can only be used in a server');
@@ -19,6 +22,29 @@ export async function playCommand(message: Message, args: string[]): Promise<voi
     return;
   }
 
+  // Check for resume confirmation
+  const firstArg = args[0]?.toLowerCase();
+  if (firstArg === 'resume' || firstArg === 'r') {
+    const pending = [...pendingResume.values()].find(p => p.userId === message.author.id);
+    if (pending) {
+      pendingResume.delete(pending.mediaItem.ratingKey);
+      const statusMsg = await message.channel.send(`▶️ Resuming from ${formatDuration(pending.position)}...`);
+      await startVideoStream(statusMsg, pending.guildId, pending.channelId, pending.mediaItem, pending.position);
+      return;
+    }
+  }
+  
+  if (firstArg === 'start' || firstArg === 'new' || firstArg === 'beginning') {
+    const pending = [...pendingResume.values()].find(p => p.userId === message.author.id);
+    if (pending) {
+      pendingResume.delete(pending.mediaItem.ratingKey);
+      clearPlaybackPosition(pending.mediaItem.ratingKey);
+      const statusMsg = await message.channel.send(`🎬 Starting from beginning...`);
+      await startVideoStream(statusMsg, pending.guildId, pending.channelId, pending.mediaItem, 0);
+      return;
+    }
+  }
+
   const selection = parseInt(args[0], 10);
 
   if (isNaN(selection) || selection < 1) {
@@ -33,26 +59,60 @@ export async function playCommand(message: Message, args: string[]): Promise<voi
     return;
   }
 
-  const statusMsg = await message.channel.send(`🎬 Loading "${mediaItem.title}"...`);
-
   try {
+    let itemToPlay = mediaItem;
+    
     if (mediaItem.type === 'show') {
       const episodes = await plexClient.getEpisodes(mediaItem.ratingKey);
       if (episodes.length === 0) {
-        await statusMsg.edit('❌ No episodes found for this show');
+        await message.channel.send('❌ No episodes found for this show');
         return;
       }
-
-      const firstEpisode = episodes[0];
-      await startVideoStream(statusMsg, message.guild!.id, voiceChannel.id, firstEpisode);
-    } else {
-      await startVideoStream(statusMsg, message.guild!.id, voiceChannel.id, mediaItem);
+      itemToPlay = episodes[0];
     }
+    
+    // Check for saved position
+    const savedPosition = getPlaybackPosition(itemToPlay.ratingKey);
+    
+    if (savedPosition && savedPosition > 60000) { // More than 1 minute
+      const duration = itemToPlay.duration || 0;
+      const percentWatched = duration > 0 ? Math.round((savedPosition / duration) * 100) : 0;
+      
+      // Store pending resume
+      pendingResume.set(itemToPlay.ratingKey, {
+        userId: message.author.id,
+        mediaItem: itemToPlay,
+        guildId: message.guild!.id,
+        channelId: voiceChannel.id,
+        position: savedPosition,
+      });
+      
+      // Clear after 30 seconds
+      setTimeout(() => pendingResume.delete(itemToPlay.ratingKey), 30000);
+      
+      let title = itemToPlay.title;
+      if (itemToPlay.type === 'episode' && itemToPlay.grandparentTitle) {
+        const season = itemToPlay.parentIndex ? `S${String(itemToPlay.parentIndex).padStart(2, '0')}` : '';
+        const episode = itemToPlay.index ? `E${String(itemToPlay.index).padStart(2, '0')}` : '';
+        title = `${itemToPlay.grandparentTitle} ${season}${episode}`;
+      }
+      
+      await message.channel.send(
+        `⏸️ **Resume Playback?**\n` +
+        `You were watching **${title}** at ${formatDuration(savedPosition)} (${percentWatched}%)\n\n` +
+        `\`!play resume\` - Continue where you left off\n` +
+        `\`!play start\` - Start from beginning`
+      );
+      return;
+    }
+
+    const statusMsg = await message.channel.send(`🎬 Loading "${mediaItem.title}"...`);
+    await startVideoStream(statusMsg, message.guild!.id, voiceChannel.id, itemToPlay, 0);
 
     clearSearchSession(message.author.id);
   } catch (error) {
     console.error('[Play] Error:', error);
-    await statusMsg.edit(`❌ Failed to start stream: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    await message.channel.send(`❌ Failed to start stream: ${error instanceof Error ? error.message : 'Unknown error'}`);
   }
 }
 
@@ -60,7 +120,8 @@ async function startVideoStream(
   statusMsg: Message,
   guildId: string,
   channelId: string,
-  mediaItem: PlexMediaItem
+  mediaItem: PlexMediaItem,
+  startTimeMs = 0
 ): Promise<void> {
   const videoStreamer = getVideoStreamer();
 
@@ -85,7 +146,7 @@ async function startVideoStream(
     channelId,
     mediaItem,
     streamInfo.url,
-    0
+    startTimeMs
   ).catch((err) => {
     console.error('[Play] Stream error:', err);
   });
diff --git a/src/stream/video-streamer.ts b/src/stream/video-streamer.ts
index 71d23dc..618fe56 100644
--- a/src/stream/video-streamer.ts
+++ b/src/stream/video-streamer.ts
@@ -10,6 +10,7 @@ export interface VideoStreamSession {
   mediaItem: PlexMediaItem;
   streamUrl: string;
   isPaused: boolean;
+  isStopping: boolean; // Flag to track intentional stop (pause/seek)
   startedAt: number;
   currentTime: number;
   duration: number;
@@ -17,6 +18,28 @@ export interface VideoStreamSession {
   ffmpegCommand: any | null;
 }
 
+// Store playback positions for resume functionality (ratingKey -> position in ms)
+const playbackHistory = new Map<string, { position: number; updatedAt: number }>();
+
+export function getPlaybackPosition(ratingKey: string): number | null {
+  const history = playbackHistory.get(ratingKey);
+  if (!history) return null;
+  // Expire after 7 days
+  if (Date.now() - history.updatedAt > 7 * 24 * 60 * 60 * 1000) {
+    playbackHistory.delete(ratingKey);
+    return null;
+  }
+  return history.position;
+}
+
+export function savePlaybackPosition(ratingKey: string, position: number): void {
+  playbackHistory.set(ratingKey, { position, updatedAt: Date.now() });
+}
+
+export function clearPlaybackPosition(ratingKey: string): void {
+  playbackHistory.delete(ratingKey);
+}
+
 class VideoStreamer {
   public streamer: Streamer;
   private sessions: Map<string, VideoStreamSession> = new Map();
@@ -54,6 +77,7 @@ class VideoStreamer {
       mediaItem,
       streamUrl,
       isPaused: false,
+      isStopping: false,
       startedAt: Date.now(),
       currentTime: startTimeMs,
       duration: mediaItem.duration || 0,
@@ -188,12 +212,22 @@ class VideoStreamer {
       });
 
       console.log('[VideoStreamer] Playback finished');
-      this.sessions.delete(session.guildId);
+      // Only delete session if not intentionally stopped (pause/seek)
+      if (!session.isStopping) {
+        // Save position for resume later
+        savePlaybackPosition(session.mediaItem.ratingKey, this.getCurrentTime(session.guildId));
+        this.sessions.delete(session.guildId);
+      }
     } catch (error) {
-      if (error instanceof Error && !error.message.includes('abort')) {
+      // Only log error if not intentionally stopped
+      if (!session.isStopping && error instanceof Error && !error.message.includes('abort')) {
         console.error('[VideoStreamer] Stream error:', error);
       }
-      this.sessions.delete(session.guildId);
+      // Only delete session if not intentionally stopped
+      if (!session.isStopping) {
+        savePlaybackPosition(session.mediaItem.ratingKey, this.getCurrentTime(session.guildId));
+        this.sessions.delete(session.guildId);
+      }
     }
   }
 
@@ -201,6 +235,9 @@ class VideoStreamer {
     const session = this.sessions.get(guildId);
 
     if (session) {
+      // Save position before stopping
+      savePlaybackPosition(session.mediaItem.ratingKey, this.getCurrentTime(guildId));
+      
       if (session.ffmpegCommand) {
         try {
           session.ffmpegCommand.kill('SIGKILL');
@@ -226,6 +263,7 @@ class VideoStreamer {
 
     session.currentTime = timeMs;
     session.startedAt = Date.now();
+    session.isStopping = true; // Mark as intentional stop
 
     if (session.ffmpegCommand) {
       try {
@@ -235,6 +273,10 @@ class VideoStreamer {
       }
     }
 
+    // Wait a bit for FFmpeg to fully stop
+    await new Promise(resolve => setTimeout(resolve, 500));
+    
+    session.isStopping = false;
     await this.playVideoStream(session, timeMs);
     return true;
   }
@@ -246,6 +288,7 @@ class VideoStreamer {
     if (!session.isPaused) {
       session.currentTime = this.getCurrentTime(guildId);
       session.isPaused = true;
+      session.isStopping = true; // Mark as intentional stop
 
       if (session.ffmpegCommand) {
         try {
@@ -256,6 +299,9 @@ class VideoStreamer {
       }
 
       this.streamer.stopStream();
+      
+      // Save position for later resume
+      savePlaybackPosition(session.mediaItem.ratingKey, session.currentTime);
     }
 
     return true;
@@ -266,6 +312,7 @@ class VideoStreamer {
     if (!session || !session.isPaused) return false;
 
     session.isPaused = false;
+    session.isStopping = false;
     session.startedAt = Date.now();
 
     await this.playVideoStream(session, session.currentTime);

From 00255d4f65ed18e537192d0f46a7e1a117036ca2 Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:39:04 +1100
Subject: [PATCH 07/12] feat: persist playback history to disk
 (data/playback-history.json)

- Saves to data/playback-history.json on every position update
- Loads on startup, survives restarts
- Added data/ to .gitignore
- 7 day expiry still applies
---
 .gitignore                   |  1 +
 src/stream/video-streamer.ts | 55 ++++++++++++++++++++++++++++++++++--
 2 files changed, 53 insertions(+), 3 deletions(-)

diff --git a/.gitignore b/.gitignore
index 5a8b613..de845a0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -34,3 +34,4 @@ yarn-error.log*
 # Temporary files
 tmp/
 temp/
+data/
diff --git a/src/stream/video-streamer.ts b/src/stream/video-streamer.ts
index 618fe56..b4660aa 100644
--- a/src/stream/video-streamer.ts
+++ b/src/stream/video-streamer.ts
@@ -1,9 +1,14 @@
 import { Streamer, prepareStream, playStream, Utils } from '@dank074/discord-video-stream';
 import { Client } from 'discord.js-selfbot-v13';
 import { spawn } from 'child_process';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
 import type { PlexMediaItem } from '../types/index.js';
 import config from '../config.js';
 
+// Playback history file path
+const HISTORY_FILE = join(process.cwd(), 'data', 'playback-history.json');
+
 export interface VideoStreamSession {
   guildId: string;
   channelId: string;
@@ -19,7 +24,48 @@ export interface VideoStreamSession {
 }
 
 // Store playback positions for resume functionality (ratingKey -> position in ms)
-const playbackHistory = new Map<string, { position: number; updatedAt: number }>();
+interface PlaybackHistoryEntry {
+  position: number;
+  updatedAt: number;
+  title?: string;
+}
+
+let playbackHistory: Map<string, PlaybackHistoryEntry> = new Map();
+
+// Load playback history from disk
+function loadPlaybackHistory(): void {
+  try {
+    if (existsSync(HISTORY_FILE)) {
+      const data = readFileSync(HISTORY_FILE, 'utf-8');
+      const parsed = JSON.parse(data);
+      playbackHistory = new Map(Object.entries(parsed));
+      console.log(`[PlaybackHistory] Loaded ${playbackHistory.size} entries from disk`);
+    }
+  } catch (error) {
+    console.error('[PlaybackHistory] Failed to load:', error);
+    playbackHistory = new Map();
+  }
+}
+
+// Save playback history to disk
+function persistPlaybackHistory(): void {
+  try {
+    // Ensure data directory exists
+    const dataDir = join(process.cwd(), 'data');
+    if (!existsSync(dataDir)) {
+      const { mkdirSync } = require('fs');
+      mkdirSync(dataDir, { recursive: true });
+    }
+    
+    const obj = Object.fromEntries(playbackHistory);
+    writeFileSync(HISTORY_FILE, JSON.stringify(obj, null, 2));
+  } catch (error) {
+    console.error('[PlaybackHistory] Failed to save:', error);
+  }
+}
+
+// Initialize on module load
+loadPlaybackHistory();
 
 export function getPlaybackPosition(ratingKey: string): number | null {
   const history = playbackHistory.get(ratingKey);
@@ -27,17 +73,20 @@ export function getPlaybackPosition(ratingKey: string): number | null {
   // Expire after 7 days
   if (Date.now() - history.updatedAt > 7 * 24 * 60 * 60 * 1000) {
     playbackHistory.delete(ratingKey);
+    persistPlaybackHistory();
     return null;
   }
   return history.position;
 }
 
-export function savePlaybackPosition(ratingKey: string, position: number): void {
-  playbackHistory.set(ratingKey, { position, updatedAt: Date.now() });
+export function savePlaybackPosition(ratingKey: string, position: number, title?: string): void {
+  playbackHistory.set(ratingKey, { position, updatedAt: Date.now(), title });
+  persistPlaybackHistory();
 }
 
 export function clearPlaybackPosition(ratingKey: string): void {
   playbackHistory.delete(ratingKey);
+  persistPlaybackHistory();
 }
 
 class VideoStreamer {

From 00325f43b39c1a7fdf29268fb587f4fe1099fcc0 Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:39:32 +1100
Subject: [PATCH 08/12] docs: update help command with resume/start options

- Added !play resume and !play start commands
- Clarified pause remembers position
- Added !resume command reference
- Note about position persistence
---
 src/bot/commands/help.ts | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/bot/commands/help.ts b/src/bot/commands/help.ts
index b746a5d..cf20e63 100644
--- a/src/bot/commands/help.ts
+++ b/src/bot/commands/help.ts
@@ -10,10 +10,13 @@ export async function helpCommand(message: Message, _args: string[]): Promise<vo
 **Media Search & Playback:**
 \`${prefix}search <query>\` - Search for movies or TV shows
 \`${prefix}play <number>\` - Play a result from your search
+\`${prefix}play resume\` - Continue where you left off
+\`${prefix}play start\` - Start from beginning (ignore saved position)
 \`${prefix}stop\` - Stop the current stream
 
 **Playback Controls:**
-\`${prefix}pause\` - Pause/resume playback
+\`${prefix}pause\` - Pause playback (remembers position)
+\`${prefix}resume\` - Resume paused playback
 \`${prefix}seek <time>\` - Seek to time (e.g., \`1:30:00\` or \`45:00\`)
 \`${prefix}skip\` - Skip to next episode (TV shows only)
 \`${prefix}np\` - Show what's currently playing
@@ -24,7 +27,7 @@ export async function helpCommand(message: Message, _args: string[]): Promise<vo
 2. \`${prefix}play 1\`
 3. Enjoy the stream! 🎬
 
-*Note: You must be in a voice channel to start playback.*
+*Your playback position is saved automatically and persists across restarts.*
   `.trim();
 
   await message.channel.send(helpText);

From c49dc69a008b37ce7e2984353a474910fa1b0a0c Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:43:46 +1100
Subject: [PATCH 09/12] feat: volume changes apply immediately by restarting
 stream

- setVolume now restarts stream at current position with new volume
- FFmpeg audio filter applies volume (0-200% -> 0.0-2.0 multiplier)
- Shows status message while changing volume
- If paused, volume will apply on resume
---
 src/bot/commands/volume.ts   |  8 +++++---
 src/stream/video-streamer.ts | 35 ++++++++++++++++++++++++++++++-----
 2 files changed, 35 insertions(+), 8 deletions(-)

diff --git a/src/bot/commands/volume.ts b/src/bot/commands/volume.ts
index 6e47411..4e41fc9 100644
--- a/src/bot/commands/volume.ts
+++ b/src/bot/commands/volume.ts
@@ -31,12 +31,14 @@ export async function volumeCommand(message: Message, args: string[]): Promise<v
     return;
   }
 
-  const success = videoStreamer.setVolume(guildId, volume);
+  const statusMsg = await message.channel.send(`🔊 Changing volume to **${volume}%**...`);
+  
+  const success = await videoStreamer.setVolume(guildId, volume);
 
   if (success) {
     const icon = volume === 0 ? '🔇' : volume < 50 ? '🔈' : volume < 100 ? '🔉' : '🔊';
-    await message.channel.send(`${icon} Volume set to **${volume}%**`);
+    await statusMsg.edit(`${icon} Volume set to **${volume}%**`);
   } else {
-    await message.channel.send('❌ Failed to set volume');
+    await statusMsg.edit('❌ Failed to set volume');
   }
 }
diff --git a/src/stream/video-streamer.ts b/src/stream/video-streamer.ts
index b4660aa..178ae37 100644
--- a/src/stream/video-streamer.ts
+++ b/src/stream/video-streamer.ts
@@ -208,6 +208,9 @@ class VideoStreamer {
         ffmpegArgs.push('-ss', startTimeSec.toString());
       }
 
+      // Calculate volume filter (100% = 1.0, 50% = 0.5, 200% = 2.0)
+      const volumeMultiplier = (session.volume / 100).toFixed(2);
+
       ffmpegArgs.push(
         '-i', actualStreamUrl,
         // Video output
@@ -221,7 +224,8 @@ class VideoStreamer {
         '-r', '30',
         '-g', '60',
         '-pix_fmt', 'yuv420p',
-        // Audio output
+        // Audio output with volume filter
+        '-af', `volume=${volumeMultiplier}`,
         '-c:a', 'libopus',
         '-b:a', `${config.stream.audioBitrate}k`,
         '-ar', '48000',
@@ -393,15 +397,36 @@ class VideoStreamer {
     return { current, total, percentage };
   }
 
-  setVolume(guildId: string, volume: number): boolean {
+  async setVolume(guildId: string, volume: number): Promise<boolean> {
     const session = this.sessions.get(guildId);
     if (!session) return false;
 
+    const oldVolume = session.volume;
     session.volume = Math.max(0, Math.min(200, volume));
     
-    // Volume change requires restarting the stream with new FFmpeg settings
-    // For now, just store the value - it will be applied on next play/seek
-    console.log(`[VideoStreamer] Volume set to ${session.volume}% (will apply on next playback)`);
+    // If currently playing (not paused), restart stream at current position with new volume
+    if (!session.isPaused && session.ffmpegCommand) {
+      const currentTime = this.getCurrentTime(guildId);
+      console.log(`[VideoStreamer] Volume changing from ${oldVolume}% to ${session.volume}%, restarting at ${Math.floor(currentTime / 1000)}s...`);
+      
+      session.currentTime = currentTime;
+      session.isStopping = true;
+      
+      try {
+        session.ffmpegCommand.kill('SIGKILL');
+      } catch {
+        // Ignore
+      }
+      
+      // Wait for FFmpeg to stop
+      await new Promise(resolve => setTimeout(resolve, 500));
+      
+      session.isStopping = false;
+      session.startedAt = Date.now();
+      await this.playVideoStream(session, currentTime);
+    } else {
+      console.log(`[VideoStreamer] Volume set to ${session.volume}% (will apply on resume)`);
+    }
     
     return true;
   }

From d2a86cfa0b15e77647353f475e989d6342b001cf Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:45:08 +1100
Subject: [PATCH 10/12] fix: properly import mkdirSync for data directory
 creation

- Import mkdirSync at top level instead of require()
- Added logging for directory creation and save operations
---
 src/stream/video-streamer.ts | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/stream/video-streamer.ts b/src/stream/video-streamer.ts
index 178ae37..deba999 100644
--- a/src/stream/video-streamer.ts
+++ b/src/stream/video-streamer.ts
@@ -1,7 +1,7 @@
 import { Streamer, prepareStream, playStream, Utils } from '@dank074/discord-video-stream';
 import { Client } from 'discord.js-selfbot-v13';
 import { spawn } from 'child_process';
-import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import type { PlexMediaItem } from '../types/index.js';
 import config from '../config.js';
@@ -53,12 +53,13 @@ function persistPlaybackHistory(): void {
     // Ensure data directory exists
     const dataDir = join(process.cwd(), 'data');
     if (!existsSync(dataDir)) {
-      const { mkdirSync } = require('fs');
       mkdirSync(dataDir, { recursive: true });
+      console.log('[PlaybackHistory] Created data directory');
     }
     
     const obj = Object.fromEntries(playbackHistory);
     writeFileSync(HISTORY_FILE, JSON.stringify(obj, null, 2));
+    console.log(`[PlaybackHistory] Saved ${playbackHistory.size} entries to disk`);
   } catch (error) {
     console.error('[PlaybackHistory] Failed to save:', error);
   }

From 407b2337613b41344c666fb69f2adca2d516561b Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 14:49:05 +1100
Subject: [PATCH 11/12] fix: get fresh Plex stream URL when restarting stream

- Seek, resume, and volume changes now get fresh stream URL
- Old Plex session ID was causing premature stream end
- Each restart creates new Plex transcode session
---
 src/plex/client.ts           |  4 +++-
 src/stream/video-streamer.ts | 19 +++++++++++++++++++
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/src/plex/client.ts b/src/plex/client.ts
index dadbb02..9271564 100644
--- a/src/plex/client.ts
+++ b/src/plex/client.ts
@@ -210,9 +210,10 @@ export class PlexClient {
         autoAdjustQuality: '0',
         directStreamAudio: '1',
         mediaBufferSize: '102400',
+        copyts: '1',
         'X-Plex-Session-Identifier': sessionId,
         'X-Plex-Token': this.token,
-        'X-Plex-Client-Identifier': 'SchroStream',
+        'X-Plex-Client-Identifier': config.plex.clientIdentifier,
         'X-Plex-Product': 'SchroStream',
         'X-Plex-Device': 'Node',
         'X-Plex-Platform': 'Node',
@@ -252,6 +253,7 @@ export class PlexClient {
       videoResolution: `${width}x${height}`,
       videoQuality: '100',
       'X-Plex-Token': this.token,
+      'X-Plex-Client-Identifier': config.plex.clientIdentifier,
     });
 
     return `${this.baseUrl}/video/:/transcode/universal/start.m3u8?${params.toString()}`;
diff --git a/src/stream/video-streamer.ts b/src/stream/video-streamer.ts
index deba999..1b27f71 100644
--- a/src/stream/video-streamer.ts
+++ b/src/stream/video-streamer.ts
@@ -5,6 +5,7 @@ import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import type { PlexMediaItem } from '../types/index.js';
 import config from '../config.js';
+import plexClient from '../plex/client.js';
 
 // Playback history file path
 const HISTORY_FILE = join(process.cwd(), 'data', 'playback-history.json');
@@ -330,6 +331,12 @@ class VideoStreamer {
     // Wait a bit for FFmpeg to fully stop
     await new Promise(resolve => setTimeout(resolve, 500));
     
+    // Get fresh stream URL (new Plex session)
+    const freshStreamInfo = await plexClient.getDirectStreamUrl(session.mediaItem.ratingKey);
+    if (freshStreamInfo) {
+      session.streamUrl = freshStreamInfo.url;
+    }
+    
     session.isStopping = false;
     await this.playVideoStream(session, timeMs);
     return true;
@@ -365,6 +372,12 @@ class VideoStreamer {
     const session = this.sessions.get(guildId);
     if (!session || !session.isPaused) return false;
 
+    // Get fresh stream URL (new Plex session)
+    const freshStreamInfo = await plexClient.getDirectStreamUrl(session.mediaItem.ratingKey);
+    if (freshStreamInfo) {
+      session.streamUrl = freshStreamInfo.url;
+    }
+
     session.isPaused = false;
     session.isStopping = false;
     session.startedAt = Date.now();
@@ -422,6 +435,12 @@ class VideoStreamer {
       // Wait for FFmpeg to stop
       await new Promise(resolve => setTimeout(resolve, 500));
       
+      // Get fresh stream URL (new Plex session)
+      const freshStreamInfo = await plexClient.getDirectStreamUrl(session.mediaItem.ratingKey);
+      if (freshStreamInfo) {
+        session.streamUrl = freshStreamInfo.url;
+      }
+      
       session.isStopping = false;
       session.startedAt = Date.now();
       await this.playVideoStream(session, currentTime);

From dda8d41bd8a79d8e11a24eb87ad66f48e1db6248 Mon Sep 17 00:00:00 2001
From: Joseph Shenton <joe@deiterate.com>
Date: Fri, 19 Dec 2025 15:10:42 +1100
Subject: [PATCH 12/12] feat: add episode selection and improve transcode
 session handling

- Added !episodes command to list seasons/episodes for shows
- Play command now supports episode selection (!play 1 S02E05 or !play 1 2 5)
- Stop existing transcode sessions before starting new ones to avoid 400 errors
- Simplified Plex client identifier to 'SchroStream'
- Removed copyts parameter from transcode options
- Updated help command with new episode selection syntax
- Added docs build artifacts to .gitignore
---
 .dockerignore                        |  11 +
 .github/workflows/docker-publish.yml |  67 +++++
 .github/workflows/docs.yml           |  55 +++++
 .gitignore                           |   3 +
 Dockerfile                           |  37 +++
 docker-compose.yml                   |  22 ++
 docs/.vitepress/config.ts            |  64 +++++
 docs/bun.lock                        | 352 +++++++++++++++++++++++++++
 docs/guide/commands.md               | 170 +++++++++++++
 docs/guide/configuration.md          |  95 ++++++++
 docs/guide/discord-token.md          |  60 +++++
 docs/guide/docker-compose.md         | 171 +++++++++++++
 docs/guide/docker.md                 | 136 +++++++++++
 docs/guide/getting-started.md        |  68 ++++++
 docs/guide/introduction.md           |  37 +++
 docs/guide/local-install.md          | 109 +++++++++
 docs/guide/permissions.md            | 101 ++++++++
 docs/guide/plex-token.md             |  64 +++++
 docs/guide/prerequisites.md          |  68 ++++++
 docs/guide/troubleshooting.md        | 127 ++++++++++
 docs/index.md                        |  35 +++
 docs/package.json                    |  13 +
 src/bot/commands/episodes.ts         |  99 ++++++++
 src/bot/commands/help.ts             |   5 +-
 src/bot/commands/index.ts            |   4 +
 src/bot/commands/play.ts             |  34 ++-
 src/plex/client.ts                   |  21 +-
 src/stream/video-streamer.ts         |   3 +
 28 files changed, 2025 insertions(+), 6 deletions(-)
 create mode 100644 .dockerignore
 create mode 100644 .github/workflows/docker-publish.yml
 create mode 100644 .github/workflows/docs.yml
 create mode 100644 Dockerfile
 create mode 100644 docker-compose.yml
 create mode 100644 docs/.vitepress/config.ts
 create mode 100644 docs/bun.lock
 create mode 100644 docs/guide/commands.md
 create mode 100644 docs/guide/configuration.md
 create mode 100644 docs/guide/discord-token.md
 create mode 100644 docs/guide/docker-compose.md
 create mode 100644 docs/guide/docker.md
 create mode 100644 docs/guide/getting-started.md
 create mode 100644 docs/guide/introduction.md
 create mode 100644 docs/guide/local-install.md
 create mode 100644 docs/guide/permissions.md
 create mode 100644 docs/guide/plex-token.md
 create mode 100644 docs/guide/prerequisites.md
 create mode 100644 docs/guide/troubleshooting.md
 create mode 100644 docs/index.md
 create mode 100644 docs/package.json
 create mode 100644 src/bot/commands/episodes.ts

diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..0b04a3c
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,11 @@
+node_modules
+dist
+.env
+.env.local
+*.log
+.git
+.gitignore
+.DS_Store
+docs/.vitepress/cache
+docs/.vitepress/dist
+data
diff --git a/.github/workflows/docker-publish.yml b/.github/workflows/docker-publish.yml
new file mode 100644
index 0000000..5a68427
--- /dev/null
+++ b/.github/workflows/docker-publish.yml
@@ -0,0 +1,67 @@
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    tags:
+      - 'v*'
+  pull_request:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels)
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 0000000..098a64f
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,55 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - 'docs/**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: cd docs && bun install
+
+      - name: Build docs
+        run: cd docs && bun run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
index de845a0..9ddaa69 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,8 +1,11 @@
 # Dependencies
 node_modules/
+docs/node_modules/
+docs/.vitepress/cache
 
 # Build output
 dist/
+docs/dist/
 
 # Environment
 .env
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..0ed8b39
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,37 @@
+# Build stage
+FROM oven/bun:latest AS base
+WORKDIR /app
+
+# Install dependencies
+FROM base AS install
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile --production
+
+# Release stage
+FROM base AS release
+
+# Install FFmpeg
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends ffmpeg && \
+    rm -rf /var/lib/apt/lists/*
+
+# Copy dependencies
+COPY --from=install /app/node_modules ./node_modules
+
+# Copy source
+COPY . .
+
+# Build TypeScript
+RUN bun run build
+
+# Create data directory
+RUN mkdir -p /app/data
+
+# Set environment
+ENV NODE_ENV=production
+
+# Volume for persistent data
+VOLUME ["/app/data"]
+
+# Run the app
+CMD ["bun", "start"]
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..a5cbcd2
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,22 @@
+version: '3.8'
+
+services:
+  schrostream:
+    build: .
+    container_name: schrostream
+    restart: unless-stopped
+    network_mode: host
+    environment:
+      - DISCORD_TOKEN=${DISCORD_TOKEN}
+      - PLEX_URL=${PLEX_URL}
+      - PLEX_TOKEN=${PLEX_TOKEN}
+      - COMMAND_PREFIX=${COMMAND_PREFIX:-!}
+      - ALLOWED_USERS=${ALLOWED_USERS:-}
+      - ALLOWED_ROLES=${ALLOWED_ROLES:-}
+      - ALLOWED_GUILDS=${ALLOWED_GUILDS:-}
+      - DEFAULT_QUALITY=${DEFAULT_QUALITY:-1080}
+      - MAX_BITRATE=${MAX_BITRATE:-8000}
+      - AUDIO_BITRATE=${AUDIO_BITRATE:-192}
+      - PLEX_CLIENT_IDENTIFIER=${PLEX_CLIENT_IDENTIFIER:-SchroStream}
+    volumes:
+      - ./data:/app/data
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
new file mode 100644
index 0000000..6825c89
--- /dev/null
+++ b/docs/.vitepress/config.ts
@@ -0,0 +1,64 @@
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+  title: 'SchroStream',
+  description: 'Discord Plex Streaming Self-Bot Documentation',
+  
+  head: [
+    ['link', { rel: 'icon', href: '/favicon.ico' }]
+  ],
+
+  themeConfig: {
+    logo: '/logo.png',
+    
+    nav: [
+      { text: 'Home', link: '/' },
+      { text: 'Guide', link: '/guide/getting-started' },
+      { text: 'GitHub', link: 'https://github.com/moderniselife/SchroStream' }
+    ],
+
+    sidebar: [
+      {
+        text: 'Introduction',
+        items: [
+          { text: 'What is SchroStream?', link: '/guide/introduction' },
+          { text: 'Getting Started', link: '/guide/getting-started' },
+        ]
+      },
+      {
+        text: 'Setup',
+        items: [
+          { text: 'Prerequisites', link: '/guide/prerequisites' },
+          { text: 'Discord Token', link: '/guide/discord-token' },
+          { text: 'Plex Token', link: '/guide/plex-token' },
+          { text: 'Configuration', link: '/guide/configuration' },
+        ]
+      },
+      {
+        text: 'Deployment',
+        items: [
+          { text: 'Local Installation', link: '/guide/local-install' },
+          { text: 'Docker', link: '/guide/docker' },
+          { text: 'Docker Compose', link: '/guide/docker-compose' },
+        ]
+      },
+      {
+        text: 'Usage',
+        items: [
+          { text: 'Commands', link: '/guide/commands' },
+          { text: 'Permissions', link: '/guide/permissions' },
+          { text: 'Troubleshooting', link: '/guide/troubleshooting' },
+        ]
+      }
+    ],
+
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/moderniselife/SchroStream' }
+    ],
+
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © 2024 SchroStream'
+    }
+  }
+})
diff --git a/docs/bun.lock b/docs/bun.lock
new file mode 100644
index 0000000..c93f7ee
--- /dev/null
+++ b/docs/bun.lock
@@ -0,0 +1,352 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "schrostream-docs",
+      "devDependencies": {
+        "vitepress": "^1.0.0",
+      },
+    },
+  },
+  "packages": {
+    "@algolia/abtesting": ["@algolia/abtesting@1.12.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-Y+7e2uPe376OH5O73OB1+vR40ZhbV2kzGh/AR/dPCWguoBOp1IK0o+uZQLX+7i32RMMBEKl3pj6KVEav100Kvg=="],
+
+    "@algolia/autocomplete-core": ["@algolia/autocomplete-core@1.17.7", "", { "dependencies": { "@algolia/autocomplete-plugin-algolia-insights": "1.17.7", "@algolia/autocomplete-shared": "1.17.7" } }, "sha512-BjiPOW6ks90UKl7TwMv7oNQMnzU+t/wk9mgIDi6b1tXpUek7MW0lbNOUHpvam9pe3lVCf4xPFT+lK7s+e+fs7Q=="],
+
+    "@algolia/autocomplete-plugin-algolia-insights": ["@algolia/autocomplete-plugin-algolia-insights@1.17.7", "", { "dependencies": { "@algolia/autocomplete-shared": "1.17.7" }, "peerDependencies": { "search-insights": ">= 1 < 3" } }, "sha512-Jca5Ude6yUOuyzjnz57og7Et3aXjbwCSDf/8onLHSQgw1qW3ALl9mrMWaXb5FmPVkV3EtkD2F/+NkT6VHyPu9A=="],
+
+    "@algolia/autocomplete-preset-algolia": ["@algolia/autocomplete-preset-algolia@1.17.7", "", { "dependencies": { "@algolia/autocomplete-shared": "1.17.7" }, "peerDependencies": { "@algolia/client-search": ">= 4.9.1 < 6", "algoliasearch": ">= 4.9.1 < 6" } }, "sha512-ggOQ950+nwbWROq2MOCIL71RE0DdQZsceqrg32UqnhDz8FlO9rL8ONHNsI2R1MH0tkgVIDKI/D0sMiUchsFdWA=="],
+
+    "@algolia/autocomplete-shared": ["@algolia/autocomplete-shared@1.17.7", "", { "peerDependencies": { "@algolia/client-search": ">= 4.9.1 < 6", "algoliasearch": ">= 4.9.1 < 6" } }, "sha512-o/1Vurr42U/qskRSuhBH+VKxMvkkUVTLU6WZQr+L5lGZZLYWyhdzWjW0iGXY7EkwRTjBqvN2EsR81yCTGV/kmg=="],
+
+    "@algolia/client-abtesting": ["@algolia/client-abtesting@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-5SWfl0UGuKxMBYlU2Y9BnlIKKEyhFU5jHE9F9jAd8nbhxZNLk0y7fXE+AZeFtyK1lkVw6O4B/e6c3XIVVCkmqw=="],
+
+    "@algolia/client-analytics": ["@algolia/client-analytics@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-496K6B1l/0Jvyp3MbW/YIgmm1a6nkTrKXBM7DoEy9YAOJ8GywGpa2UYjNCW1UrOTt+em1ECzDjRx7PIzTR9YvA=="],
+
+    "@algolia/client-common": ["@algolia/client-common@5.46.1", "", {}, "sha512-3u6AuZ1Kiss6V5JPuZfVIUYfPi8im06QBCgKqLg82GUBJ3SwhiTdSZFIEgz2mzFuitFdW1PQi3c/65zE/3FgIw=="],
+
+    "@algolia/client-insights": ["@algolia/client-insights@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-LwuWjdO35HHl1rxtdn48t920Xl26Dl0SMxjxjFeAK/OwK/pIVfYjOZl/f3Pnm7Kixze+6HjpByVxEaqhTuAFaw=="],
+
+    "@algolia/client-personalization": ["@algolia/client-personalization@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-6LvJAlfEsn9SVq63MYAFX2iUxztUK2Q7BVZtI1vN87lDiJ/tSVFKgKS/jBVO03A39ePxJQiFv6EKv7lmoGlWtQ=="],
+
+    "@algolia/client-query-suggestions": ["@algolia/client-query-suggestions@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-9GLUCyGGo7YOXHcNqbzca82XYHJTbuiI6iT0FTGc0BrnV2N4OcrznUuVKic/duiLSun5gcy/G2Bciw5Sav9f9w=="],
+
+    "@algolia/client-search": ["@algolia/client-search@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-NL76o/BoEgU4ObY5oBEC3o6KSPpuXsnSta00tAxTm1iKUWOGR34DQEKhUt8xMHhMKleUNPM/rLPFiIVtfsGU8w=="],
+
+    "@algolia/ingestion": ["@algolia/ingestion@1.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-52Nc8WKC1FFXsdlXlTMl1Re/pTAbd2DiJiNdYmgHiikZcfF96G+Opx4qKiLUG1q7zp9e+ahNwXF6ED0XChMywg=="],
+
+    "@algolia/monitoring": ["@algolia/monitoring@1.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-1x2/2Y/eqz6l3QcEZ8u/zMhSCpjlhePyizJd3sXrmg031HjayYT5+IxikjpqkdF7TU/deCTd/TFUcxLJ2ZHXiQ=="],
+
+    "@algolia/recommend": ["@algolia/recommend@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-SSd3KlQuplxV3aRs5+Z09XilFesgpPjtCG7BGRxLTVje5hn9BLmhjO4W3gKw01INUt44Z1r0Fwx5uqnhAouunA=="],
+
+    "@algolia/requester-browser-xhr": ["@algolia/requester-browser-xhr@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1" } }, "sha512-3GfCwudeW6/3caKSdmOP6RXZEL4F3GiemCaXEStkTt2Re8f7NcGYAAZnGlHsCzvhlNEuDzPYdYxh4UweY8l/2w=="],
+
+    "@algolia/requester-fetch": ["@algolia/requester-fetch@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1" } }, "sha512-JUAxYfmnLYTVtAOFxVvXJ4GDHIhMuaP7JGyZXa/nCk3P8RrN5FCNTdRyftSnxyzwSIAd8qH3CjdBS9WwxxqcHQ=="],
+
+    "@algolia/requester-node-http": ["@algolia/requester-node-http@5.46.1", "", { "dependencies": { "@algolia/client-common": "5.46.1" } }, "sha512-VwbhV1xvTGiek3d2pOS6vNBC4dtbNadyRT+i1niZpGhOJWz1XnfhxNboVbXPGAyMJYz7kDrolbDvEzIDT93uUA=="],
+
+    "@babel/helper-string-parser": ["@babel/helper-string-parser@7.27.1", "", {}, "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA=="],
+
+    "@babel/helper-validator-identifier": ["@babel/helper-validator-identifier@7.28.5", "", {}, "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q=="],
+
+    "@babel/parser": ["@babel/parser@7.28.5", "", { "dependencies": { "@babel/types": "^7.28.5" }, "bin": "./bin/babel-parser.js" }, "sha512-KKBU1VGYR7ORr3At5HAtUQ+TV3SzRCXmA/8OdDZiLDBIZxVyzXuztPjfLd3BV1PRAQGCMWWSHYhL0F8d5uHBDQ=="],
+
+    "@babel/types": ["@babel/types@7.28.5", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA=="],
+
+    "@docsearch/css": ["@docsearch/css@3.8.2", "", {}, "sha512-y05ayQFyUmCXze79+56v/4HpycYF3uFqB78pLPrSV5ZKAlDuIAAJNhaRi8tTdRNXh05yxX/TyNnzD6LwSM89vQ=="],
+
+    "@docsearch/js": ["@docsearch/js@3.8.2", "", { "dependencies": { "@docsearch/react": "3.8.2", "preact": "^10.0.0" } }, "sha512-Q5wY66qHn0SwA7Taa0aDbHiJvaFJLOJyHmooQ7y8hlwwQLQ/5WwCcoX0g7ii04Qi2DJlHsd0XXzJ8Ypw9+9YmQ=="],
+
+    "@docsearch/react": ["@docsearch/react@3.8.2", "", { "dependencies": { "@algolia/autocomplete-core": "1.17.7", "@algolia/autocomplete-preset-algolia": "1.17.7", "@docsearch/css": "3.8.2", "algoliasearch": "^5.14.2" }, "peerDependencies": { "@types/react": ">= 16.8.0 < 19.0.0", "react": ">= 16.8.0 < 19.0.0", "react-dom": ">= 16.8.0 < 19.0.0", "search-insights": ">= 1 < 3" }, "optionalPeers": ["@types/react", "react", "react-dom", "search-insights"] }, "sha512-xCRrJQlTt8N9GU0DG4ptwHRkfnSnD/YpdeaXe02iKfqs97TkZJv60yE+1eq/tjPcVnTW8dP5qLP7itifFVV5eg=="],
+
+    "@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.21.5", "", { "os": "aix", "cpu": "ppc64" }, "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ=="],
+
+    "@esbuild/android-arm": ["@esbuild/android-arm@0.21.5", "", { "os": "android", "cpu": "arm" }, "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg=="],
+
+    "@esbuild/android-arm64": ["@esbuild/android-arm64@0.21.5", "", { "os": "android", "cpu": "arm64" }, "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A=="],
+
+    "@esbuild/android-x64": ["@esbuild/android-x64@0.21.5", "", { "os": "android", "cpu": "x64" }, "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA=="],
+
+    "@esbuild/darwin-arm64": ["@esbuild/darwin-arm64@0.21.5", "", { "os": "darwin", "cpu": "arm64" }, "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ=="],
+
+    "@esbuild/darwin-x64": ["@esbuild/darwin-x64@0.21.5", "", { "os": "darwin", "cpu": "x64" }, "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw=="],
+
+    "@esbuild/freebsd-arm64": ["@esbuild/freebsd-arm64@0.21.5", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g=="],
+
+    "@esbuild/freebsd-x64": ["@esbuild/freebsd-x64@0.21.5", "", { "os": "freebsd", "cpu": "x64" }, "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ=="],
+
+    "@esbuild/linux-arm": ["@esbuild/linux-arm@0.21.5", "", { "os": "linux", "cpu": "arm" }, "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA=="],
+
+    "@esbuild/linux-arm64": ["@esbuild/linux-arm64@0.21.5", "", { "os": "linux", "cpu": "arm64" }, "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q=="],
+
+    "@esbuild/linux-ia32": ["@esbuild/linux-ia32@0.21.5", "", { "os": "linux", "cpu": "ia32" }, "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg=="],
+
+    "@esbuild/linux-loong64": ["@esbuild/linux-loong64@0.21.5", "", { "os": "linux", "cpu": "none" }, "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg=="],
+
+    "@esbuild/linux-mips64el": ["@esbuild/linux-mips64el@0.21.5", "", { "os": "linux", "cpu": "none" }, "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg=="],
+
+    "@esbuild/linux-ppc64": ["@esbuild/linux-ppc64@0.21.5", "", { "os": "linux", "cpu": "ppc64" }, "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w=="],
+
+    "@esbuild/linux-riscv64": ["@esbuild/linux-riscv64@0.21.5", "", { "os": "linux", "cpu": "none" }, "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA=="],
+
+    "@esbuild/linux-s390x": ["@esbuild/linux-s390x@0.21.5", "", { "os": "linux", "cpu": "s390x" }, "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A=="],
+
+    "@esbuild/linux-x64": ["@esbuild/linux-x64@0.21.5", "", { "os": "linux", "cpu": "x64" }, "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ=="],
+
+    "@esbuild/netbsd-x64": ["@esbuild/netbsd-x64@0.21.5", "", { "os": "none", "cpu": "x64" }, "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg=="],
+
+    "@esbuild/openbsd-x64": ["@esbuild/openbsd-x64@0.21.5", "", { "os": "openbsd", "cpu": "x64" }, "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow=="],
+
+    "@esbuild/sunos-x64": ["@esbuild/sunos-x64@0.21.5", "", { "os": "sunos", "cpu": "x64" }, "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg=="],
+
+    "@esbuild/win32-arm64": ["@esbuild/win32-arm64@0.21.5", "", { "os": "win32", "cpu": "arm64" }, "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A=="],
+
+    "@esbuild/win32-ia32": ["@esbuild/win32-ia32@0.21.5", "", { "os": "win32", "cpu": "ia32" }, "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA=="],
+
+    "@esbuild/win32-x64": ["@esbuild/win32-x64@0.21.5", "", { "os": "win32", "cpu": "x64" }, "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw=="],
+
+    "@iconify-json/simple-icons": ["@iconify-json/simple-icons@1.2.63", "", { "dependencies": { "@iconify/types": "*" } }, "sha512-xZl2UWCwE58VlqZ+pDPmaUhE2tq8MVSTJRr4/9nzzHlDdjJ0Ud1VxNXPrwTSgESKY29iCQw3S0r2nJTSNNngHw=="],
+
+    "@iconify/types": ["@iconify/types@2.0.0", "", {}, "sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg=="],
+
+    "@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.5.5", "", {}, "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og=="],
+
+    "@rollup/rollup-android-arm-eabi": ["@rollup/rollup-android-arm-eabi@4.53.5", "", { "os": "android", "cpu": "arm" }, "sha512-iDGS/h7D8t7tvZ1t6+WPK04KD0MwzLZrG0se1hzBjSi5fyxlsiggoJHwh18PCFNn7tG43OWb6pdZ6Y+rMlmyNQ=="],
+
+    "@rollup/rollup-android-arm64": ["@rollup/rollup-android-arm64@4.53.5", "", { "os": "android", "cpu": "arm64" }, "sha512-wrSAViWvZHBMMlWk6EJhvg8/rjxzyEhEdgfMMjREHEq11EtJ6IP6yfcCH57YAEca2Oe3FNCE9DSTgU70EIGmVw=="],
+
+    "@rollup/rollup-darwin-arm64": ["@rollup/rollup-darwin-arm64@4.53.5", "", { "os": "darwin", "cpu": "arm64" }, "sha512-S87zZPBmRO6u1YXQLwpveZm4JfPpAa6oHBX7/ghSiGH3rz/KDgAu1rKdGutV+WUI6tKDMbaBJomhnT30Y2t4VQ=="],
+
+    "@rollup/rollup-darwin-x64": ["@rollup/rollup-darwin-x64@4.53.5", "", { "os": "darwin", "cpu": "x64" }, "sha512-YTbnsAaHo6VrAczISxgpTva8EkfQus0VPEVJCEaboHtZRIb6h6j0BNxRBOwnDciFTZLDPW5r+ZBmhL/+YpTZgA=="],
+
+    "@rollup/rollup-freebsd-arm64": ["@rollup/rollup-freebsd-arm64@4.53.5", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-1T8eY2J8rKJWzaznV7zedfdhD1BqVs1iqILhmHDq/bqCUZsrMt+j8VCTHhP0vdfbHK3e1IQ7VYx3jlKqwlf+vw=="],
+
+    "@rollup/rollup-freebsd-x64": ["@rollup/rollup-freebsd-x64@4.53.5", "", { "os": "freebsd", "cpu": "x64" }, "sha512-sHTiuXyBJApxRn+VFMaw1U+Qsz4kcNlxQ742snICYPrY+DDL8/ZbaC4DVIB7vgZmp3jiDaKA0WpBdP0aqPJoBQ=="],
+
+    "@rollup/rollup-linux-arm-gnueabihf": ["@rollup/rollup-linux-arm-gnueabihf@4.53.5", "", { "os": "linux", "cpu": "arm" }, "sha512-dV3T9MyAf0w8zPVLVBptVlzaXxka6xg1f16VAQmjg+4KMSTWDvhimI/Y6mp8oHwNrmnmVl9XxJ/w/mO4uIQONA=="],
+
+    "@rollup/rollup-linux-arm-musleabihf": ["@rollup/rollup-linux-arm-musleabihf@4.53.5", "", { "os": "linux", "cpu": "arm" }, "sha512-wIGYC1x/hyjP+KAu9+ewDI+fi5XSNiUi9Bvg6KGAh2TsNMA3tSEs+Sh6jJ/r4BV/bx/CyWu2ue9kDnIdRyafcQ=="],
+
+    "@rollup/rollup-linux-arm64-gnu": ["@rollup/rollup-linux-arm64-gnu@4.53.5", "", { "os": "linux", "cpu": "arm64" }, "sha512-Y+qVA0D9d0y2FRNiG9oM3Hut/DgODZbU9I8pLLPwAsU0tUKZ49cyV1tzmB/qRbSzGvY8lpgGkJuMyuhH7Ma+Vg=="],
+
+    "@rollup/rollup-linux-arm64-musl": ["@rollup/rollup-linux-arm64-musl@4.53.5", "", { "os": "linux", "cpu": "arm64" }, "sha512-juaC4bEgJsyFVfqhtGLz8mbopaWD+WeSOYr5E16y+1of6KQjc0BpwZLuxkClqY1i8sco+MdyoXPNiCkQou09+g=="],
+
+    "@rollup/rollup-linux-loong64-gnu": ["@rollup/rollup-linux-loong64-gnu@4.53.5", "", { "os": "linux", "cpu": "none" }, "sha512-rIEC0hZ17A42iXtHX+EPJVL/CakHo+tT7W0pbzdAGuWOt2jxDFh7A/lRhsNHBcqL4T36+UiAgwO8pbmn3dE8wA=="],
+
+    "@rollup/rollup-linux-ppc64-gnu": ["@rollup/rollup-linux-ppc64-gnu@4.53.5", "", { "os": "linux", "cpu": "ppc64" }, "sha512-T7l409NhUE552RcAOcmJHj3xyZ2h7vMWzcwQI0hvn5tqHh3oSoclf9WgTl+0QqffWFG8MEVZZP1/OBglKZx52Q=="],
+
+    "@rollup/rollup-linux-riscv64-gnu": ["@rollup/rollup-linux-riscv64-gnu@4.53.5", "", { "os": "linux", "cpu": "none" }, "sha512-7OK5/GhxbnrMcxIFoYfhV/TkknarkYC1hqUw1wU2xUN3TVRLNT5FmBv4KkheSG2xZ6IEbRAhTooTV2+R5Tk0lQ=="],
+
+    "@rollup/rollup-linux-riscv64-musl": ["@rollup/rollup-linux-riscv64-musl@4.53.5", "", { "os": "linux", "cpu": "none" }, "sha512-GwuDBE/PsXaTa76lO5eLJTyr2k8QkPipAyOrs4V/KJufHCZBJ495VCGJol35grx9xryk4V+2zd3Ri+3v7NPh+w=="],
+
+    "@rollup/rollup-linux-s390x-gnu": ["@rollup/rollup-linux-s390x-gnu@4.53.5", "", { "os": "linux", "cpu": "s390x" }, "sha512-IAE1Ziyr1qNfnmiQLHBURAD+eh/zH1pIeJjeShleII7Vj8kyEm2PF77o+lf3WTHDpNJcu4IXJxNO0Zluro8bOw=="],
+
+    "@rollup/rollup-linux-x64-gnu": ["@rollup/rollup-linux-x64-gnu@4.53.5", "", { "os": "linux", "cpu": "x64" }, "sha512-Pg6E+oP7GvZ4XwgRJBuSXZjcqpIW3yCBhK4BcsANvb47qMvAbCjR6E+1a/U2WXz1JJxp9/4Dno3/iSJLcm5auw=="],
+
+    "@rollup/rollup-linux-x64-musl": ["@rollup/rollup-linux-x64-musl@4.53.5", "", { "os": "linux", "cpu": "x64" }, "sha512-txGtluxDKTxaMDzUduGP0wdfng24y1rygUMnmlUJ88fzCCULCLn7oE5kb2+tRB+MWq1QDZT6ObT5RrR8HFRKqg=="],
+
+    "@rollup/rollup-openharmony-arm64": ["@rollup/rollup-openharmony-arm64@4.53.5", "", { "os": "none", "cpu": "arm64" }, "sha512-3DFiLPnTxiOQV993fMc+KO8zXHTcIjgaInrqlG8zDp1TlhYl6WgrOHuJkJQ6M8zHEcntSJsUp1XFZSY8C1DYbg=="],
+
+    "@rollup/rollup-win32-arm64-msvc": ["@rollup/rollup-win32-arm64-msvc@4.53.5", "", { "os": "win32", "cpu": "arm64" }, "sha512-nggc/wPpNTgjGg75hu+Q/3i32R00Lq1B6N1DO7MCU340MRKL3WZJMjA9U4K4gzy3dkZPXm9E1Nc81FItBVGRlA=="],
+
+    "@rollup/rollup-win32-ia32-msvc": ["@rollup/rollup-win32-ia32-msvc@4.53.5", "", { "os": "win32", "cpu": "ia32" }, "sha512-U/54pTbdQpPLBdEzCT6NBCFAfSZMvmjr0twhnD9f4EIvlm9wy3jjQ38yQj1AGznrNO65EWQMgm/QUjuIVrYF9w=="],
+
+    "@rollup/rollup-win32-x64-gnu": ["@rollup/rollup-win32-x64-gnu@4.53.5", "", { "os": "win32", "cpu": "x64" }, "sha512-2NqKgZSuLH9SXBBV2dWNRCZmocgSOx8OJSdpRaEcRlIfX8YrKxUT6z0F1NpvDVhOsl190UFTRh2F2WDWWCYp3A=="],
+
+    "@rollup/rollup-win32-x64-msvc": ["@rollup/rollup-win32-x64-msvc@4.53.5", "", { "os": "win32", "cpu": "x64" }, "sha512-JRpZUhCfhZ4keB5v0fe02gQJy05GqboPOaxvjugW04RLSYYoB/9t2lx2u/tMs/Na/1NXfY8QYjgRljRpN+MjTQ=="],
+
+    "@shikijs/core": ["@shikijs/core@2.5.0", "", { "dependencies": { "@shikijs/engine-javascript": "2.5.0", "@shikijs/engine-oniguruma": "2.5.0", "@shikijs/types": "2.5.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4", "hast-util-to-html": "^9.0.4" } }, "sha512-uu/8RExTKtavlpH7XqnVYBrfBkUc20ngXiX9NSrBhOVZYv/7XQRKUyhtkeflY5QsxC0GbJThCerruZfsUaSldg=="],
+
+    "@shikijs/engine-javascript": ["@shikijs/engine-javascript@2.5.0", "", { "dependencies": { "@shikijs/types": "2.5.0", "@shikijs/vscode-textmate": "^10.0.2", "oniguruma-to-es": "^3.1.0" } }, "sha512-VjnOpnQf8WuCEZtNUdjjwGUbtAVKuZkVQ/5cHy/tojVVRIRtlWMYVjyWhxOmIq05AlSOv72z7hRNRGVBgQOl0w=="],
+
+    "@shikijs/engine-oniguruma": ["@shikijs/engine-oniguruma@2.5.0", "", { "dependencies": { "@shikijs/types": "2.5.0", "@shikijs/vscode-textmate": "^10.0.2" } }, "sha512-pGd1wRATzbo/uatrCIILlAdFVKdxImWJGQ5rFiB5VZi2ve5xj3Ax9jny8QvkaV93btQEwR/rSz5ERFpC5mKNIw=="],
+
+    "@shikijs/langs": ["@shikijs/langs@2.5.0", "", { "dependencies": { "@shikijs/types": "2.5.0" } }, "sha512-Qfrrt5OsNH5R+5tJ/3uYBBZv3SuGmnRPejV9IlIbFH3HTGLDlkqgHymAlzklVmKBjAaVmkPkyikAV/sQ1wSL+w=="],
+
+    "@shikijs/themes": ["@shikijs/themes@2.5.0", "", { "dependencies": { "@shikijs/types": "2.5.0" } }, "sha512-wGrk+R8tJnO0VMzmUExHR+QdSaPUl/NKs+a4cQQRWyoc3YFbUzuLEi/KWK1hj+8BfHRKm2jNhhJck1dfstJpiw=="],
+
+    "@shikijs/transformers": ["@shikijs/transformers@2.5.0", "", { "dependencies": { "@shikijs/core": "2.5.0", "@shikijs/types": "2.5.0" } }, "sha512-SI494W5X60CaUwgi8u4q4m4s3YAFSxln3tzNjOSYqq54wlVgz0/NbbXEb3mdLbqMBztcmS7bVTaEd2w0qMmfeg=="],
+
+    "@shikijs/types": ["@shikijs/types@2.5.0", "", { "dependencies": { "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-ygl5yhxki9ZLNuNpPitBWvcy9fsSKKaRuO4BAlMyagszQidxcpLAr0qiW/q43DtSIDxO6hEbtYLiFZNXO/hdGw=="],
+
+    "@shikijs/vscode-textmate": ["@shikijs/vscode-textmate@10.0.2", "", {}, "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg=="],
+
+    "@types/estree": ["@types/estree@1.0.8", "", {}, "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w=="],
+
+    "@types/hast": ["@types/hast@3.0.4", "", { "dependencies": { "@types/unist": "*" } }, "sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ=="],
+
+    "@types/linkify-it": ["@types/linkify-it@5.0.0", "", {}, "sha512-sVDA58zAw4eWAffKOaQH5/5j3XeayukzDk+ewSsnv3p4yJEZHCCzMDiZM8e0OUrRvmpGZ85jf4yDHkHsgBNr9Q=="],
+
+    "@types/markdown-it": ["@types/markdown-it@14.1.2", "", { "dependencies": { "@types/linkify-it": "^5", "@types/mdurl": "^2" } }, "sha512-promo4eFwuiW+TfGxhi+0x3czqTYJkG8qB17ZUJiVF10Xm7NLVRSLUsfRTU/6h1e24VvRnXCx+hG7li58lkzog=="],
+
+    "@types/mdast": ["@types/mdast@4.0.4", "", { "dependencies": { "@types/unist": "*" } }, "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA=="],
+
+    "@types/mdurl": ["@types/mdurl@2.0.0", "", {}, "sha512-RGdgjQUZba5p6QEFAVx2OGb8rQDL/cPRG7GiedRzMcJ1tYnUANBncjbSB1NRGwbvjcPeikRABz2nshyPk1bhWg=="],
+
+    "@types/unist": ["@types/unist@3.0.3", "", {}, "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q=="],
+
+    "@types/web-bluetooth": ["@types/web-bluetooth@0.0.21", "", {}, "sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA=="],
+
+    "@ungap/structured-clone": ["@ungap/structured-clone@1.3.0", "", {}, "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g=="],
+
+    "@vitejs/plugin-vue": ["@vitejs/plugin-vue@5.2.4", "", { "peerDependencies": { "vite": "^5.0.0 || ^6.0.0", "vue": "^3.2.25" } }, "sha512-7Yx/SXSOcQq5HiiV3orevHUFn+pmMB4cgbEkDYgnkUWb0WfeQ/wa2yFv6D5ICiCQOVpjA7vYDXrC7AGO8yjDHA=="],
+
+    "@vue/compiler-core": ["@vue/compiler-core@3.5.26", "", { "dependencies": { "@babel/parser": "^7.28.5", "@vue/shared": "3.5.26", "entities": "^7.0.0", "estree-walker": "^2.0.2", "source-map-js": "^1.2.1" } }, "sha512-vXyI5GMfuoBCnv5ucIT7jhHKl55Y477yxP6fc4eUswjP8FG3FFVFd41eNDArR+Uk3QKn2Z85NavjaxLxOC19/w=="],
+
+    "@vue/compiler-dom": ["@vue/compiler-dom@3.5.26", "", { "dependencies": { "@vue/compiler-core": "3.5.26", "@vue/shared": "3.5.26" } }, "sha512-y1Tcd3eXs834QjswshSilCBnKGeQjQXB6PqFn/1nxcQw4pmG42G8lwz+FZPAZAby6gZeHSt/8LMPfZ4Rb+Bd/A=="],
+
+    "@vue/compiler-sfc": ["@vue/compiler-sfc@3.5.26", "", { "dependencies": { "@babel/parser": "^7.28.5", "@vue/compiler-core": "3.5.26", "@vue/compiler-dom": "3.5.26", "@vue/compiler-ssr": "3.5.26", "@vue/shared": "3.5.26", "estree-walker": "^2.0.2", "magic-string": "^0.30.21", "postcss": "^8.5.6", "source-map-js": "^1.2.1" } }, "sha512-egp69qDTSEZcf4bGOSsprUr4xI73wfrY5oRs6GSgXFTiHrWj4Y3X5Ydtip9QMqiCMCPVwLglB9GBxXtTadJ3mA=="],
+
+    "@vue/compiler-ssr": ["@vue/compiler-ssr@3.5.26", "", { "dependencies": { "@vue/compiler-dom": "3.5.26", "@vue/shared": "3.5.26" } }, "sha512-lZT9/Y0nSIRUPVvapFJEVDbEXruZh2IYHMk2zTtEgJSlP5gVOqeWXH54xDKAaFS4rTnDeDBQUYDtxKyoW9FwDw=="],
+
+    "@vue/devtools-api": ["@vue/devtools-api@7.7.9", "", { "dependencies": { "@vue/devtools-kit": "^7.7.9" } }, "sha512-kIE8wvwlcZ6TJTbNeU2HQNtaxLx3a84aotTITUuL/4bzfPxzajGBOoqjMhwZJ8L9qFYDU/lAYMEEm11dnZOD6g=="],
+
+    "@vue/devtools-kit": ["@vue/devtools-kit@7.7.9", "", { "dependencies": { "@vue/devtools-shared": "^7.7.9", "birpc": "^2.3.0", "hookable": "^5.5.3", "mitt": "^3.0.1", "perfect-debounce": "^1.0.0", "speakingurl": "^14.0.1", "superjson": "^2.2.2" } }, "sha512-PyQ6odHSgiDVd4hnTP+aDk2X4gl2HmLDfiyEnn3/oV+ckFDuswRs4IbBT7vacMuGdwY/XemxBoh302ctbsptuA=="],
+
+    "@vue/devtools-shared": ["@vue/devtools-shared@7.7.9", "", { "dependencies": { "rfdc": "^1.4.1" } }, "sha512-iWAb0v2WYf0QWmxCGy0seZNDPdO3Sp5+u78ORnyeonS6MT4PC7VPrryX2BpMJrwlDeaZ6BD4vP4XKjK0SZqaeA=="],
+
+    "@vue/reactivity": ["@vue/reactivity@3.5.26", "", { "dependencies": { "@vue/shared": "3.5.26" } }, "sha512-9EnYB1/DIiUYYnzlnUBgwU32NNvLp/nhxLXeWRhHUEeWNTn1ECxX8aGO7RTXeX6PPcxe3LLuNBFoJbV4QZ+CFQ=="],
+
+    "@vue/runtime-core": ["@vue/runtime-core@3.5.26", "", { "dependencies": { "@vue/reactivity": "3.5.26", "@vue/shared": "3.5.26" } }, "sha512-xJWM9KH1kd201w5DvMDOwDHYhrdPTrAatn56oB/LRG4plEQeZRQLw0Bpwih9KYoqmzaxF0OKSn6swzYi84e1/Q=="],
+
+    "@vue/runtime-dom": ["@vue/runtime-dom@3.5.26", "", { "dependencies": { "@vue/reactivity": "3.5.26", "@vue/runtime-core": "3.5.26", "@vue/shared": "3.5.26", "csstype": "^3.2.3" } }, "sha512-XLLd/+4sPC2ZkN/6+V4O4gjJu6kSDbHAChvsyWgm1oGbdSO3efvGYnm25yCjtFm/K7rrSDvSfPDgN1pHgS4VNQ=="],
+
+    "@vue/server-renderer": ["@vue/server-renderer@3.5.26", "", { "dependencies": { "@vue/compiler-ssr": "3.5.26", "@vue/shared": "3.5.26" }, "peerDependencies": { "vue": "3.5.26" } }, "sha512-TYKLXmrwWKSodyVuO1WAubucd+1XlLg4set0YoV+Hu8Lo79mp/YMwWV5mC5FgtsDxX3qo1ONrxFaTP1OQgy1uA=="],
+
+    "@vue/shared": ["@vue/shared@3.5.26", "", {}, "sha512-7Z6/y3uFI5PRoKeorTOSXKcDj0MSasfNNltcslbFrPpcw6aXRUALq4IfJlaTRspiWIUOEZbrpM+iQGmCOiWe4A=="],
+
+    "@vueuse/core": ["@vueuse/core@12.8.2", "", { "dependencies": { "@types/web-bluetooth": "^0.0.21", "@vueuse/metadata": "12.8.2", "@vueuse/shared": "12.8.2", "vue": "^3.5.13" } }, "sha512-HbvCmZdzAu3VGi/pWYm5Ut+Kd9mn1ZHnn4L5G8kOQTPs/IwIAmJoBrmYk2ckLArgMXZj0AW3n5CAejLUO+PhdQ=="],
+
+    "@vueuse/integrations": ["@vueuse/integrations@12.8.2", "", { "dependencies": { "@vueuse/core": "12.8.2", "@vueuse/shared": "12.8.2", "vue": "^3.5.13" }, "peerDependencies": { "async-validator": "^4", "axios": "^1", "change-case": "^5", "drauu": "^0.4", "focus-trap": "^7", "fuse.js": "^7", "idb-keyval": "^6", "jwt-decode": "^4", "nprogress": "^0.2", "qrcode": "^1.5", "sortablejs": "^1", "universal-cookie": "^7" }, "optionalPeers": ["async-validator", "axios", "change-case", "drauu", "focus-trap", "fuse.js", "idb-keyval", "jwt-decode", "nprogress", "qrcode", "sortablejs", "universal-cookie"] }, "sha512-fbGYivgK5uBTRt7p5F3zy6VrETlV9RtZjBqd1/HxGdjdckBgBM4ugP8LHpjolqTj14TXTxSK1ZfgPbHYyGuH7g=="],
+
+    "@vueuse/metadata": ["@vueuse/metadata@12.8.2", "", {}, "sha512-rAyLGEuoBJ/Il5AmFHiziCPdQzRt88VxR+Y/A/QhJ1EWtWqPBBAxTAFaSkviwEuOEZNtW8pvkPgoCZQ+HxqW1A=="],
+
+    "@vueuse/shared": ["@vueuse/shared@12.8.2", "", { "dependencies": { "vue": "^3.5.13" } }, "sha512-dznP38YzxZoNloI0qpEfpkms8knDtaoQ6Y/sfS0L7Yki4zh40LFHEhur0odJC6xTHG5dxWVPiUWBXn+wCG2s5w=="],
+
+    "algoliasearch": ["algoliasearch@5.46.1", "", { "dependencies": { "@algolia/abtesting": "1.12.1", "@algolia/client-abtesting": "5.46.1", "@algolia/client-analytics": "5.46.1", "@algolia/client-common": "5.46.1", "@algolia/client-insights": "5.46.1", "@algolia/client-personalization": "5.46.1", "@algolia/client-query-suggestions": "5.46.1", "@algolia/client-search": "5.46.1", "@algolia/ingestion": "1.46.1", "@algolia/monitoring": "1.46.1", "@algolia/recommend": "5.46.1", "@algolia/requester-browser-xhr": "5.46.1", "@algolia/requester-fetch": "5.46.1", "@algolia/requester-node-http": "5.46.1" } }, "sha512-39ol8Ulqb3MntofkXHlrcXKyU8BU0PXvQrXPBIX6eXj/EO4VT7651mhGVORI2oF8ydya9nFzT3fYDoqme/KL6w=="],
+
+    "birpc": ["birpc@2.9.0", "", {}, "sha512-KrayHS5pBi69Xi9JmvoqrIgYGDkD6mcSe/i6YKi3w5kekCLzrX4+nawcXqrj2tIp50Kw/mT/s3p+GVK0A0sKxw=="],
+
+    "ccount": ["ccount@2.0.1", "", {}, "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg=="],
+
+    "character-entities-html4": ["character-entities-html4@2.1.0", "", {}, "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA=="],
+
+    "character-entities-legacy": ["character-entities-legacy@3.0.0", "", {}, "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ=="],
+
+    "comma-separated-tokens": ["comma-separated-tokens@2.0.3", "", {}, "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg=="],
+
+    "copy-anything": ["copy-anything@4.0.5", "", { "dependencies": { "is-what": "^5.2.0" } }, "sha512-7Vv6asjS4gMOuILabD3l739tsaxFQmC+a7pLZm02zyvs8p977bL3zEgq3yDk5rn9B0PbYgIv++jmHcuUab4RhA=="],
+
+    "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="],
+
+    "dequal": ["dequal@2.0.3", "", {}, "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA=="],
+
+    "devlop": ["devlop@1.1.0", "", { "dependencies": { "dequal": "^2.0.0" } }, "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA=="],
+
+    "emoji-regex-xs": ["emoji-regex-xs@1.0.0", "", {}, "sha512-LRlerrMYoIDrT6jgpeZ2YYl/L8EulRTt5hQcYjy5AInh7HWXKimpqx68aknBFpGL2+/IcogTcaydJEgaTmOpDg=="],
+
+    "entities": ["entities@7.0.0", "", {}, "sha512-FDWG5cmEYf2Z00IkYRhbFrwIwvdFKH07uV8dvNy0omp/Qb1xcyCWp2UDtcwJF4QZZvk0sLudP6/hAu42TaqVhQ=="],
+
+    "esbuild": ["esbuild@0.21.5", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.21.5", "@esbuild/android-arm": "0.21.5", "@esbuild/android-arm64": "0.21.5", "@esbuild/android-x64": "0.21.5", "@esbuild/darwin-arm64": "0.21.5", "@esbuild/darwin-x64": "0.21.5", "@esbuild/freebsd-arm64": "0.21.5", "@esbuild/freebsd-x64": "0.21.5", "@esbuild/linux-arm": "0.21.5", "@esbuild/linux-arm64": "0.21.5", "@esbuild/linux-ia32": "0.21.5", "@esbuild/linux-loong64": "0.21.5", "@esbuild/linux-mips64el": "0.21.5", "@esbuild/linux-ppc64": "0.21.5", "@esbuild/linux-riscv64": "0.21.5", "@esbuild/linux-s390x": "0.21.5", "@esbuild/linux-x64": "0.21.5", "@esbuild/netbsd-x64": "0.21.5", "@esbuild/openbsd-x64": "0.21.5", "@esbuild/sunos-x64": "0.21.5", "@esbuild/win32-arm64": "0.21.5", "@esbuild/win32-ia32": "0.21.5", "@esbuild/win32-x64": "0.21.5" }, "bin": { "esbuild": "bin/esbuild" } }, "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw=="],
+
+    "estree-walker": ["estree-walker@2.0.2", "", {}, "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w=="],
+
+    "focus-trap": ["focus-trap@7.6.6", "", { "dependencies": { "tabbable": "^6.3.0" } }, "sha512-v/Z8bvMCajtx4mEXmOo7QEsIzlIOqRXTIwgUfsFOF9gEsespdbD0AkPIka1bSXZ8Y8oZ+2IVDQZePkTfEHZl7Q=="],
+
+    "fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="],
+
+    "hast-util-to-html": ["hast-util-to-html@9.0.5", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/unist": "^3.0.0", "ccount": "^2.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-whitespace": "^3.0.0", "html-void-elements": "^3.0.0", "mdast-util-to-hast": "^13.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0", "stringify-entities": "^4.0.0", "zwitch": "^2.0.4" } }, "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw=="],
+
+    "hast-util-whitespace": ["hast-util-whitespace@3.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw=="],
+
+    "hookable": ["hookable@5.5.3", "", {}, "sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ=="],
+
+    "html-void-elements": ["html-void-elements@3.0.0", "", {}, "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg=="],
+
+    "is-what": ["is-what@5.5.0", "", {}, "sha512-oG7cgbmg5kLYae2N5IVd3jm2s+vldjxJzK1pcu9LfpGuQ93MQSzo0okvRna+7y5ifrD+20FE8FvjusyGaz14fw=="],
+
+    "magic-string": ["magic-string@0.30.21", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ=="],
+
+    "mark.js": ["mark.js@8.11.1", "", {}, "sha512-1I+1qpDt4idfgLQG+BNWmrqku+7/2bi5nLf4YwF8y8zXvmfiTBY3PV3ZibfrjBueCByROpuBjLLFCajqkgYoLQ=="],
+
+    "mdast-util-to-hast": ["mdast-util-to-hast@13.2.1", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/mdast": "^4.0.0", "@ungap/structured-clone": "^1.0.0", "devlop": "^1.0.0", "micromark-util-sanitize-uri": "^2.0.0", "trim-lines": "^3.0.0", "unist-util-position": "^5.0.0", "unist-util-visit": "^5.0.0", "vfile": "^6.0.0" } }, "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA=="],
+
+    "micromark-util-character": ["micromark-util-character@2.1.1", "", { "dependencies": { "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q=="],
+
+    "micromark-util-encode": ["micromark-util-encode@2.0.1", "", {}, "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw=="],
+
+    "micromark-util-sanitize-uri": ["micromark-util-sanitize-uri@2.0.1", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-encode": "^2.0.0", "micromark-util-symbol": "^2.0.0" } }, "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ=="],
+
+    "micromark-util-symbol": ["micromark-util-symbol@2.0.1", "", {}, "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q=="],
+
+    "micromark-util-types": ["micromark-util-types@2.0.2", "", {}, "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA=="],
+
+    "minisearch": ["minisearch@7.2.0", "", {}, "sha512-dqT2XBYUOZOiC5t2HRnwADjhNS2cecp9u+TJRiJ1Qp/f5qjkeT5APcGPjHw+bz89Ms8Jp+cG4AlE+QZ/QnDglg=="],
+
+    "mitt": ["mitt@3.0.1", "", {}, "sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw=="],
+
+    "nanoid": ["nanoid@3.3.11", "", { "bin": { "nanoid": "bin/nanoid.cjs" } }, "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w=="],
+
+    "oniguruma-to-es": ["oniguruma-to-es@3.1.1", "", { "dependencies": { "emoji-regex-xs": "^1.0.0", "regex": "^6.0.1", "regex-recursion": "^6.0.2" } }, "sha512-bUH8SDvPkH3ho3dvwJwfonjlQ4R80vjyvrU8YpxuROddv55vAEJrTuCuCVUhhsHbtlD9tGGbaNApGQckXhS8iQ=="],
+
+    "perfect-debounce": ["perfect-debounce@1.0.0", "", {}, "sha512-xCy9V055GLEqoFaHoC1SoLIaLmWctgCUaBaWxDZ7/Zx4CTyX7cJQLJOok/orfjZAh9kEYpjJa4d0KcJmCbctZA=="],
+
+    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
+
+    "postcss": ["postcss@8.5.6", "", { "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg=="],
+
+    "preact": ["preact@10.28.0", "", {}, "sha512-rytDAoiXr3+t6OIP3WGlDd0ouCUG1iCWzkcY3++Nreuoi17y6T5i/zRhe6uYfoVcxq6YU+sBtJouuRDsq8vvqA=="],
+
+    "property-information": ["property-information@7.1.0", "", {}, "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ=="],
+
+    "regex": ["regex@6.1.0", "", { "dependencies": { "regex-utilities": "^2.3.0" } }, "sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg=="],
+
+    "regex-recursion": ["regex-recursion@6.0.2", "", { "dependencies": { "regex-utilities": "^2.3.0" } }, "sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg=="],
+
+    "regex-utilities": ["regex-utilities@2.3.0", "", {}, "sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng=="],
+
+    "rfdc": ["rfdc@1.4.1", "", {}, "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA=="],
+
+    "rollup": ["rollup@4.53.5", "", { "dependencies": { "@types/estree": "1.0.8" }, "optionalDependencies": { "@rollup/rollup-android-arm-eabi": "4.53.5", "@rollup/rollup-android-arm64": "4.53.5", "@rollup/rollup-darwin-arm64": "4.53.5", "@rollup/rollup-darwin-x64": "4.53.5", "@rollup/rollup-freebsd-arm64": "4.53.5", "@rollup/rollup-freebsd-x64": "4.53.5", "@rollup/rollup-linux-arm-gnueabihf": "4.53.5", "@rollup/rollup-linux-arm-musleabihf": "4.53.5", "@rollup/rollup-linux-arm64-gnu": "4.53.5", "@rollup/rollup-linux-arm64-musl": "4.53.5", "@rollup/rollup-linux-loong64-gnu": "4.53.5", "@rollup/rollup-linux-ppc64-gnu": "4.53.5", "@rollup/rollup-linux-riscv64-gnu": "4.53.5", "@rollup/rollup-linux-riscv64-musl": "4.53.5", "@rollup/rollup-linux-s390x-gnu": "4.53.5", "@rollup/rollup-linux-x64-gnu": "4.53.5", "@rollup/rollup-linux-x64-musl": "4.53.5", "@rollup/rollup-openharmony-arm64": "4.53.5", "@rollup/rollup-win32-arm64-msvc": "4.53.5", "@rollup/rollup-win32-ia32-msvc": "4.53.5", "@rollup/rollup-win32-x64-gnu": "4.53.5", "@rollup/rollup-win32-x64-msvc": "4.53.5", "fsevents": "~2.3.2" }, "bin": { "rollup": "dist/bin/rollup" } }, "sha512-iTNAbFSlRpcHeeWu73ywU/8KuU/LZmNCSxp6fjQkJBD3ivUb8tpDrXhIxEzA05HlYMEwmtaUnb3RP+YNv162OQ=="],
+
+    "search-insights": ["search-insights@2.17.3", "", {}, "sha512-RQPdCYTa8A68uM2jwxoY842xDhvx3E5LFL1LxvxCNMev4o5mLuokczhzjAgGwUZBAmOKZknArSxLKmXtIi2AxQ=="],
+
+    "shiki": ["shiki@2.5.0", "", { "dependencies": { "@shikijs/core": "2.5.0", "@shikijs/engine-javascript": "2.5.0", "@shikijs/engine-oniguruma": "2.5.0", "@shikijs/langs": "2.5.0", "@shikijs/themes": "2.5.0", "@shikijs/types": "2.5.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-mI//trrsaiCIPsja5CNfsyNOqgAZUb6VpJA+340toL42UpzQlXpwRV9nch69X6gaUxrr9kaOOa6e3y3uAkGFxQ=="],
+
+    "source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
+
+    "space-separated-tokens": ["space-separated-tokens@2.0.2", "", {}, "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q=="],
+
+    "speakingurl": ["speakingurl@14.0.1", "", {}, "sha512-1POYv7uv2gXoyGFpBCmpDVSNV74IfsWlDW216UPjbWufNf+bSU6GdbDsxdcxtfwb4xlI3yxzOTKClUosxARYrQ=="],
+
+    "stringify-entities": ["stringify-entities@4.0.4", "", { "dependencies": { "character-entities-html4": "^2.0.0", "character-entities-legacy": "^3.0.0" } }, "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg=="],
+
+    "superjson": ["superjson@2.2.6", "", { "dependencies": { "copy-anything": "^4" } }, "sha512-H+ue8Zo4vJmV2nRjpx86P35lzwDT3nItnIsocgumgr0hHMQ+ZGq5vrERg9kJBo5AWGmxZDhzDo+WVIJqkB0cGA=="],
+
+    "tabbable": ["tabbable@6.3.0", "", {}, "sha512-EIHvdY5bPLuWForiR/AN2Bxngzpuwn1is4asboytXtpTgsArc+WmSJKVLlhdh71u7jFcryDqB2A8lQvj78MkyQ=="],
+
+    "trim-lines": ["trim-lines@3.0.1", "", {}, "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg=="],
+
+    "unist-util-is": ["unist-util-is@6.0.1", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g=="],
+
+    "unist-util-position": ["unist-util-position@5.0.0", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA=="],
+
+    "unist-util-stringify-position": ["unist-util-stringify-position@4.0.0", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ=="],
+
+    "unist-util-visit": ["unist-util-visit@5.0.0", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0", "unist-util-visit-parents": "^6.0.0" } }, "sha512-MR04uvD+07cwl/yhVuVWAtw+3GOR/knlL55Nd/wAdblk27GCVt3lqpTivy/tkJcZoNPzTwS1Y+KMojlLDhoTzg=="],
+
+    "unist-util-visit-parents": ["unist-util-visit-parents@6.0.2", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0" } }, "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ=="],
+
+    "vfile": ["vfile@6.0.3", "", { "dependencies": { "@types/unist": "^3.0.0", "vfile-message": "^4.0.0" } }, "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q=="],
+
+    "vfile-message": ["vfile-message@4.0.3", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-stringify-position": "^4.0.0" } }, "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw=="],
+
+    "vite": ["vite@5.4.21", "", { "dependencies": { "esbuild": "^0.21.3", "postcss": "^8.4.43", "rollup": "^4.20.0" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^18.0.0 || >=20.0.0", "less": "*", "lightningcss": "^1.21.0", "sass": "*", "sass-embedded": "*", "stylus": "*", "sugarss": "*", "terser": "^5.4.0" }, "optionalPeers": ["@types/node", "less", "lightningcss", "sass", "sass-embedded", "stylus", "sugarss", "terser"], "bin": { "vite": "bin/vite.js" } }, "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw=="],
+
+    "vitepress": ["vitepress@1.6.4", "", { "dependencies": { "@docsearch/css": "3.8.2", "@docsearch/js": "3.8.2", "@iconify-json/simple-icons": "^1.2.21", "@shikijs/core": "^2.1.0", "@shikijs/transformers": "^2.1.0", "@shikijs/types": "^2.1.0", "@types/markdown-it": "^14.1.2", "@vitejs/plugin-vue": "^5.2.1", "@vue/devtools-api": "^7.7.0", "@vue/shared": "^3.5.13", "@vueuse/core": "^12.4.0", "@vueuse/integrations": "^12.4.0", "focus-trap": "^7.6.4", "mark.js": "8.11.1", "minisearch": "^7.1.1", "shiki": "^2.1.0", "vite": "^5.4.14", "vue": "^3.5.13" }, "peerDependencies": { "markdown-it-mathjax3": "^4", "postcss": "^8" }, "optionalPeers": ["markdown-it-mathjax3", "postcss"], "bin": { "vitepress": "bin/vitepress.js" } }, "sha512-+2ym1/+0VVrbhNyRoFFesVvBvHAVMZMK0rw60E3X/5349M1GuVdKeazuksqopEdvkKwKGs21Q729jX81/bkBJg=="],
+
+    "vue": ["vue@3.5.26", "", { "dependencies": { "@vue/compiler-dom": "3.5.26", "@vue/compiler-sfc": "3.5.26", "@vue/runtime-dom": "3.5.26", "@vue/server-renderer": "3.5.26", "@vue/shared": "3.5.26" }, "peerDependencies": { "typescript": "*" }, "optionalPeers": ["typescript"] }, "sha512-SJ/NTccVyAoNUJmkM9KUqPcYlY+u8OVL1X5EW9RIs3ch5H2uERxyyIUI4MRxVCSOiEcupX9xNGde1tL9ZKpimA=="],
+
+    "zwitch": ["zwitch@2.0.4", "", {}, "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A=="],
+  }
+}
diff --git a/docs/guide/commands.md b/docs/guide/commands.md
new file mode 100644
index 0000000..3d4caaf
--- /dev/null
+++ b/docs/guide/commands.md
@@ -0,0 +1,170 @@
+# Commands
+
+All commands use the configured prefix (default: `!`).
+
+## Search & Playback
+
+### `!search <query>`
+Search for movies and TV shows in your Plex library.
+
+**Aliases:** `!s`
+
+```
+!search breaking bad
+!search the matrix
+```
+
+**Output:**
+```
+🎬 Search Results for "breaking bad":
+
+🎬 Movies (1)
+1. El Camino: A Breaking Bad Movie (2019)
+
+📺 TV Shows (1)
+2. Breaking Bad (2008)
+
+Use !play <number> to start streaming
+```
+
+---
+
+### `!episodes <number>`
+List all seasons and episodes for a TV show from search results.
+
+**Aliases:** `!eps`, `!seasons`
+
+```
+!episodes 2
+```
+
+**Output:**
+```
+📺 Breaking Bad (2008)
+
+Season 1 (7 episodes)
+  E01 - Pilot
+  E02 - Cat's in the Bag...
+  ...
+
+Use !play 2 S01E01 to play a specific episode
+```
+
+---
+
+### `!play <number> [episode]`
+Start playing a search result. For TV shows, you can specify an episode.
+
+**Aliases:** `!p`
+
+```
+!play 1              # Play movie or S01E01 of show
+!play 2 S02E05       # Play Season 2 Episode 5
+!play 2 3 8          # Play Season 3 Episode 8
+```
+
+**Special options:**
+```
+!play resume         # Continue from saved position
+!play start          # Start from beginning (ignore saved position)
+```
+
+---
+
+### `!stop`
+Stop the current stream and leave the voice channel.
+
+```
+!stop
+```
+
+## Playback Controls
+
+### `!pause` / `!resume`
+Pause or resume playback. Position is saved automatically.
+
+```
+!pause
+!resume
+```
+
+---
+
+### `!seek <time>`
+Jump to a specific time in the media.
+
+**Formats:**
+```
+!seek 1:30:00        # 1 hour, 30 minutes
+!seek 45:00          # 45 minutes
+!seek 90             # 90 seconds
+```
+
+---
+
+### `!skip`
+Skip to the next episode (TV shows only).
+
+**Aliases:** `!next`
+
+```
+!skip
+```
+
+---
+
+### `!volume <0-200>`
+Set the playback volume. Default is 100%.
+
+**Aliases:** `!vol`, `!v`
+
+```
+!volume 50           # 50% volume
+!volume 150          # 150% volume (amplified)
+!v 100               # Reset to normal
+```
+
+---
+
+### `!np`
+Show information about what's currently playing.
+
+**Aliases:** `!nowplaying`, `!playing`
+
+```
+!np
+```
+
+**Output:**
+```
+📺 Now Playing: Breaking Bad S01E01 - Pilot
+⏱️ 23:45 / 58:00 (40%)
+🔊 Volume: 100%
+```
+
+## Utility Commands
+
+### `!help`
+Show all available commands.
+
+**Aliases:** `!h`, `!commands`
+
+```
+!help
+```
+
+## Command Summary
+
+| Command | Description |
+|---------|-------------|
+| `!search <query>` | Search Plex library |
+| `!episodes <n>` | List episodes for a show |
+| `!play <n> [ep]` | Start streaming |
+| `!stop` | Stop streaming |
+| `!pause` | Pause playback |
+| `!resume` | Resume playback |
+| `!seek <time>` | Jump to time |
+| `!skip` | Next episode |
+| `!volume <n>` | Set volume (0-200%) |
+| `!np` | Now playing info |
+| `!help` | Show help |
diff --git a/docs/guide/configuration.md b/docs/guide/configuration.md
new file mode 100644
index 0000000..e680260
--- /dev/null
+++ b/docs/guide/configuration.md
@@ -0,0 +1,95 @@
+# Configuration
+
+SchroStream is configured through environment variables. Create a `.env` file in the project root.
+
+## Required Settings
+
+```env
+# Discord user token (see Discord Token guide)
+DISCORD_TOKEN=your_discord_token_here
+
+# Plex server URL and token (see Plex Token guide)
+PLEX_URL=http://192.168.1.100:32400
+PLEX_TOKEN=your_plex_token_here
+```
+
+## Optional Settings
+
+### Discord Settings
+
+```env
+# Command prefix (default: !)
+COMMAND_PREFIX=!
+
+# Allowed users - comma-separated Discord user IDs
+# Leave empty to allow only the bot account
+ALLOWED_USERS=123456789012345678,987654321098765432
+
+# Allowed roles - comma-separated Discord role IDs
+# Users with these roles can control the bot
+ALLOWED_ROLES=123456789012345678,987654321098765432
+
+# Allowed guilds - comma-separated Discord server IDs
+# Bot only responds in these servers (leave empty for all)
+ALLOWED_GUILDS=123456789012345678
+```
+
+### Stream Settings
+
+```env
+# Default video quality (height in pixels)
+# Options: 480, 720, 1080 (default: 1080)
+DEFAULT_QUALITY=1080
+
+# Maximum video bitrate in kbps (default: 8000)
+MAX_BITRATE=8000
+
+# Audio bitrate in kbps (default: 192)
+AUDIO_BITRATE=192
+```
+
+### Plex Settings
+
+```env
+# Plex client identifier (default: SchroStream)
+PLEX_CLIENT_IDENTIFIER=SchroStream
+```
+
+## Example Configuration
+
+Here's a complete `.env` example:
+
+```env
+# Discord
+DISCORD_TOKEN=MTIzNDU2Nzg5.ABcDeF.xyz123
+COMMAND_PREFIX=!
+ALLOWED_USERS=
+ALLOWED_ROLES=123456789012345678
+ALLOWED_GUILDS=987654321098765432
+
+# Plex
+PLEX_URL=http://192.168.1.100:32400
+PLEX_TOKEN=abc123xyz789
+PLEX_CLIENT_IDENTIFIER=SchroStream
+
+# Stream Quality
+DEFAULT_QUALITY=1080
+MAX_BITRATE=8000
+AUDIO_BITRATE=192
+```
+
+## Environment Variables Reference
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `DISCORD_TOKEN` | Yes | - | Your Discord user token |
+| `PLEX_URL` | Yes | - | Plex server URL |
+| `PLEX_TOKEN` | Yes | - | Plex authentication token |
+| `COMMAND_PREFIX` | No | `!` | Bot command prefix |
+| `ALLOWED_USERS` | No | Bot owner | Comma-separated user IDs |
+| `ALLOWED_ROLES` | No | - | Comma-separated role IDs |
+| `ALLOWED_GUILDS` | No | All | Comma-separated guild IDs |
+| `DEFAULT_QUALITY` | No | `1080` | Video height in pixels |
+| `MAX_BITRATE` | No | `8000` | Max video bitrate (kbps) |
+| `AUDIO_BITRATE` | No | `192` | Audio bitrate (kbps) |
+| `PLEX_CLIENT_IDENTIFIER` | No | `SchroStream` | Plex client ID |
diff --git a/docs/guide/discord-token.md b/docs/guide/discord-token.md
new file mode 100644
index 0000000..9db5fff
--- /dev/null
+++ b/docs/guide/discord-token.md
@@ -0,0 +1,60 @@
+# Getting Your Discord Token
+
+SchroStream requires your Discord user token to operate as a self-bot.
+
+::: danger Security Warning
+**Never share your Discord token with anyone!** Your token gives full access to your Discord account. Treat it like a password.
+:::
+
+## Method 1: Browser Developer Tools
+
+1. Open [Discord Web](https://discord.com/app) in your browser
+2. Log in to your account
+3. Press `F12` or `Ctrl+Shift+I` to open Developer Tools
+4. Go to the **Network** tab
+5. Type `api` in the filter box
+6. Click on any request to `discord.com/api`
+7. Look in the **Headers** section for `Authorization`
+8. Copy the token value (without quotes)
+
+## Method 2: Console Command
+
+1. Open [Discord Web](https://discord.com/app) in your browser
+2. Press `F12` to open Developer Tools
+3. Go to the **Console** tab
+4. Paste this code and press Enter:
+
+```javascript
+(webpackChunkdiscord_app.push([[''],{},e=>{m=[];for(let c in e.c)m.push(e.c[c])}]),m).find(m=>m?.exports?.default?.getToken!==void 0).exports.default.getToken()
+```
+
+5. Copy the token that appears
+
+## Method 3: Desktop App (Windows)
+
+1. Open Discord desktop app
+2. Press `Ctrl+Shift+I` to open Developer Tools
+3. Follow Method 1 or 2 above
+
+## Storing Your Token
+
+Add your token to the `.env` file:
+
+```env
+DISCORD_TOKEN=your_token_here
+```
+
+::: tip Token Format
+Discord tokens have three parts separated by dots:
+```
+[user_id_base64].[timestamp].[hmac]
+```
+Example format: `XXXXXXXXXXXXXXXXXX.XXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXXX`
+:::
+
+## Token Security Best Practices
+
+- Never commit your `.env` file to version control
+- Don't share screenshots that might show your token
+- If your token is compromised, change your Discord password immediately
+- Consider using a dedicated alt account for the bot
diff --git a/docs/guide/docker-compose.md b/docs/guide/docker-compose.md
new file mode 100644
index 0000000..174fd1d
--- /dev/null
+++ b/docs/guide/docker-compose.md
@@ -0,0 +1,171 @@
+# Docker Compose
+
+The easiest way to deploy SchroStream with all dependencies.
+
+## Basic Setup
+
+Create a `docker-compose.yml`:
+
+```yaml
+version: '3.8'
+
+services:
+  schrostream:
+    image: ghcr.io/moderniselife/schrostream:latest
+    container_name: schrostream
+    restart: unless-stopped
+    environment:
+      - DISCORD_TOKEN=${DISCORD_TOKEN}
+      - PLEX_URL=${PLEX_URL}
+      - PLEX_TOKEN=${PLEX_TOKEN}
+      - COMMAND_PREFIX=!
+      - DEFAULT_QUALITY=1080
+      - MAX_BITRATE=8000
+    volumes:
+      - ./data:/app/data
+```
+
+Create a `.env` file:
+```env
+DISCORD_TOKEN=your_token
+PLEX_URL=http://192.168.1.100:32400
+PLEX_TOKEN=your_plex_token
+```
+
+Start:
+```bash
+docker-compose up -d
+```
+
+## With Local Plex
+
+If you're running Plex in Docker too:
+
+```yaml
+version: '3.8'
+
+services:
+  plex:
+    image: plexinc/pms-docker
+    container_name: plex
+    network_mode: host
+    environment:
+      - TZ=Australia/Sydney
+      - PLEX_CLAIM=claim-xxx
+    volumes:
+      - ./plex/config:/config
+      - /media:/media
+
+  schrostream:
+    image: ghcr.io/moderniselife/schrostream:latest
+    container_name: schrostream
+    restart: unless-stopped
+    network_mode: host
+    environment:
+      - DISCORD_TOKEN=${DISCORD_TOKEN}
+      - PLEX_URL=http://localhost:32400
+      - PLEX_TOKEN=${PLEX_TOKEN}
+    volumes:
+      - ./data:/app/data
+    depends_on:
+      - plex
+```
+
+## With Cloud Mounts (zurg/rclone)
+
+```yaml
+version: '3.8'
+
+services:
+  zurg:
+    image: ghcr.io/debridmediamanager/zurg-testing:latest
+    container_name: zurg
+    restart: unless-stopped
+    volumes:
+      - ./zurg/config.yml:/app/config.yml
+      - ./zurg/data:/app/data
+
+  rclone:
+    image: rclone/rclone:latest
+    container_name: rclone
+    restart: unless-stopped
+    cap_add:
+      - SYS_ADMIN
+    devices:
+      - /dev/fuse
+    security_opt:
+      - apparmor:unconfined
+    command: mount zurg: /data --allow-other --vfs-cache-mode full
+    volumes:
+      - ./rclone:/config/rclone
+      - /mnt/media:/data:shared
+    depends_on:
+      - zurg
+
+  plex:
+    image: plexinc/pms-docker
+    container_name: plex
+    network_mode: host
+    environment:
+      - TZ=Australia/Sydney
+    volumes:
+      - ./plex:/config
+      - /mnt/media:/media:ro
+    depends_on:
+      - rclone
+
+  schrostream:
+    image: ghcr.io/moderniselife/schrostream:latest
+    container_name: schrostream
+    restart: unless-stopped
+    network_mode: host
+    environment:
+      - DISCORD_TOKEN=${DISCORD_TOKEN}
+      - PLEX_URL=http://localhost:32400
+      - PLEX_TOKEN=${PLEX_TOKEN}
+    volumes:
+      - ./schrostream/data:/app/data
+    depends_on:
+      - plex
+```
+
+## Commands
+
+```bash
+# Start
+docker-compose up -d
+
+# View logs
+docker-compose logs -f schrostream
+
+# Stop
+docker-compose down
+
+# Update
+docker-compose pull
+docker-compose up -d
+
+# Rebuild from source
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+## Building from Source
+
+```yaml
+version: '3.8'
+
+services:
+  schrostream:
+    build: .
+    container_name: schrostream
+    restart: unless-stopped
+    env_file: .env
+    volumes:
+      - ./data:/app/data
+```
+
+```bash
+docker-compose build
+docker-compose up -d
+```
diff --git a/docs/guide/docker.md b/docs/guide/docker.md
new file mode 100644
index 0000000..8de8e95
--- /dev/null
+++ b/docs/guide/docker.md
@@ -0,0 +1,136 @@
+# Docker
+
+Run SchroStream in a Docker container.
+
+## Quick Start
+
+### Pull and Run
+
+```bash
+docker run -d \
+  --name schrostream \
+  -e DISCORD_TOKEN=your_token \
+  -e PLEX_URL=http://192.168.1.100:32400 \
+  -e PLEX_TOKEN=your_plex_token \
+  -v schrostream-data:/app/data \
+  ghcr.io/moderniselife/schrostream:latest
+```
+
+### Build Locally
+
+```bash
+git clone https://github.com/moderniselife/SchroStream.git
+cd schrostream
+docker build -t schrostream .
+```
+
+Run:
+```bash
+docker run -d \
+  --name schrostream \
+  --env-file .env \
+  -v schrostream-data:/app/data \
+  schrostream
+```
+
+## Environment Variables
+
+Pass environment variables with `-e` or `--env-file`:
+
+```bash
+docker run -d \
+  --name schrostream \
+  -e DISCORD_TOKEN=xxx \
+  -e PLEX_URL=http://plex:32400 \
+  -e PLEX_TOKEN=xxx \
+  -e COMMAND_PREFIX=! \
+  -e DEFAULT_QUALITY=1080 \
+  -e MAX_BITRATE=8000 \
+  schrostream
+```
+
+Or use an env file:
+```bash
+docker run -d \
+  --name schrostream \
+  --env-file .env \
+  schrostream
+```
+
+## Volumes
+
+Mount a volume for persistent data (playback positions):
+
+```bash
+-v /path/to/data:/app/data
+# or
+-v schrostream-data:/app/data
+```
+
+## Networking
+
+### Access Local Plex Server
+
+If Plex is running on the host:
+```bash
+docker run -d \
+  --name schrostream \
+  --network host \
+  --env-file .env \
+  schrostream
+```
+
+Or use host IP:
+```bash
+-e PLEX_URL=http://192.168.1.100:32400
+```
+
+### Access Plex in Another Container
+
+```bash
+docker network create media
+docker run -d --name plex --network media plex
+docker run -d --name schrostream --network media -e PLEX_URL=http://plex:32400 schrostream
+```
+
+## Commands
+
+```bash
+# View logs
+docker logs -f schrostream
+
+# Stop
+docker stop schrostream
+
+# Start
+docker start schrostream
+
+# Remove
+docker rm -f schrostream
+
+# Update
+docker pull ghcr.io/moderniselife/schrostream:latest
+docker rm -f schrostream
+# Run again with same command
+```
+
+## Dockerfile Reference
+
+```dockerfile
+FROM oven/bun:1 AS base
+WORKDIR /app
+
+FROM base AS install
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile --production
+
+FROM base AS release
+RUN apt-get update && apt-get install -y ffmpeg && rm -rf /var/lib/apt/lists/*
+COPY --from=install /app/node_modules ./node_modules
+COPY . .
+RUN bun run build
+
+ENV NODE_ENV=production
+VOLUME ["/app/data"]
+CMD ["bun", "start"]
+```
diff --git a/docs/guide/getting-started.md b/docs/guide/getting-started.md
new file mode 100644
index 0000000..f9b2ad8
--- /dev/null
+++ b/docs/guide/getting-started.md
@@ -0,0 +1,68 @@
+# Getting Started
+
+This guide will walk you through setting up SchroStream from scratch.
+
+## Quick Start
+
+### 1. Clone the Repository
+
+```bash
+git clone https://github.com/moderniselife/SchroStream.git
+cd schrostream
+```
+
+### 2. Install Dependencies
+
+Using Bun (recommended):
+```bash
+bun install
+```
+
+Or using npm:
+```bash
+npm install
+```
+
+### 3. Configure Environment
+
+Copy the example environment file:
+```bash
+cp .env.example .env
+```
+
+Edit `.env` with your settings:
+```env
+# Discord Configuration
+DISCORD_TOKEN=your_discord_token_here
+
+# Plex Configuration  
+PLEX_URL=http://your-plex-server:32400
+PLEX_TOKEN=your_plex_token_here
+```
+
+See [Discord Token](/guide/discord-token) and [Plex Token](/guide/plex-token) guides for how to obtain these.
+
+### 4. Start the Bot
+
+```bash
+bun dev
+```
+
+Or for production:
+```bash
+bun start
+```
+
+### 5. Use the Bot
+
+1. Join a Discord voice channel
+2. Type `!search movie name` to find content
+3. Type `!play 1` to start streaming
+4. Enjoy!
+
+## Next Steps
+
+- [Prerequisites](/guide/prerequisites) - Detailed system requirements
+- [Configuration](/guide/configuration) - All configuration options
+- [Commands](/guide/commands) - Full command reference
+- [Docker](/guide/docker) - Deploy with Docker
diff --git a/docs/guide/introduction.md b/docs/guide/introduction.md
new file mode 100644
index 0000000..dc682b5
--- /dev/null
+++ b/docs/guide/introduction.md
@@ -0,0 +1,37 @@
+# What is SchroStream?
+
+SchroStream is a Discord self-bot that streams content from your Plex media server directly to Discord voice channels using Discord's "Go Live" feature.
+
+## Features
+
+- **Stream Movies & TV Shows** - Play any content from your Plex library
+- **Full Playback Controls** - Pause, resume, seek, skip, and volume control
+- **Episode Selection** - Browse and select specific episodes of TV shows
+- **Resume Playback** - Automatically saves your position and offers to resume
+- **Multi-User Support** - Configure which users and roles can control the bot
+- **Cloud Mount Compatible** - Works with zurg, rclone, and other cloud mounts via HLS transcoding
+
+## How It Works
+
+1. The bot connects to Discord as a self-bot (using your account token)
+2. When you request media, it fetches the stream from your Plex server
+3. FFmpeg transcodes the stream to a format compatible with Discord
+4. The bot streams to Discord using the Go Live feature
+5. Anyone in the voice channel can watch!
+
+## Important Notes
+
+::: warning Self-Bot Notice
+SchroStream is a **self-bot** that uses your Discord account token. Self-bots are against Discord's Terms of Service. Use at your own risk.
+:::
+
+::: tip Plex Pass Not Required
+SchroStream uses Plex's transcode API and works without Plex Pass. However, having Plex Pass may improve transcoding performance.
+:::
+
+## Requirements
+
+- Node.js 18+ or Bun
+- FFmpeg with libx264 and libopus
+- A Plex Media Server
+- A Discord account
diff --git a/docs/guide/local-install.md b/docs/guide/local-install.md
new file mode 100644
index 0000000..41e82e2
--- /dev/null
+++ b/docs/guide/local-install.md
@@ -0,0 +1,109 @@
+# Local Installation
+
+Run SchroStream directly on your machine without Docker.
+
+## Prerequisites
+
+- [Node.js 18+](https://nodejs.org/) or [Bun](https://bun.sh/)
+- [FFmpeg](https://ffmpeg.org/) with libx264 and libopus
+- Git
+
+## Installation Steps
+
+### 1. Clone the Repository
+
+```bash
+git clone https://github.com/moderniselife/SchroStream.git
+cd schrostream
+```
+
+### 2. Install Dependencies
+
+**Using Bun (recommended):**
+```bash
+bun install
+```
+
+**Using npm:**
+```bash
+npm install
+```
+
+### 3. Configure Environment
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` with your configuration:
+```env
+DISCORD_TOKEN=your_token
+PLEX_URL=http://192.168.1.100:32400
+PLEX_TOKEN=your_plex_token
+```
+
+### 4. Build (Production)
+
+```bash
+bun run build
+```
+
+### 5. Start the Bot
+
+**Development (with hot reload):**
+```bash
+bun dev
+```
+
+**Production:**
+```bash
+bun start
+```
+
+## Running as a Service
+
+### systemd (Linux)
+
+Create `/etc/systemd/system/schrostream.service`:
+
+```ini
+[Unit]
+Description=SchroStream Discord Bot
+After=network.target
+
+[Service]
+Type=simple
+User=youruser
+WorkingDirectory=/path/to/schrostream
+ExecStart=/usr/bin/bun start
+Restart=always
+RestartSec=10
+Environment=NODE_ENV=production
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Enable and start:
+```bash
+sudo systemctl enable schrostream
+sudo systemctl start schrostream
+```
+
+### PM2
+
+```bash
+npm install -g pm2
+pm2 start "bun start" --name schrostream
+pm2 save
+pm2 startup
+```
+
+## Updating
+
+```bash
+git pull
+bun install
+bun run build
+# Restart the service
+```
diff --git a/docs/guide/permissions.md b/docs/guide/permissions.md
new file mode 100644
index 0000000..3edce0b
--- /dev/null
+++ b/docs/guide/permissions.md
@@ -0,0 +1,101 @@
+# Permissions
+
+SchroStream supports fine-grained permission control for who can use the bot.
+
+## Default Behavior
+
+By default, only the Discord account running the bot can use commands.
+
+## Configuring Permissions
+
+### Allow Specific Users
+
+Add Discord user IDs to `ALLOWED_USERS`:
+
+```env
+ALLOWED_USERS=123456789012345678,987654321098765432
+```
+
+### Allow Roles
+
+Add Discord role IDs to `ALLOWED_ROLES`:
+
+```env
+ALLOWED_ROLES=123456789012345678
+```
+
+Any user with one of these roles can control the bot.
+
+### Restrict to Specific Servers
+
+Add Discord server (guild) IDs to `ALLOWED_GUILDS`:
+
+```env
+ALLOWED_GUILDS=123456789012345678,987654321098765432
+```
+
+The bot will only respond to commands in these servers.
+
+## Finding IDs
+
+### Enable Developer Mode
+
+1. Open Discord Settings
+2. Go to **App Settings** → **Advanced**
+3. Enable **Developer Mode**
+
+### Copy User ID
+
+Right-click on a user → **Copy User ID**
+
+### Copy Role ID
+
+1. Go to **Server Settings** → **Roles**
+2. Right-click on a role → **Copy Role ID**
+
+### Copy Server ID
+
+Right-click on the server icon → **Copy Server ID**
+
+## Permission Check Order
+
+1. Check if user ID is in `ALLOWED_USERS`
+2. Check if user has any role in `ALLOWED_ROLES`
+3. Check if command is in `ALLOWED_GUILDS` (if configured)
+
+If any check passes, the command is allowed.
+
+## Example Configurations
+
+### Personal Use Only
+```env
+ALLOWED_USERS=
+ALLOWED_ROLES=
+```
+Only the bot account can use commands.
+
+### Allow Friends
+```env
+ALLOWED_USERS=123456789,987654321
+```
+Specific users can control the bot.
+
+### Server Admin Role
+```env
+ALLOWED_ROLES=123456789
+```
+Anyone with the "Media Controller" role can use the bot.
+
+### Restrict to One Server
+```env
+ALLOWED_GUILDS=123456789
+```
+Bot only works in your private server.
+
+### Combined
+```env
+ALLOWED_USERS=123456789
+ALLOWED_ROLES=987654321
+ALLOWED_GUILDS=555555555
+```
+Specific users OR users with the role can use the bot, but only in the specified server.
diff --git a/docs/guide/plex-token.md b/docs/guide/plex-token.md
new file mode 100644
index 0000000..d616b7e
--- /dev/null
+++ b/docs/guide/plex-token.md
@@ -0,0 +1,64 @@
+# Getting Your Plex Token
+
+SchroStream needs a Plex authentication token to access your media server.
+
+## Method 1: Plex Web App (Easiest)
+
+1. Open your Plex server in a web browser
+2. Play any media item
+3. Click the **···** menu and select **Get Info**
+4. Click **View XML**
+5. Look at the URL - find `X-Plex-Token=` parameter
+6. Copy the token value
+
+## Method 2: Browser Developer Tools
+
+1. Open [Plex Web](https://app.plex.tv) in your browser
+2. Log in and navigate to your server
+3. Press `F12` to open Developer Tools
+4. Go to the **Network** tab
+5. Refresh the page
+6. Look for any request to your Plex server
+7. Find `X-Plex-Token` in the request URL or headers
+
+## Method 3: Plex Account Page
+
+1. Go to [plex.tv/devices.xml](https://plex.tv/devices.xml)
+2. Sign in if prompted
+3. Search for `token=` in the XML
+4. Copy the token value
+
+## Method 4: Command Line
+
+If you have `curl` installed:
+
+```bash
+curl -X POST 'https://plex.tv/users/sign_in.json' \
+  -H 'X-Plex-Client-Identifier: SchroStream' \
+  -H 'X-Plex-Product: SchroStream' \
+  -H 'Content-Type: application/x-www-form-urlencoded' \
+  -d 'user[login]=YOUR_EMAIL&user[password]=YOUR_PASSWORD'
+```
+
+The response will contain your `authToken`.
+
+## Storing Your Token
+
+Add your token to the `.env` file:
+
+```env
+PLEX_URL=http://192.168.1.100:32400
+PLEX_TOKEN=your_plex_token_here
+```
+
+::: tip Finding Your Plex URL
+- Local server: `http://192.168.x.x:32400`
+- Remote access: Use your Plex server's external URL
+- Docker: Use the container name or host IP
+:::
+
+## Token Security
+
+- Plex tokens don't expire unless you sign out of all devices
+- Keep your token private - it grants full access to your Plex account
+- You can revoke access by signing out from Plex settings
diff --git a/docs/guide/prerequisites.md b/docs/guide/prerequisites.md
new file mode 100644
index 0000000..01fb4b6
--- /dev/null
+++ b/docs/guide/prerequisites.md
@@ -0,0 +1,68 @@
+# Prerequisites
+
+Before installing SchroStream, ensure you have the following:
+
+## System Requirements
+
+### Node.js or Bun
+
+SchroStream requires either:
+- **Bun** 1.0+ (recommended for performance)
+- **Node.js** 18.0+
+
+Check your version:
+```bash
+bun --version
+# or
+node --version
+```
+
+### FFmpeg
+
+FFmpeg is required for video transcoding. It must be compiled with:
+- `libx264` - H.264 video encoding
+- `libopus` - Opus audio encoding
+
+#### Install FFmpeg
+
+**macOS:**
+```bash
+brew install ffmpeg
+```
+
+**Ubuntu/Debian:**
+```bash
+sudo apt update
+sudo apt install ffmpeg
+```
+
+**Windows:**
+Download from [ffmpeg.org](https://ffmpeg.org/download.html) and add to PATH.
+
+**Verify installation:**
+```bash
+ffmpeg -version
+```
+
+## Plex Media Server
+
+You need access to a Plex Media Server with:
+- Media libraries configured
+- Network access from where SchroStream runs
+- A Plex account (Plex Pass not required)
+
+## Discord Account
+
+You need a Discord account to:
+- Generate a user token (self-bot)
+- Be a member of the server(s) where you want to stream
+
+::: warning Account Risk
+Using self-bots violates Discord's ToS. Consider using an alt account.
+:::
+
+## Network Requirements
+
+- SchroStream must be able to reach your Plex server
+- For cloud mounts (zurg/rclone), HLS transcoding is used automatically
+- Sufficient bandwidth for streaming (8+ Mbps recommended)
diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md
new file mode 100644
index 0000000..952bc54
--- /dev/null
+++ b/docs/guide/troubleshooting.md
@@ -0,0 +1,127 @@
+# Troubleshooting
+
+Common issues and their solutions.
+
+## Connection Issues
+
+### "Failed to initialize Plex session: 400 Bad Request"
+
+This usually happens when:
+- A previous stream didn't close properly
+- Plex transcode session is stuck
+
+**Solutions:**
+1. Wait 1-2 minutes and try again
+2. Restart the bot
+3. In Plex settings, go to **Settings > Status > Now Playing** and stop any stuck sessions
+
+### "Could not get stream URL for media"
+
+**Causes:**
+- Invalid Plex token
+- Media file not accessible
+- Plex server offline
+
+**Solutions:**
+1. Verify your `PLEX_TOKEN` is correct
+2. Check Plex can play the media directly
+3. Ensure Plex server is running and accessible
+
+### Bot doesn't respond to commands
+
+**Causes:**
+- Wrong command prefix
+- User not in `ALLOWED_USERS` or doesn't have `ALLOWED_ROLES`
+- Command sent in wrong guild
+
+**Solutions:**
+1. Check `COMMAND_PREFIX` in your `.env`
+2. Verify your user ID is allowed
+3. Check `ALLOWED_GUILDS` configuration
+
+## Streaming Issues
+
+### "Frame takes too long to send" warnings
+
+These warnings are normal during stream startup or when seeking. If they persist:
+- Lower `MAX_BITRATE` (try 5000)
+- Lower `DEFAULT_QUALITY` (try 720)
+- Check your network connection
+
+### No audio/video in Discord
+
+**Causes:**
+- FFmpeg not installed correctly
+- Missing codecs
+
+**Solutions:**
+1. Verify FFmpeg installation: `ffmpeg -version`
+2. Ensure libx264 and libopus are available
+3. Try reinstalling FFmpeg
+
+### Stream stops unexpectedly
+
+**Causes:**
+- Plex transcode timeout
+- Network interruption
+- Cloud mount issues
+
+**Solutions:**
+1. Check Plex server logs
+2. If using cloud mounts (zurg/rclone), verify they're working
+3. Try restarting the stream
+
+## Docker Issues
+
+### Container keeps restarting
+
+Check logs:
+```bash
+docker logs schrostream
+```
+
+Common causes:
+- Missing environment variables
+- Invalid tokens
+- FFmpeg not available in image
+
+### Can't connect to Plex on host
+
+Use `--network host` or the host's IP address:
+```bash
+-e PLEX_URL=http://192.168.1.100:32400
+```
+
+Don't use `localhost` or `127.0.0.1` unless using host networking.
+
+## Performance Issues
+
+### High CPU usage
+
+FFmpeg transcoding is CPU-intensive. Solutions:
+- Lower `DEFAULT_QUALITY` to 720
+- Lower `MAX_BITRATE` to 5000
+- Enable hardware transcoding in Plex
+
+### High memory usage
+
+- Normal usage is 200-500MB
+- If higher, check for memory leaks in logs
+- Restart the bot periodically
+
+## Getting Help
+
+If you're still having issues:
+
+1. Check the [GitHub Issues](https://github.com/moderniselife/SchroStream/issues)
+2. Enable debug logging: `DEBUG=* bun dev`
+3. Include relevant logs when reporting issues
+
+### Useful Debug Information
+
+When reporting issues, include:
+- Node.js/Bun version
+- FFmpeg version
+- Operating system
+- Relevant error messages
+- Steps to reproduce
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..1a86cf7
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,35 @@
+---
+layout: home
+
+hero:
+  name: SchroStream
+  text: Discord Plex Streaming Bot
+  tagline: Stream your Plex media library directly to Discord voice channels
+  actions:
+    - theme: brand
+      text: Get Started
+      link: /guide/getting-started
+    - theme: alt
+      text: View on GitHub
+      link: https://github.com/moderniselife/SchroStream
+
+features:
+  - icon: 🎬
+    title: Stream Movies & TV Shows
+    details: Play content from your Plex library directly in Discord voice channels using Go Live streaming.
+  - icon: 🔍
+    title: Easy Search
+    details: Search your entire Plex library with a simple command. Find movies, shows, and episodes quickly.
+  - icon: ⏯️
+    title: Full Playback Controls
+    details: Pause, resume, seek, skip episodes, and control volume - all from Discord chat commands.
+  - icon: 💾
+    title: Resume Playback
+    details: Your watch position is saved automatically. Resume where you left off, even after bot restarts.
+  - icon: 🐳
+    title: Docker Ready
+    details: Deploy easily with Docker and Docker Compose. Works with cloud mounts like zurg/rclone.
+  - icon: 👥
+    title: Multi-User Support
+    details: Configure which users and roles can control the bot with fine-grained permissions.
+---
diff --git a/docs/package.json b/docs/package.json
new file mode 100644
index 0000000..c7ddc38
--- /dev/null
+++ b/docs/package.json
@@ -0,0 +1,13 @@
+{
+  "name": "schrostream-docs",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vitepress dev",
+    "build": "vitepress build",
+    "preview": "vitepress preview"
+  },
+  "devDependencies": {
+    "vitepress": "^1.0.0"
+  }
+}
diff --git a/src/bot/commands/episodes.ts b/src/bot/commands/episodes.ts
new file mode 100644
index 0000000..e7f1ab4
--- /dev/null
+++ b/src/bot/commands/episodes.ts
@@ -0,0 +1,99 @@
+import type { Message } from 'discord.js-selfbot-v13';
+import { getSearchResult } from '../../plex/search.js';
+import plexClient from '../../plex/client.js';
+
+export async function episodesCommand(message: Message, args: string[]): Promise<void> {
+  const selection = parseInt(args[0], 10);
+
+  if (isNaN(selection) || selection < 1) {
+    await message.channel.send('❌ Usage: `!episodes <number>` (use `!search` first to find a show)');
+    return;
+  }
+
+  const mediaItem = getSearchResult(message.author.id, selection);
+
+  if (!mediaItem) {
+    await message.channel.send('❌ Invalid selection. Use `!search` to find media first');
+    return;
+  }
+
+  if (mediaItem.type !== 'show') {
+    await message.channel.send(`❌ "${mediaItem.title}" is not a TV show`);
+    return;
+  }
+
+  const statusMsg = await message.channel.send(`📺 Loading episodes for "${mediaItem.title}"...`);
+
+  try {
+    const episodes = await plexClient.getEpisodes(mediaItem.ratingKey);
+    
+    if (episodes.length === 0) {
+      await statusMsg.edit('❌ No episodes found for this show');
+      return;
+    }
+
+    // Group by season
+    const seasons = new Map<number, typeof episodes>();
+    for (const ep of episodes) {
+      const seasonNum = ep.parentIndex || 0;
+      if (!seasons.has(seasonNum)) {
+        seasons.set(seasonNum, []);
+      }
+      seasons.get(seasonNum)!.push(ep);
+    }
+
+    // Build output
+    const lines: string[] = [`**📺 ${mediaItem.title}** (${mediaItem.year || 'N/A'})\n`];
+    
+    // Sort seasons
+    const sortedSeasons = [...seasons.keys()].sort((a, b) => a - b);
+    
+    for (const seasonNum of sortedSeasons) {
+      const seasonEpisodes = seasons.get(seasonNum)!;
+      const seasonLabel = seasonNum === 0 ? 'Specials' : `Season ${seasonNum}`;
+      
+      lines.push(`**${seasonLabel}** (${seasonEpisodes.length} episodes)`);
+      
+      // List episodes (limit to avoid message too long)
+      const epList = seasonEpisodes
+        .sort((a, b) => (a.index || 0) - (b.index || 0))
+        .slice(0, 26) // Max 26 per season to avoid message limit
+        .map(ep => {
+          const epNum = ep.index ? `E${String(ep.index).padStart(2, '0')}` : '';
+          return `  ${epNum} - ${ep.title}`;
+        });
+      
+      lines.push(epList.join('\n'));
+      
+      if (seasonEpisodes.length > 26) {
+        lines.push(`  *...and ${seasonEpisodes.length - 26} more*`);
+      }
+      
+      lines.push('');
+    }
+
+    lines.push(`\n*Use \`!play ${selection} S01E01\` to play a specific episode*`);
+
+    // Split if too long
+    const output = lines.join('\n');
+    if (output.length > 1900) {
+      // Send season summary only
+      const summary = [`**📺 ${mediaItem.title}** (${mediaItem.year || 'N/A'})\n`];
+      for (const seasonNum of sortedSeasons) {
+        const seasonEpisodes = seasons.get(seasonNum)!;
+        const seasonLabel = seasonNum === 0 ? 'Specials' : `Season ${seasonNum}`;
+        const firstEp = seasonEpisodes[0];
+        const lastEp = seasonEpisodes[seasonEpisodes.length - 1];
+        summary.push(`**${seasonLabel}**: ${seasonEpisodes.length} episodes (E${String(firstEp.index || 1).padStart(2, '0')} - E${String(lastEp.index || seasonEpisodes.length).padStart(2, '0')})`);
+      }
+      summary.push(`\n*Total: ${episodes.length} episodes*`);
+      summary.push(`*Use \`!play ${selection} S01E01\` to play a specific episode*`);
+      await statusMsg.edit(summary.join('\n'));
+    } else {
+      await statusMsg.edit(output);
+    }
+  } catch (error) {
+    console.error('[Episodes] Error:', error);
+    await statusMsg.edit(`❌ Failed to load episodes: ${error instanceof Error ? error.message : 'Unknown error'}`);
+  }
+}
diff --git a/src/bot/commands/help.ts b/src/bot/commands/help.ts
index cf20e63..244d6dc 100644
--- a/src/bot/commands/help.ts
+++ b/src/bot/commands/help.ts
@@ -9,9 +9,10 @@ export async function helpCommand(message: Message, _args: string[]): Promise<vo
 
 **Media Search & Playback:**
 \`${prefix}search <query>\` - Search for movies or TV shows
-\`${prefix}play <number>\` - Play a result from your search
+\`${prefix}episodes <number>\` - List seasons/episodes for a show
+\`${prefix}play <number>\` - Play a result (S01E01 for shows)
+\`${prefix}play <number> S02E05\` - Play specific episode
 \`${prefix}play resume\` - Continue where you left off
-\`${prefix}play start\` - Start from beginning (ignore saved position)
 \`${prefix}stop\` - Stop the current stream
 
 **Playback Controls:**
diff --git a/src/bot/commands/index.ts b/src/bot/commands/index.ts
index 18d27e2..17774d8 100644
--- a/src/bot/commands/index.ts
+++ b/src/bot/commands/index.ts
@@ -8,6 +8,7 @@ import { skipCommand } from './skip.js';
 import { nowPlayingCommand } from './nowplaying.js';
 import { helpCommand } from './help.js';
 import { volumeCommand } from './volume.js';
+import { episodesCommand } from './episodes.js';
 
 export type CommandHandler = (message: Message, args: string[]) => Promise<void>;
 
@@ -31,6 +32,9 @@ const commands: Record<string, CommandHandler> = {
   volume: volumeCommand,
   vol: volumeCommand,
   v: volumeCommand,
+  episodes: episodesCommand,
+  eps: episodesCommand,
+  seasons: episodesCommand,
 };
 
 export async function handleCommand(
diff --git a/src/bot/commands/play.ts b/src/bot/commands/play.ts
index 4be2c7d..5edd1d7 100644
--- a/src/bot/commands/play.ts
+++ b/src/bot/commands/play.ts
@@ -63,12 +63,44 @@ export async function playCommand(message: Message, args: string[]): Promise<voi
     let itemToPlay = mediaItem;
     
     if (mediaItem.type === 'show') {
+      // Check for episode selection: !play 1 S02E05 or !play 1 2 5
+      let targetSeason = 1;
+      let targetEpisode = 1;
+      
+      if (args.length >= 2) {
+        // Try parsing S01E01 format
+        const episodeMatch = args[1].toUpperCase().match(/S(\d+)E(\d+)/);
+        if (episodeMatch) {
+          targetSeason = parseInt(episodeMatch[1], 10);
+          targetEpisode = parseInt(episodeMatch[2], 10);
+        } else if (args.length >= 3) {
+          // Try parsing separate numbers: !play 1 2 5 (show, season, episode)
+          targetSeason = parseInt(args[1], 10) || 1;
+          targetEpisode = parseInt(args[2], 10) || 1;
+        }
+      }
+      
       const episodes = await plexClient.getEpisodes(mediaItem.ratingKey);
       if (episodes.length === 0) {
         await message.channel.send('❌ No episodes found for this show');
         return;
       }
-      itemToPlay = episodes[0];
+      
+      // Find the specific episode
+      const foundEpisode = episodes.find(ep => 
+        ep.parentIndex === targetSeason && ep.index === targetEpisode
+      );
+      
+      if (foundEpisode) {
+        itemToPlay = foundEpisode;
+      } else if (args.length >= 2) {
+        // User specified an episode but it wasn't found
+        await message.channel.send(`❌ Episode S${String(targetSeason).padStart(2, '0')}E${String(targetEpisode).padStart(2, '0')} not found\n\nUse \`!play ${selection}\` to start from S01E01`);
+        return;
+      } else {
+        // Default to first episode
+        itemToPlay = episodes[0];
+      }
     }
     
     // Check for saved position
diff --git a/src/plex/client.ts b/src/plex/client.ts
index 9271564..2649ab1 100644
--- a/src/plex/client.ts
+++ b/src/plex/client.ts
@@ -210,10 +210,9 @@ export class PlexClient {
         autoAdjustQuality: '0',
         directStreamAudio: '1',
         mediaBufferSize: '102400',
-        copyts: '1',
         'X-Plex-Session-Identifier': sessionId,
         'X-Plex-Token': this.token,
-        'X-Plex-Client-Identifier': config.plex.clientIdentifier,
+        'X-Plex-Client-Identifier': 'SchroStream',
         'X-Plex-Product': 'SchroStream',
         'X-Plex-Device': 'Node',
         'X-Plex-Platform': 'Node',
@@ -253,7 +252,6 @@ export class PlexClient {
       videoResolution: `${width}x${height}`,
       videoQuality: '100',
       'X-Plex-Token': this.token,
-      'X-Plex-Client-Identifier': config.plex.clientIdentifier,
     });
 
     return `${this.baseUrl}/video/:/transcode/universal/start.m3u8?${params.toString()}`;
@@ -264,6 +262,23 @@ export class PlexClient {
     return `${this.baseUrl}${thumb}?X-Plex-Token=${this.token}`;
   }
 
+  async stopTranscodeSession(sessionId?: string): Promise<void> {
+    try {
+      const params = new URLSearchParams({
+        'X-Plex-Token': this.token,
+      });
+      if (sessionId) {
+        params.set('session', sessionId);
+      }
+      
+      const url = `${this.baseUrl}/video/:/transcode/universal/stop?${params.toString()}`;
+      await fetch(url, { method: 'GET' });
+      console.log('[Plex] Stopped transcode session');
+    } catch (error) {
+      // Ignore errors - session might not exist
+    }
+  }
+
   private parseMediaItem(item: any): PlexMediaItem {
     return {
       ratingKey: String(item.ratingKey),
diff --git a/src/stream/video-streamer.ts b/src/stream/video-streamer.ts
index 1b27f71..f8bba7b 100644
--- a/src/stream/video-streamer.ts
+++ b/src/stream/video-streamer.ts
@@ -150,6 +150,9 @@ class VideoStreamer {
     try {
       console.log('[VideoStreamer] Stream URL:', session.streamUrl.substring(0, 100) + '...');
 
+      // Stop any existing transcode sessions first to avoid 400 errors
+      await plexClient.stopTranscodeSession();
+      
       // Initialize Plex session by fetching the m3u8 first
       // This tells Plex to start the transcode session
       console.log('[VideoStreamer] Initializing Plex transcode session...');