Skip to content

README.md

Latest commit

 

History

History
144 lines (104 loc) · 4.49 KB

README.md

File metadata and controls

144 lines (104 loc) · 4.49 KB
Raw

Window Arranger

A window arrangement tool for Windows 11 that can move specified windows to specified monitors.

Features

  • Configurable hotkey for automatic window arrangement (default: Ctrl+Alt+I)
  • Move Opera and "RD Tabs" windows to Monitor 1 (left)
  • Move all other windows to Monitor 2 (right, primary monitor)
  • Support for custom configuration
  • Automatic hotkey re-registration for long-running stability
  • Manual hotkey reload for Remote Desktop compatibility issues
  • CMD window input support for hotkey reload when hotkeys are not working

Usage

First Time Setup

  1. Double-click setup_and_run.bat
  2. Wait for virtual environment setup and dependency installation
  3. After program starts, press Ctrl+Alt+I to arrange windows

Regular Usage

Double-click run.bat to start the program

Hotkeys

  • Ctrl+Alt+I - Arrange windows
  • Ctrl+Alt+Q - Exit program
  • Ctrl+Alt+U - Manually reload hotkeys (useful after Remote Desktop connections)

Manual Hotkey Reload via CMD

If hotkeys stop working (e.g., after Remote Desktop connections):

  1. Make sure the CMD window running the script is active/focused
  2. Press Ctrl+R in the CMD window
  3. The script will detect this input and re-register all hotkeys

After Copying to New Location

If you copy the entire directory to a new location, run setup_and_run.bat directly, it will automatically:

  • Check if virtual environment is valid
  • Recreate if invalid
  • Reinstall dependencies

After Adding to System PATH

If you've added the directory to system environment variable PATH, you can execute from any location:

  • run.bat - Automatically switches to script directory
  • setup_and_run.bat - Automatically switches to script directory

Note: All batch files automatically switch to the script directory to ensure virtual environment and dependency files can be found correctly.

File Description

  • window_arranger.py - Main Python script
  • monitor_detector.py - Monitor information detection script
  • requirements.txt - Python dependency package list
  • setup_and_run.bat - First-time setup and run script
  • run.bat - Quick start script (automatically detects and fixes virtual environment issues)
  • config.json - Configuration file (customizable hotkeys, etc.)
  • config_example.json - Configuration example file

Requirements

  • Windows 11 system
  • Python 3.7+
  • Program runs in background, listening for hotkeys
  • Press Ctrl+Alt+Q to exit program

Configuration

Hotkey Configuration

You can customize hotkeys in the config.json file:

{
    "hotkey": "ctrl+alt+i",
    "exit_hotkey": "ctrl+alt+q",
    "reload_hotkey": "ctrl+alt+u"
}

Supported hotkey formats:

  • ctrl+alt+i - Ctrl+Alt+I
  • ctrl+shift+a - Ctrl+Shift+A
  • f12 - F12 key
  • ctrl+1 - Ctrl+1

Application Configuration

You can configure which applications move to which monitor:

{
    "monitor_1_apps": ["opera", "RD Tabs"],
    "monitor_2_apps": ["*"]
}
  • monitor_1_apps: List of applications to move to Monitor 1
  • monitor_2_apps: List of applications to Monitor 2 (* means all other applications)

Note: Applications not in monitor_1_apps will automatically be moved to Monitor 2.

Advanced Configuration

Additional configuration options for advanced users:

{
    "hotkey_test_interval": 1800,
    "log_level": "INFO"
}
  • hotkey_test_interval: Interval in seconds for hotkey health checks (default: 1800 = 30 minutes)
  • log_level: Logging level - can be "DEBUG", "INFO", "WARNING", or "ERROR" (default: "INFO")

Troubleshooting

Hotkey Not Working

  • Check if the program is running and visible in terminal
  • The program automatically re-registers hotkeys every 30 minutes
  • After Remote Desktop connections: Press Ctrl+Alt+U to manually reload hotkeys
  • If all hotkeys fail: Use Ctrl+R in the CMD window to reload hotkeys

Remote Desktop Issues

  • Symptom: Hotkeys stop working after using Remote Desktop from macOS
  • Cause: Remote Desktop may modify keyboard state or hotkey registrations
  • Solution:
    • First try: Press Ctrl+Alt+U to manually reload all hotkeys
    • If that doesn't work: Press Ctrl+R in the CMD window
  • Prevention: Always reload hotkeys after Remote Desktop sessions

Virtual Environment Issues

  • Run setup_and_run.bat to recreate the virtual environment
  • Don't move or delete the venv folder

Window Arrangement Not Working

  • Ensure target applications (Opera, RD Tabs) are running
  • Check that applications are visible and not minimized