Python AHK Management Application

A desktop application for managing AutoHotkey (AHK) scripts and application shortcuts with a modern GUI, quick-launch toolbar, and script import features. Built with Python and PySide6, this tool helps you organize, launch, and monitor your AHK scripts and related applications efficiently.

Features

• Dark-themed GUI for comfortable use.
• Import AHK scripts: Copy scripts into a managed directory, assign display names, and add descriptions.
• Application shortcuts: Add and launch Windows executables, optionally linking AHK scripts to launch together.
• Custom Quick Toolbar: Floating window for fast launching of selected scripts/apps.
• Status display: See which AHK scripts are currently active.
• Settings dialog: Configure the path to your AutoHotkey executable (uses a vendored version by default).
• Recorder integration: Launch a hotkey recorder (if present).
• Robust error handling and clear user feedback.

Requirements

• Python 3.8+ (Windows recommended)
• No external dependencies required if using the provided lib/ vendored packages (PySide6, pywin32, etc.)
• AutoHotkey: Uses a vendored AHK executable by default, or you can specify your own in Settings.

Getting Started

1. Clone or Download the Repository

   git clone <this-repo-url>
   cd Python_AHK_Management/Python_AHK_Management

2. (Optional) Create a Virtual Environment

   python -m venv venv
   venv\Scripts\activate  # On Windows
   # or
   source venv/bin/activate  # On Linux/Mac (not officially supported)

3. Install Requirements

   If you want to use system packages instead of the vendored lib/, install from requirements.txt:

   pip install -r requirements.txt

   Note: By default, the app uses vendored libraries in lib/ and does not require pip installation.

4. Run the Application

   python hotkey_manager.py

5. Import AHK Scripts

   • Click "Import AHK Script(s)" and select your .ahk files.
   • Assign a display name and (optionally) a description for each script.
   • Scripts are copied to the imported scripts/ directory and managed from there.

6. Add Application Shortcuts

   • Click "Add Application Shortcut" to add Windows executables.
   • Optionally link AHK scripts to launch together with the app.

7. Quick Toolbar

   • Mark scripts/apps with "On Toolbar" to show them in the floating toolbar.
   • Click "Open Quick Toolbar" to launch the toolbar window.

8. Settings

   • Use the "Settings" button to configure the path to your AutoHotkey executable if needed.

Directory Structure

• hotkey_manager.py — Main application GUI
• custom_toolbar.py — Floating quick-launch toolbar
• imported scripts/ — Managed AHK scripts (copied here on import)
• vendor/AutoHotkey/ — Vendored AHK executable
• lib/ — Vendored Python dependencies (PySide6, pywin32, etc.)
• ahk_manager_data.json — Configuration and managed items

Notes

• The application is designed for Windows and expects .ahk scripts and .exe applications.
• If you encounter issues with missing dependencies, ensure you are using the provided lib/ directory or install requirements with pip.
• The app does not delete your original scripts or executables—removal only affects the manager's list.

License

This project is provided as-is for personal use. See included licenses for vendored libraries.