Skip to content

joganubaid/pip-controller-pro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

20 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

PiP Controller Pro v2.1.0

๐ŸŽฌ Professional Picture-in-Picture Window Controller

A powerful Windows utility that enhances your Picture-in-Picture experience with automatic transparency, click-through functionality, and professional system tray integration.

License: MIT Platform: Windows AutoHotkey

PiP Controller Pro

๐Ÿ†• What's New in v2.1.0

  • ๐Ÿ’พ Settings Persistence: All settings automatically saved and restored between sessions
  • ๐Ÿš€ Auto-Start Support: Option to start with Windows automatically
  • ๐Ÿ“Š Enhanced Status Dashboard: Real-time monitoring with detailed window information
  • ๐Ÿ”ง Improved Edge Compatibility: Better detection and handling of Microsoft Edge PiP windows
  • ๐Ÿ”„ Reset Options: Multiple reset levels for troubleshooting
  • ๐ŸŽฏ Smart Detection: Enhanced PiP window detection with fallback methods
  • โšก Performance Optimizations: Better error handling and resource management

โœจ Features

  • Automatic transparency: Makes PiP windows semi-transparent when mouse hovers over them
  • Click-through: Allows clicking through the PiP window to interact with content behind it
  • Shift override: Hold Shift key to make the window fully opaque and interactive
  • Multi-browser support: Works with Chrome and Microsoft Edge
  • Settings persistence: All preferences saved automatically
  • Auto-start option: Start with Windows automatically
  • Professional system tray: Complete control from your system tray
  • Status dashboard: Real-time monitoring and diagnostics
  • Multiple transparency presets: 6 preset levels from almost invisible to opaque
  • Response speed control: 5 performance levels from ultra fast to slow
  • Browser tools: Test and reset PiP windows for troubleshooting
  • Hotkeys: Quick access to all features

๐Ÿ“ฅ Download & Install

๐Ÿ”ง Option 1: Portable Version (RECOMMENDED)

File: PiPControllerPro-v2.1.0-Portable.zip (~3 MB)

โœ… Choose this if you want:

  • No installation required
  • Complete package with documentation
  • Run from anywhere (USB drive, desktop, etc.)
  • Easy to share or backup
  • Settings saved to user profile

๐Ÿ“ฅ How to use:

  1. Click the download link above
  2. Extract the ZIP file anywhere
  3. Run pip-controller.exe
  4. Done! No installation needed

๐Ÿ“ Option 2: Direct Executable

File: pip-controller.exe (~1.2 MB)

โœ… Choose this if you want:

  • Single file download
  • Just the executable
  • Quick and simple
  • Minimal download size

๐Ÿ“ฅ How to use:

  1. Click the download link above
  2. Save the file anywhere
  3. Double-click to run
  4. Done! Ready to use

๐Ÿš€ Quick Start Guide

After installing or extracting:

  1. Launch the app - It will appear in your system tray
  2. Right-click the tray icon โ†’ Access all settings and options
  3. Open Chrome or Edge and play any video (YouTube, Netflix, etc.)
  4. Right-click the video โ†’ Select "Picture in picture"
  5. Hover over the PiP window โ†’ Watch it become transparent! โœจ
  6. Hold Shift while hovering โ†’ Makes it fully opaque and clickable
  7. Use Ctrl+Alt+C โ†’ Open Status Dashboard for monitoring

๐ŸŽฎ Hotkeys

  • Ctrl+Alt+C - Open Status Dashboard
  • Ctrl+Alt+P - Pause/Resume transparency
  • Ctrl+Alt+X - Exit application

๐ŸŽฏ System Tray Features

๐Ÿ“Š Status Dashboard

  • Real-time monitoring of PiP windows
  • Current settings and status
  • Window information and diagnostics
  • Quick access via Ctrl+Alt+C or tray menu

๐ŸŽจ Quick Transparency

  • Almost Invisible (25) - Very transparent
  • Very Light (64) - Light transparency
  • Medium (128) - Balanced transparency
  • Default (179) - Recommended setting
  • Slight (230) - Minimal transparency
  • Opaque (255) - No transparency

โšก Response Speed

  • Ultra Fast (10ms) - Maximum responsiveness
  • Very Fast (25ms) - High performance
  • Fast (50ms) - Recommended setting
  • Normal (100ms) - Balanced performance
  • Slow (200ms) - Lower CPU usage

๐Ÿ”ง Browser Tools

  • Test Chrome PiP - Check Chrome detection
  • Test Edge PiP - Check Edge detection
  • Show All Windows - Debug window list
  • Reset All PiP - Reset all PiP windows

๐Ÿ”„ Reset Options

  • Reset Current PiP - Reset active window
  • Reset All PiP Windows - Reset all windows
  • Reset All Settings - Factory defaults

๐Ÿ› ๏ธ Build Options (For Developers)

We provide a single, powerful build script:

# Build everything (Installer and Portable - Recommended)
.\build.ps1 -BuildAll

# Build only the portable ZIP
.\build.ps1 -BuildPortable

# Build only the installer
.\build.ps1 -BuildInstaller

๐Ÿ“ Settings & Configuration

Settings File Location

Settings are automatically saved to: %AppData%\PiPController\settings.ini

Manual Configuration

You can modify these settings in the pip-controller.ahk file:

transparency := 179       ; Default transparency (0-255, where 0 is invisible)
checkInterval := 50       ; How often to check mouse position (milliseconds)
isEnabled := true         ; Whether the script is enabled
autoStart := false        ; Whether to start with Windows

๐Ÿ”ง How It Works

  1. The script continuously monitors mouse position
  2. When mouse hovers over a Picture-in-Picture window:
    • If Shift is NOT pressed: Makes window semi-transparent and click-through
    • If Shift IS pressed: Makes window fully opaque and interactive
  3. When mouse moves away: Restores window to normal state
  4. All settings are automatically saved and restored

๐ŸŒ Browser Support

  • โœ… Google Chrome - Full support with enhanced detection
  • โœ… Microsoft Edge - Full support with improved compatibility
  • โ“ Firefox - May work with modifications (not tested)

๐Ÿ› Troubleshooting

PiP Window Not Detected

  • Use Browser Tools โ†’ Test Chrome PiP or Test Edge PiP
  • Try Show All Windows to see available windows
  • Restart the script after opening PiP mode
  • Check if the window title contains "Picture-in-picture"

Script Not Working

  • Check if AutoHotkey is installed properly
  • Run as administrator if needed
  • Ensure no other AutoHotkey scripts are interfering
  • Use Reset All PiP to clear any stuck states

Settings Issues

  • Use Reset All Settings to restore defaults
  • Check settings file at: %AppData%\PiPController\settings.ini
  • Restart the application after changing settings

Build Fails

  • Make sure you have internet connection for AutoHotkey download
  • Run PowerShell as administrator
  • Check Windows Defender/antivirus isn't blocking the compilation

๐Ÿ“‹ System Requirements

  • OS: Windows 10/11 (Windows 7/8 may work)
  • Memory: Minimal (< 15 MB RAM usage)
  • Permissions: No administrator rights required
  • Browsers: Chrome, Edge (Firefox may work with modifications)

๐Ÿ“ Files

  • pip-controller.ahk - Main AutoHotkey script
  • build.ps1 - Master build script
  • installer.iss - Inno Setup installer script
  • pip-controller.exe - Compiled executable (after build)
  • README.md - This documentation
  • LICENSE.txt - MIT License

๐Ÿค Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

Development Setup

  1. Fork the repository
  2. Install AutoHotkey v1.1+
  3. Run .\build.ps1 -InstallAHK -Build
  4. Test thoroughly on Windows 10/11
  5. Submit a pull request

๐Ÿ“„ License

Free to use and modify for personal and commercial purposes under the MIT License.

๐Ÿ†˜ Support

  • Issues: Report at GitHub Issues
  • Documentation: See README.md included with download
  • License: MIT License - free for personal and commercial use

Enjoy your enhanced Picture-in-Picture experience! ๐ŸŽฌ

About

๐ŸŽฌ Professional Picture-in-Picture Window Controller for Windows with automatic transparency and click-through functionality

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors