# 🎮 Gooner Training Academy# 🎮 Gooner Training Academy# 🎮 Gooner Training Academy# Gooner Training Academy



*Master Your Dedication Through Advanced Training Systems*



A comprehensive adult edging training application featuring three specialized game modes, an advanced XP progression system, and professional media library management.*Master Your Dedication Through Advanced Training Systems*



---



## 🚀 Quick StartA comprehensive adult edging training application featuring three specialized game modes, an advanced XP progression system, and professional media library management.*Master Your Dedication Through Advanced Training Systems**How long can you last?*



### Desktop Application (Recommended)

```bash

npm install

npm start

```



## 🏆 Three Core Game Modes

## 🎮 Game Modes

### 🎬 Training Academy

**Immersive scenario-based training with progressive storylines**



The Training Academy offers structured training programs through branching narrative scenarios. Experience guided sessions with multiple specialized training modes:



- **Photography Studio**: Webcam-based photography sessions with posing instructions

- **Training Academy**: Core scenario-driven training with adaptive content### Web Browser

- **Punishment Gauntlet**: Intense punishment and humiliation challenges  

- **Endurance Trials**: Progressive endurance training from beginner to expert levels



**XP Rewards:**

- 📸 Photo Session Completion: **2 XP per photo**

- ⏱️ Time-Based Training: **1 XP per 2 minutes**

- 🎯 Scenario Completion Bonuses

- 📹 Webcam Activities: **1 XP per minute**



### ⚡ Quick Play

**Fast-start training with customizable sessions**

### 🎬 Training Academy

Quick Play provides immediate access to task-based gameplay with streamlined setup and maximum customization control.

**Immersive scenario-based training with progressive storylines**

**Session Setup:**

**Fast-start training with customizable sessions**

### 🎬 Training Academy

Quick Play provides immediate access to task-based gameplay with streamlined setup and maximum customization control.

**Immersive scenario-based training with progressive storylines**

**Session Setup:**

- ⏰ Flexible Duration: 15 minutes to Endless hours

- 🎬 Background Video Integration: 40+ videos available

- 🎛️ Individual Task Controls: Enable/disable specific tasks

- 🎯 Custom Task Creation: Add personalized challenges


**XP Rewards:**

- ✅ Task Completion: **1-3 XP** (based on task duration)

- 🎯 Session Bonuses: **2 XP every 15 minutes**

- 📹 Recording Bonus: **+1 XP** when webcam recording enabled



**Features:**

- Real-time task filtering with persistent settings

- Background video with floating opacity controls

- Session cleanup and statistics tracking

- Webcam integration for photo capture

- Punishment system with consequence images


### 🎭 Porn Cinema

**Professional video viewing experience**


Dedicated video player system designed for focused media consumption with comprehensive viewing analytics.

- 🎬 Professional Video Interface: Full-screen theater mode

- 📋 Playlist Management: Organize viewing sessions



- 📊 Progress Tracking: Resume exactly where you left off


- 🎛️ Advanced Controls: Speed, volume, seeking, and more

**XP Rewards:**

- ⏱️ Viewing Time: **1 XP per 5 minutes** of active viewing

- ✅ Video Completion: **Bonus XP** for 90%+ completion

- 📊 Binge Sessions: **Additional rewards** for extended viewing- Multiple training modes with unique content- 

- Seamless integration with linked video directories

- Watch time and completion analytics- Progressive difficulty scaling

- Favorite video tracking

- Theater mode for distraction-free viewing

- Multi-format video support

- Real-time XP tracking with status display

### 📈 Experience Points (XP) Overview

The XP system tracks your dedication and progress across all training modes, providing a unified progression metric.



### 🎯 XP Sources by Mode

| Mode | Activity | XP Reward | Notes |
|------|----------|-----------|-------|
| **Training Academy** | Time Training | 1 XP / 2 minutes | Passive time-based reward |
| | Webcam Activity | 1 XP / minute | Active engagement bonus |
| | Photo Session | 2 XP / photo | Achievement-based reward |
| **Quick Play** | Task Completion | 1-3 XP | Speed-based scaling |
| | Session Bonus | 2 XP / 15 min | Consistency reward |
| | Recording Bonus | +1 XP | Additional engagement |
| **Porn Cinema** | Video Viewing | 1 XP / 5 minutes | Engagement tracking |
| | Video Completion | Bonus XP | 90%+ completion required |

### 📊 Progression Levels

- **🌱 Beginner (0-100 XP)**: Learning the basics

- **📈 Intermediate (100-500 XP)**: Building consistency  

- **🎯 Advanced (500-1500 XP)**: Mastering techniques

- **🏆 Expert (1500+ XP)**: Peak dedication


### 🔍 XP Tracking

- **Real-time Display**: Live XP counter in all game modes- Real-time XP tracking with status display

- **Session Summaries**: XP earned per session with breakdowns

- **Statistics Dashboard**: Comprehensive XP analytics

- **Progress Visualization**: Charts and progression metrics


## 📚 Library System Explained

### 🎬 Video Library Management

The Library system provides centralized management for all your media content across game modes.



### 📁 Library Organization###

- **Video Directories**- Real-time task filtering with persistent settings

- **Automatic Discovery**: Scans linked directories for video files

- **Format Support**: MP4, WebM, MOV, AVI, and more

- **Smart Indexing**: Automatic categorization and metadata

- **Cross-Mode Access**: Available in all game modes- Session cleanup and statistics tracking



- **Photo Collections**: Webcam integration for photo capture Content Management

- **Upload System**: High-quality image upload (1600x1200 resolution)

- **Smart Categorization**: Tasks vs Consequences automatic sorting- Punishment system with consequence images

- **Gallery Management**: Pinterest-style layout with aspect ratio optimization


Dedicated video player system designed for focused media consumption with comprehensive viewing analytics.**Session Setup:**- **Custom Images**: Upload and categorize adult content (tasks vs consequences)

#### **Advanced Management**

- **Bulk Operations**: Select, enable/disable, delete multiple files

- **Dynamic Themes**: Library theme adapts to your uploaded content

- **Smart Compression**: Optimized storage without quality loss**Player Features:**- ⏰ Flexible Duration: 15 minutes to 4+ hours- **Video Integration**: Link external video directories for seamless playback

- **Usage Analytics**: Track which content is most accessed

- 🎬 Professional Video Interface: Full-screen theater mode

#### **Integration Across Modes**

- **Quick Play**: Background video selection and task images- 📋 Playlist Management: Organize viewing sessions- 🎬 Background Video Integration: 40+ videos available- **High-Quality Processing**: 1600x1200 resolution with smart compression

- **Training Academy**: Scenario content and photo sessions

- **Porn Cinema**: Full video library access with playlists- 📊 Progress Tracking: Resume exactly where you left off

- **Punishment System**: Consequence image selection

- 🔄 Multi-Screen Mode: 4-video grid for intensive sessions- 🎛️ Individual Task Controls: Enable/disable specific tasks- **Storage Management**: 50 image limit with usage monitoring

### 📊 Library Analytics

- **📈 Content Usage**: Most viewed/used media tracking- 🎛️ Advanced Controls: Speed, volume, seeking, and more

- **💾 Storage Monitoring**: Space usage and optimization suggestions  

- **🔄 Sync Status**: Real-time directory scanning results- 🎯 Custom Task Creation: Add personalized challenges- **Bulk Operations**: Select, enable/disable, and delete multiple images

- **📋 Content Health**: Missing files and broken links detection

**XP Rewards:**

---

- ⏱️ Viewing Time: **1 XP per 5 minutes** of active viewing

## 🎛️ Key Features

- ✅ Video Completion: **Bonus XP** for 90%+ completion

### 🔒 Data Protection

- **Automatic Backups**: Every 30 minutes during active sessions- 📊 Binge Sessions: **Additional rewards** for extended viewing**XP Rewards:**## � Quick Start

- **Manual Backup/Restore**: Full control over your data

- **Export/Import**: Portable data management

- **Emergency Backups**: Before any reset operations

**Features:**- ✅ Task Completion: **1-3 XP** (based on completion speed)

### 🎨 Customization

- **6 Visual Themes**: Including dynamic Library theme- Seamless integration with linked video directories

- **Task Disable Toggles**: Individual control in Quick Play

- **Adaptive Difficulty**: Progressive timer scaling- Watch time and completion analytics- 🎯 Session Bonuses: **2 XP every 15 minutes**### Desktop App (Recommended)

- **Personal Content**: Upload and organize your media

- Favorite video tracking

### 🖥️ Technical Excellence

- **Cross-Platform**: Windows, Mac, Linux support- Theater mode for distraction-free viewing- 📹 Recording Bonus: **+1 XP** when webcam recording enabled```bash

- **Electron Desktop App**: Native OS integration

- **Web Browser Compatible**: No installation required- Multi-format video support

- **Professional UI**: Responsive, modern design

npm install

---

---

## 🎯 Controls & Navigation

**Features:**npm start

| Control | Action | Mode Availability |

|---------|--------|-------------------|## ⭐ XP System Explained

| **Enter** | Complete current task | All modes |

| **Ctrl** | Skip task (triggers punishment) | Training, Quick Play |- Real-time task filtering with persistent settings```

| **Space/P** | Pause/Resume session | All modes |

| **M** | Toggle background music | All modes |### 📈 Experience Points (XP) Overview

| **H** | Show help menu | All modes |

| **Escape** | Close dialogs/return to menu | All modes |The XP system tracks your dedication and progress across all training modes, providing a unified progression metric.- Background video with floating opacity controls



---



## 🛠️ Technical Architecture### 🎯 XP Sources by Mode- Session cleanup and statistics tracking### Web Browser



### 📂 Core Structure

```

webGame/| Mode | Activity | XP Reward | Notes |- Webcam integration for photo capture1. Open `index.html` in a modern browser

├── index.html              # Main hub and library management

├── quick-play.html         # Quick Play game mode|------|----------|-----------|-------|

├── training-academy.html   # Training Academy mode

├── porn-cinema.html        # Video player system| **Training Academy** | Time Training | 1 XP / 2 minutes | Passive time-based reward |- Punishment system with consequence images2. Choose your game mode and begin

├── player-stats.html       # Statistics dashboard

├── user-profile.html       # Profile and achievements| | Webcam Activity | 1 XP / minute | Active engagement bonus |

├── src/

│   ├── core/              # Game engine and state management| | Photo Session | 2 XP / photo | Achievement-based reward |3. Upload custom content via Image Management

│   ├── data/modes/        # Game mode configurations

│   ├── features/          # Modular feature systems| **Quick Play** | Task Completion | 1-3 XP | Speed-based scaling |

│   │   ├── media/         # Video players and media management

│   │   ├── stats/         # XP and statistics tracking| | Session Bonus | 2 XP / 15 min | Consistency reward |---4. Configure settings in Options menu

│   │   ├── tasks/         # Interactive task system

│   │   └── ui/            # User interface components| | Recording Bonus | +1 XP | Additional engagement |

│   ├── styles/            # CSS themes and styling

│   └── utils/             # Utility functions and helpers| **Porn Cinema** | Video Viewing | 1 XP / 5 minutes | Engagement tracking |

├── images/                # User-uploaded image library

├── audio/                 # Background music collection| | Video Completion | Bonus XP | 90%+ completion required |

└── videos/                # Linked video directories

```### 🎭 Porn Cinema## 🎯 Key Controls



### 🔧 Development Requirements### 📊 Progression Levels

- **Node.js 16+**: For Electron desktop application

- **Modern Browser**: Chrome 90+, Firefox 88+, Safari 14+- **🌱 Beginner (0-100 XP)**: Learning the basics**Professional video viewing experience**

- **Desktop Features**: File system access for media linking

- **Storage**: Minimum 100MB for application and user content- **📈 Intermediate (100-500 XP)**: Building consistency  



---- **🎯 Advanced (500-1500 XP)**: Mastering techniques- **Enter** - Complete task



## 📋 Recent Major Updates- **🏆 Expert (1500+ XP)**: Peak dedication



### v4.0 - Comprehensive Backup System (November 12, 2025)Dedicated video player system designed for focused media consumption with comprehensive viewing analytics.- **Ctrl** - Skip task (triggers punishment)

- ✅ **Automatic Data Protection**: 30-minute backup intervals

- ✅ **Manual Backup Controls**: User-initiated backup/restore### 🔍 XP Tracking

- ✅ **Export/Import System**: Portable data management

- ✅ **Emergency Backup Hooks**: Before reset operations- **Real-time Display**: Live XP counter in all game modes- **Space/P** - Pause/resume

- ✅ **Data Loss Recovery**: Complete incident prevention system

- **Session Summaries**: XP earned per session with breakdowns

### v3.3 - Media Library Consolidation (November 11, 2025)

- ✅ **Unified Gallery System**: Single media management interface- **Statistics Dashboard**: Comprehensive XP analytics**Player Features:**- **M** - Toggle music

- ✅ **Dynamic Library Theme**: User content-based theming

- ✅ **Pinterest Layout**: Aspect ratio-optimized image display- **Progress Visualization**: Charts and progression metrics

- ✅ **Advanced Organization**: Smart categorization and bulk operations

- 🎬 Professional Video Interface: Full-screen theater mode- **H** - Help menu

### v3.2 - Quick Play Enhancement (November 6, 2025)

- ✅ **Task Disable Toggles**: Individual task control system---

- ✅ **Persistent Settings**: Configuration memory across sessions

- ✅ **Real-time Filtering**: Dynamic task exclusion- 📋 Playlist Management: Organize viewing sessions- **Escape** - Close dialogs

- ✅ **Enhanced Debugging**: Comprehensive logging system

## 📚 Library System Explained

### v3.1 - Background Video Integration (November 3, 2025)

- ✅ **Seamless Video Playback**: Background videos during gameplay- 📊 Progress Tracking: Resume exactly where you left off

- ✅ **Opacity Controls**: Floating video control system

- ✅ **40+ Video Integration**: Comprehensive video library access### 🎬 Video Library Management

- ✅ **Multi-Mode Support**: Video features across all game modes

The Library system provides centralized management for all your media content across game modes.- 🔄 Multi-Screen Mode: 4-video grid for intensive sessions## 🛠️ Technical

---



## 🎓 Getting Started Guide

### 📁 Library Organization- 🎛️ Advanced Controls: Speed, volume, seeking, and more

### 1. **First Launch**

   - Run the application via desktop app or open `index.html`

   - Complete the initial setup and library configuration

   - Link your video directories for enhanced experience#### **Video Directories**### Requirements



### 2. **Library Setup**- **Automatic Discovery**: Scans linked directories for video files

   - Upload task and consequence images via Image Management

   - Link video directories for background content- **Format Support**: MP4, WebM, MOV, AVI, and more**XP Rewards:**- Modern web browser with webcam support

   - Organize content for optimal gameplay experience

- **Smart Indexing**: Automatic categorization and metadata

### 3. **Choose Your Path**

   - **New to Training**: Start with **Quick Play** for immediate access- **Cross-Mode Access**: Available in all game modes- ⏱️ Viewing Time: **1 XP per 5 minutes** of active viewing- Local storage for saves and images

   - **Structured Learning**: Begin with **Training Academy** scenarios  

   - **Media Focus**: Explore **Porn Cinema** for dedicated viewing



### 4. **Progress Tracking**#### **Photo Collections**- ✅ Video Completion: **Bonus XP** for 90%+ completion- 50MB+ available storage for custom content

   - Monitor XP growth across all modes

   - Check statistics dashboard for detailed analytics- **Upload System**: High-quality image upload (1600x1200 resolution)

   - Use player profile to track achievements and milestones

- **Smart Categorization**: Tasks vs Consequences automatic sorting- 📊 Binge Sessions: **Additional rewards** for extended viewing

---

- **Gallery Management**: Pinterest-style layout with aspect ratio optimization

## 📄 License

- **Storage Limits**: 50 image maximum with usage monitoring### File Structure

This project is licensed under the MIT License - see the LICENSE file for details.



**Note**: This is adult content software intended for personal use by consenting adults. Please use responsibly and in accordance with local laws and regulations.
### 🔧 Library Features**Features:**```



#### **Media Linking**- Seamless integration with linked video directorieswebGame/

```

📁 Linked Directories:- Watch time and completion analytics├── index.html              # Main interface

├── /videos/mainstream/     # General video content

├── /videos/specialized/    # Category-specific content  - Favorite video tracking├── porn-cinema.html        # Professional video player

├── /images/tasks/         # Task-related images

└── /images/consequences/  # Punishment images- Theater mode for distraction-free viewing├── player-stats.html       # Statistics dashboard

```

- Multi-format video support├── user-profile.html       # User profile and achievements

#### **Advanced Management**

- **Bulk Operations**: Select, enable/disable, delete multiple files├── src/

- **Dynamic Themes**: Library theme adapts to your uploaded content

- **Smart Compression**: Optimized storage without quality loss---│   ├── core/              # Game engine and mode management

- **Usage Analytics**: Track which content is most accessed

│   ├── data/modes/        # Game mode data files

#### **Integration Across Modes**

- **Quick Play**: Background video selection and task images## ⭐ XP System Explained│   ├── features/          

- **Training Academy**: Scenario content and photo sessions

- **Porn Cinema**: Full video library access with playlists│   │   ├── media/         # Video players and cinema system

- **Punishment System**: Consequence image selection

### 📈 Experience Points (XP) Overview│   │   ├── stats/         # Player statistics tracking

### 📊 Library Analytics

- **📈 Content Usage**: Most viewed/used media trackingThe XP system tracks your dedication and progress across all training modes, providing a unified progression metric.│   │   ├── tasks/         # Interactive task management

- **💾 Storage Monitoring**: Space usage and optimization suggestions  

- **🔄 Sync Status**: Real-time directory scanning results│   │   └── ...            # Audio, webcam, UI features

- **📋 Content Health**: Missing files and broken links detection

### 🎯 XP Sources by Mode│   └── styles/            # CSS and themes

---

├── images/                # Image storage

## 🎛️ Key Features

| Mode | Activity | XP Reward | Notes |├── audio/                 # Background music

### 🔒 Data Protection

- **Automatic Backups**: Every 30 minutes during active sessions|------|----------|-----------|-------|├── videos/                # Video file organization

- **Manual Backup/Restore**: Full control over your data

- **Export/Import**: Portable data management| **Training Academy** | Time Training | 1 XP / 2 minutes | Passive time-based reward |└── package.json           # Electron app config

- **Emergency Backups**: Before any reset operations

| | Webcam Activity | 1 XP / minute | Active engagement bonus |```

### 🎨 Customization

- **6 Visual Themes**: Including dynamic Library theme| | Photo Session | 2 XP / photo | Achievement-based reward |

- **Task Disable Toggles**: Individual control in Quick Play

- **Adaptive Difficulty**: Progressive timer scaling| **Quick Play** | Task Completion | 1-3 XP | Speed-based scaling |### Features

- **Personal Content**: Upload and organize your media

| | Session Bonus | 2 XP / 15 min | Consistency reward |- **Cross-Platform**: Windows, Mac, Linux via Electron

### 🖥️ Technical Excellence

- **Cross-Platform**: Windows, Mac, Linux support| | Recording Bonus | +1 XP | Additional engagement |- **Responsive Design**: Works on desktop and mobile

- **Electron Desktop App**: Native OS integration

- **Web Browser Compatible**: No installation required| **Porn Cinema** | Video Viewing | 1 XP / 5 minutes | Engagement tracking |- **Local Storage**: All data stays on your device

- **Professional UI**: Responsive, modern design

| | Video Completion | Bonus XP | 90%+ completion required |- **Privacy-First**: No data sent to servers

---



## 🎯 Controls & Navigation

### 📊 Progression Levels## 📋 Recent Updates

| Control | Action | Mode Availability |

|---------|--------|-------------------|- **🌱 Beginner (0-100 XP)**: Learning the basics

| **Enter** | Complete current task | All modes |

| **Ctrl** | Skip task (triggers punishment) | Training, Quick Play |- **📈 Intermediate (100-500 XP)**: Building consistency  ### v3.3 - Media Library Consolidation & Theme System (November 11, 2025)

| **Space/P** | Pause/Resume session | All modes |

| **M** | Toggle background music | All modes |- **🎯 Advanced (500-1500 XP)**: Mastering techniques- ✅ **Complete Media Library Cleanup**: 3-phase consolidation removing 500+ lines of duplicate code

| **H** | Show help menu | All modes |

| **Escape** | Close dialogs/return to menu | All modes |- **🏆 Expert (1500+ XP)**: Peak dedication  - Phase 1: Unified video gallery system (lib-video-gallery)



---  - Phase 2: Consolidated image management (lib-image-gallery) 



## 🛠️ Technical Architecture### 🔍 XP Tracking  - Phase 3: Streamlined audio system (lib-audio-gallery)



### 📂 Core Structure- **Real-time Display**: Live XP counter in all game modes- ✅ **Advanced Theme System**: 6 visual themes (hentai, pornstars, BBC, feet, library, none)

```

webGame/- **Session Summaries**: XP earned per session with breakdowns- ✅ **Dynamic Library Theme**: Pinterest-style layout using user's personal image collection

├── index.html              # Main hub and library management

├── quick-play.html         # Quick Play game mode- **Statistics Dashboard**: Comprehensive XP analytics- ✅ **Smart Image Layout**: Dynamic container sizing based on aspect ratios with gap-free stacking

├── training-academy.html   # Training Academy mode

├── porn-cinema.html        # Video player system- **Progress Visualization**: Charts and progression metrics- ✅ **Enhanced File Handling**: Proper URI encoding for special characters in file paths

├── player-stats.html       # Statistics dashboard

├── user-profile.html       # Profile and achievements

├── src/

│   ├── core/              # Game engine and state management---### v3.2 - Task Management & Session Cleanup (November 6, 2025)

│   ├── data/modes/        # Game mode configurations

│   ├── features/          # Modular feature systems- ✅ **Task Disable Toggles**: Individual task control with persistent localStorage settings

│   │   ├── media/         # Video players and media management

│   │   ├── stats/         # XP and statistics tracking## 📚 Library System Explained- ✅ **Consequence System Integration**: Disabled tasks filtered from consequence selection

│   │   ├── tasks/         # Interactive task system

│   │   └── ui/            # User interface components- ✅ **ID Consistency**: Fixed task ID generation to handle both numeric and generated IDs

│   ├── styles/            # CSS themes and styling

│   └── utils/             # Utility functions and helpers### 🎬 Video Library Management- ✅ **Session Cleanup**: Comprehensive endGame cleanup stopping videos and periodic popups

├── images/                # User-uploaded image library

├── audio/                 # Background music collectionThe Library system provides centralized management for all your media content across game modes.- ✅ **Debug System**: Extensive console logging for task state tracking and troubleshooting

└── videos/                # Linked video directories

```



### 🔧 Development Requirements### 📁 Library Organization### v3.1 - Quick Play Background Video System (November 3, 2025)

- **Node.js 16+**: For Electron desktop application

- **Modern Browser**: Chrome 90+, Firefox 88+, Safari 14+- ✅ **Quick Play Mode**: New fast-start game mode with streamlined interface

- **Desktop Features**: File system access for media linking

- **Storage**: Minimum 100MB for application and user content#### **Video Directories**- ✅ **Background Video Integration**: Independent video system with 46+ videos detected



---- **Automatic Discovery**: Scans linked directories for video files- ✅ **Compact Video Controls**: Floating controls with opacity cycling (hidden/dim/normal/bright)



## 📋 Recent Major Updates- **Format Support**: MP4, WebM, MOV, AVI, and more- ✅ **Video Visibility Toggle**: Quick on/off button with eye icon for instant control



### v4.0 - Comprehensive Backup System (November 12, 2025)- **Smart Indexing**: Automatic categorization and metadata- ✅ **Independent Game Logic**: Isolated Quick Play mode preventing main game interference

- ✅ **Automatic Data Protection**: 30-minute backup intervals

- ✅ **Manual Backup Controls**: User-initiated backup/restore- **Cross-Mode Access**: Available in all game modes- ✅ **Real Task Integration**: Full integration with 17 mainGameData tasks and 60 task images

- ✅ **Export/Import System**: Portable data management

- ✅ **Emergency Backup Hooks**: Before reset operations- ✅ **VideoLibrary Scanning**: Custom video detection system using existing linked directories

- ✅ **Data Loss Recovery**: Complete incident prevention system

#### **Photo Collections**- ✅ **Enhanced Timer System**: Fixed countdown functionality with proper Quick Play isolation

### v3.3 - Media Library Consolidation (November 11, 2025)

- ✅ **Unified Gallery System**: Single media management interface- **Upload System**: High-quality image upload (1600x1200 resolution)

- ✅ **Dynamic Library Theme**: User content-based theming

- ✅ **Pinterest Layout**: Aspect ratio-optimized image display- **Smart Categorization**: Tasks vs Consequences automatic sorting### v3.0 - Professional Media System (October 31, 2025)

- ✅ **Advanced Organization**: Smart categorization and bulk operations

- **Gallery Management**: Pinterest-style layout with aspect ratio optimization- ✅ **Complete Porn Cinema**: Professional video player with playlists, progress bars, and theater mode

### v3.2 - Quick Play Enhancement (November 6, 2025)

- ✅ **Task Disable Toggles**: Individual task control system- **Storage Limits**: 50 image maximum with usage monitoring- ✅ **Multi-Screen Quad Player**: 4-video grid layout for intensive training with minimize/restore functionality

- ✅ **Persistent Settings**: Configuration memory across sessions

- ✅ **Real-time Filtering**: Dynamic task exclusion- ✅ **BaseVideoPlayer Architecture**: Reusable video components across all game modes

- ✅ **Enhanced Debugging**: Comprehensive logging system

### 🔧 Library Features- ✅ **Video Library Integration**: Seamless access to external video directories

### v3.1 - Background Video Integration (November 3, 2025)

- ✅ **Seamless Video Playback**: Background videos during gameplay- ✅ **Player Statistics & Profiles**: Watch time tracking, achievements, and user progression

- ✅ **Opacity Controls**: Floating video control system

- ✅ **40+ Video Integration**: Comprehensive video library access#### **Media Linking**- ✅ **Focus Video Interruptions**: Video overlays during training scenarios

- ✅ **Multi-Mode Support**: Video features across all game modes

```- ✅ **Enhanced Training Integration**: Multi-screen mode button in interactive tasks

---

📁 Linked Directories:

## 🎓 Getting Started Guide

├── /videos/mainstream/     # General video content### v2.0 - Major Content Update

### 1. **First Launch**

   - Run the application via desktop app or open `index.html`├── /videos/specialized/    # Category-specific content  - ✅ Added 7 specialized game modes with rich content

   - Complete the initial setup and library configuration

   - Link your video directories for enhanced experience├── /images/tasks/         # Task-related images- ✅ Implemented progressive endurance training system



### 2. **Library Setup**└── /images/consequences/  # Punishment images- ✅ Enhanced interactive task management

   - Upload task and consequence images via Image Management

   - Link video directories for background content```- ✅ Webcam integration for mirror and photography tasks

   - Organize content for optimal gameplay experience

- ✅ Modular data system for better organization

### 3. **Choose Your Path**

   - **New to Training**: Start with **Quick Play** for immediate access#### **Advanced Management**- ✅ Removed deprecated scenario mode

   - **Structured Learning**: Begin with **Training Academy** scenarios  

   - **Media Focus**: Explore **Porn Cinema** for dedicated viewing- **Bulk Operations**: Select, enable/disable, delete multiple files



### 4. **Progress Tracking**- **Dynamic Themes**: Library theme adapts to your uploaded content### v1.4 - Enhanced Image System

   - Monitor XP growth across all modes

   - Check statistics dashboard for detailed analytics- **Smart Compression**: Optimized storage without quality loss- ✅ Categorized image management (tasks vs consequences)

   - Use player profile to track achievements and milestones

- **Usage Analytics**: Track which content is most accessed- ✅ High-quality compression and processing

---

- ✅ Storage quota management

## 📄 License

#### **Integration Across Modes**- ✅ Bulk operations and selection

This project is licensed under the MIT License - see the LICENSE file for details.

- **Quick Play**: Background video selection and task images

**Note**: This is adult content software intended for personal use by consenting adults. Please use responsibly and in accordance with local laws and regulations.
- **Training Academy**: Scenario content and photo sessions## License

- **Porn Cinema**: Full video library access with playlists

- **Punishment System**: Consequence image selection[Add your preferred license here]

### 📊 Library Analytics
- **📈 Content Usage**: Most viewed/used media tracking
- **💾 Storage Monitoring**: Space usage and optimization suggestions  
- **🔄 Sync Status**: Real-time directory scanning results
- **📋 Content Health**: Missing files and broken links detection

---

## 🎛️ Key Features

### 🔒 Data Protection
- **Automatic Backups**: Every 30 minutes during active sessions
- **Manual Backup/Restore**: Full control over your data
- **Export/Import**: Portable data management
- **Emergency Backups**: Before any reset operations

### 🎨 Customization
- **6 Visual Themes**: Including dynamic Library theme
- **Task Disable Toggles**: Individual control in Quick Play
- **Adaptive Difficulty**: Progressive timer scaling
- **Personal Content**: Upload and organize your media

### 🖥️ Technical Excellence
- **Cross-Platform**: Windows, Mac, Linux support
- **Electron Desktop App**: Native OS integration
- **Web Browser Compatible**: No installation required
- **Professional UI**: Responsive, modern design

---

## 🎯 Controls & Navigation

| Control | Action | Mode Availability |
|---------|--------|-------------------|
| **Enter** | Complete current task | All modes |
| **Ctrl** | Skip task (triggers punishment) | Training, Quick Play |
| **Space/P** | Pause/Resume session | All modes |
| **M** | Toggle background music | All modes |
| **H** | Show help menu | All modes |
| **Escape** | Close dialogs/return to menu | All modes |

---

## 🛠️ Technical Architecture

### 📂 Core Structure
```
webGame/
├── index.html              # Main hub and library management
├── quick-play.html         # Quick Play game mode
├── training-academy.html   # Training Academy mode
├── porn-cinema.html        # Video player system
├── hypno-gallery.html      # Immersive slideshow system
├── player-stats.html       # Statistics dashboard
├── user-profile.html       # Profile and achievements
├── scripts/               # Installation and launch scripts
│   ├── setup.bat          # Windows installer
│   ├── setup.sh           # Mac/Linux installer
│   ├── Start-webgame.bat  # Windows launcher
│   └── create-distribution.* # Distribution builders
├── docs/                  # Documentation and guides
│   ├── HYPNO-GALLERY-README.md # Hypno Gallery documentation
│   ├── INSTALLATION_GUIDE.md   # Setup instructions
│   ├── TESTER_GUIDE.md         # Testing instructions
│   ├── ROADMAP.md             # Development roadmap
│   └── archive/               # Archived documentation
├── src/
│   ├── core/              # Game engine and state management
│   ├── data/modes/        # Game mode configurations
│   ├── features/          # Modular feature systems
│   │   ├── media/         # Video players and media management
│   │   ├── stats/         # XP and statistics tracking
│   │   ├── tasks/         # Interactive task system
│   │   └── ui/            # User interface components
│   ├── styles/            # CSS themes and styling
│   └── utils/             # Utility functions and helpers
├── images/                # User-uploaded image library
├── audio/                 # Background music collection
└── videos/                # Linked video directories
```

### 🔧 Development Requirements
- **Node.js 16+**: For Electron desktop application
- **Modern Browser**: Chrome 90+, Firefox 88+, Safari 14+
- **Desktop Features**: File system access for media linking
- **Storage**: Minimum 100MB for application and user content

---

## 📋 Recent Major Updates

### v4.1 - Critical Stability & Performance Update (November 26, 2025)
- ✅ **Quick Play Session Cleanup**: Complete timer and video cleanup on end session
  - Fixed timers continuing after end session (taskTimer, gameTimerInterval, xpDisplayInterval, recordingTimerInterval)
  - Enhanced video stopping with comprehensive cleanup (pause, mute, reset, clear source)
  - Added debug logging to track timer IDs and video element cleanup
- ✅ **Function Spam Prevention**: Added game state guards to prevent functions running after session ends
  - Guards in syncTaskWithOverlay(), updateRecordingOverlay(), updateTimerDisplay()
  - Checks `!isGameRunning || window.isEndingGame` before execution
  - Eliminated console spam and unnecessary processing
- ✅ **Porn Cinema Memory Leak Fix**: CRITICAL fix preventing crashes from event listener accumulation
  - Changed from individual button listeners to event delegation pattern
  - Single parent listener handles all playlist button clicks via event bubbling
  - Prevents exponential memory growth during extended sessions
- ✅ **Porn Cinema Error Handling**: User-friendly error recovery system
  - Try-catch wrapper for initialization with styled error overlay
  - Retry and home buttons for crash recovery
  - Null checks for missing DOM elements (theater mode buttons)
- ✅ **Porn Cinema Cleanup System**: Comprehensive destroy() method for proper resource cleanup
  - Removes event listeners, stops and unloads videos, clears playlist data
  - Window close handlers (beforeunload, pagehide) trigger automatic cleanup
  - Prevents memory leaks when closing porn cinema window
- ✅ **Enhanced Theme System**: 6 visual themes with dynamic Library theme option
  - Static themes: Hentai, Pornstars, BBC, Feet
  - Dynamic Library theme: Pinterest-style layout using user's personal image collection
  - Theme customization via dropdown in Options menu
  - None option to disable all background images
- ✅ **Desktop Photo Storage**: Webcam photos now saved to file system in desktop app
  - Photos saved to `photos/captured/` directory
  - Organized by session type (training-academy, dress-up, etc.)
  - File-based storage instead of localStorage for better performance
  - Automatic fallback to data URLs in browser mode
  - Photo gallery access with download and management options

### v4.0 - Comprehensive Backup System (November 12, 2025)
- ✅ **Automatic Data Protection**: 30-minute backup intervals
- ✅ **Manual Backup Controls**: User-initiated backup/restore
- ✅ **Export/Import System**: Portable data management
- ✅ **Emergency Backup Hooks**: Before reset operations
- ✅ **Data Loss Recovery**: Complete incident prevention system

### v3.3 - Media Library Consolidation (November 11, 2025)
- ✅ **Unified Gallery System**: Single media management interface
- ✅ **Dynamic Library Theme**: User content-based theming
- ✅ **Pinterest Layout**: Aspect ratio-optimized image display
- ✅ **Advanced Organization**: Smart categorization and bulk operations

### v3.2 - Quick Play Enhancement (November 6, 2025)
- ✅ **Task Disable Toggles**: Individual task control system
- ✅ **Persistent Settings**: Configuration memory across sessions
- ✅ **Real-time Filtering**: Dynamic task exclusion
- ✅ **Enhanced Debugging**: Comprehensive logging system

### v3.1 - Background Video Integration (November 3, 2025)
- ✅ **Seamless Video Playback**: Background videos during gameplay
- ✅ **Opacity Controls**: Floating video control system
- ✅ **40+ Video Integration**: Comprehensive video library access
- ✅ **Multi-Mode Support**: Video features across all game modes

---

## 🎓 Getting Started Guide

### 1. **First Launch**
   - Run the application via desktop app or open `index.html`
   - Complete the initial setup and library configuration
   - Link your video directories for enhanced experience

### 2. **Library Setup**
   - Upload task and consequence images via Image Management
   - Link video directories for background content
   - Organize content for optimal gameplay experience

### 3. **Choose Your Path**
   - **New to Training**: Start with **Quick Play** for immediate access
   - **Structured Learning**: Begin with **Training Academy** scenarios  
   - **Media Focus**: Explore **Porn Cinema** for dedicated viewing

### 4. **Progress Tracking**
   - Monitor XP growth across all modes
   - Check statistics dashboard for detailed analytics
   - Use player profile to track achievements and milestones

---

## 📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

**Note**: This is adult content software intended for personal use by consenting adults. Please use responsibly and in accordance with local laws and regulations.