🎥 SilentWitness Screen Recording & Keylogging Suite

A comprehensive Windows-based suite for automated screen recording and keystroke logging using FFmpeg and Python.

🚀 Quick Start

1. Run the main recorder:

   cd Scripts
   python ffmpeg_auto_recorder.py

2. Open the status GUI:

   python recorder_status_gui.py

3. Start keylogging:

   python keylogger.py

📸 Application Screenshots

Main Interface

Main monitoring interface showing recording status and controls

Configuration Options

Recording settings and parameters configuration

System tray icon and notification settings

Logging preferences and output settings

File paths and directory configuration

System Integration

System tray icon with status indicators

Recorded video files management and playback

Command-line interface for advanced users

📁 Project Structure

C:\Tools\SilentWitness\
├── Scripts\                 # Core Python scripts
│   ├── ffmpeg_auto_recorder.py
│   ├── recorder_status_gui.py
│   ├── keylogger.py
│   ├── ini_editor.py
│   ├── startup_manager.py
│   ├── manage_startup.bat
│   └── config.ini
├── ffmpeg\                  # FFmpeg distribution (downloaded by setup)
├── Python\                  # Portable Python environment (downloaded by setup)
├── Recordings\              # Output video files (created by setup)
├── Logs\                    # Application logs (created by setup)
├── Startup\                 # Windows startup shortcuts
│   └── Recorder\
└── User Guide\              # Documentation
    ├── User_Manual_Keylogger_Recorder.md
    └── Screens\             # Application screenshots (8 interface images)

⚙️ Configuration

Edit Scripts\config.ini to customize:

• Recording paths and formats
• Idle detection thresholds
• Logging preferences
• Tray icon settings
• Startup options - Start Menu shortcuts and auto-start configuration

Startup Management

SilentWitness includes powerful startup management features:

• Start Menu Integration - Add shortcuts to Windows Start Menu Programs
• Auto-Start Options - Configure applications to start automatically on login
• Selective Startup - Choose which components start automatically
• User-Specific Setup - Configure startup for specific users

Configure via:

• GUI: python Scripts\ini_editor.py (recommended)
• Command Line: python Scripts\startup_manager.py --help
• Quick Access: Double-click Scripts\manage_startup.bat

📚 Documentation

• User Manual - Complete setup and usage guide
• Build Instructions - How to set up the portable environment
• 📸 Application Screenshots - Visual guide to all features and interfaces
• 🎯 Features - Detailed feature overview with emojis

🔧 Dependencies

• Python 3.12+
• FFmpeg
• See requirements.txt for Python packages

🚀 Quick Setup

Option 1: One-Liner Install (Easiest - No Cloning!)

# Run this single command in PowerShell:
irm https://raw.githubusercontent.com/GoblinRules/silentwitness/main/install_silentwitness.ps1 | iex

What happens:

• Downloads setup script directly from GitHub
• Executes it automatically
• Downloads and extracts the complete SilentWitness repository
• Downloads and installs FFmpeg and Python 3.12
• Installs all Python dependencies
• Sets up everything in C:\Tools\SilentWitness\
• No need to clone or download anything manually!

Option 2: Traditional Setup (Clone First)

1. Download the repository:

   git clone https://github.com/yourusername/silentwitness.git
   cd silentwitness

2. Run the setup script:

   # Double-click setup_silentwitness.bat
   # OR run from PowerShell:
   .\setup_silentwitness.ps1

3. The script will automatically:

   • Download FFmpeg from official sources
   • Download Python 3.12 portable
   • Install all required Python packages
   • Configure paths and environment
   • Create necessary directories

Option 2: Manual Setup

1. Install Python 3.12+
2. Install FFmpeg from gyan.dev
3. Install Python packages:

   pip install -r requirements.txt

4. Copy files to C:\Tools\SilentWitness\
5. Update paths in Scripts\config.ini

🎯 Features

• 🎥 Automated Screen Recording - Start/stop based on user activity with visual status monitoring
• ⌨️ Keystroke Logging - Natural text capture with timestamps and log management
• 🖥️ GUI Management - Visual control and monitoring interface (see screenshots above)
• 🔔 System Tray Integration - Background operation with status indicators and notifications
• ⚙️ Configurable Settings - Easy customization via INI files and GUI editor
• 📊 Real-time Monitoring - Live status updates and recording statistics
• 📁 File Management - Organized recording storage and playback capabilities

📄 License

This project is licensed under a Custom Non-Commercial License.

• ✅ Personal & Educational Use: Allowed freely
• ❌ Commercial Use: Requires permission and licensing
• 📧 Contact: [your-email@domain.com] for commercial inquiries

See LICENSE.md for full terms and conditions.

⚠️ Note

This tool is designed for legitimate monitoring purposes (documentation, debugging, etc.). Ensure compliance with local laws and privacy regulations.