Skip to content

Latest commit

 

History

History
121 lines (83 loc) · 4.81 KB

README.md

File metadata and controls

121 lines (83 loc) · 4.81 KB

🧩 \\ WinConfigs

WinMacros is a lightweight, customizable script for enhancing Windows productivity with macros and hotkeys. Built using AutoHotkey, it offers quick access to system controls, audio management, shortcuts, and more.

Installation • Configuration • Configuring Audio • Previews • Keybindings

Note

This script works only with AutoHotkey v1.1 (deprecated)

📦 Installation

1. Download the repository

  • Clone this repository or download the ZIP.
git clone https://github.com/fr0st-iwnl/WinMacros.git

2. Download and install AutoHotkey

3. Run the script

  • Double-click the .ahk file to start the script.

4. Optional: Compile

  • Compile the .ahk script into an executable for standalone use and place it in shell:startup to run on startup.

🔧 Configuration

To update the hotkeys:

  1. Open the script in a text editor

    • Right-click on the .ahk file and select Edit Script.

  2. Locate the keybinding variables

    • In the script, you’ll find a section named ;--------[ VARIABLES ]--------.
      Here, keybinding variables are defined, such as:

      fileExplorerKey     := "!e        # Alt + E"

  3. Update the hotkey assignment

    • Change the key combination for any variable to your preferred hotkey.
      For example, to change the File Explorer shortcut from Alt+E to Ctrl+Shift+E, update the variable:

      fileExplorerKey := "^+e       # Ctrl+Shift+E"

  4. Save and reload the script

    • After editing, save the file and reload the script by right-clicking the running AutoHotkey icon in the system tray and selecting Reload Script.

🎤 Configuring Audio and Microphone Devices

To set up audio and microphone muting functionality, follow these steps to configure your device IDs:

Step 1: Find Your Device IDs

  1. Open the FindAudio.ahk file.
  2. Run the script, and it will display the available devices and their corresponding IDs.
  3. Take note of the ID numbers for your mic and audio devices.

Step 2: Update Your Device IDs in the Script

Once you have your device IDs, follow these steps:

  1. Open the WinKeybinds.ahk file in a text editor.

  2. Find the lines containing the following:

    SoundSet, +1, MASTER, mute, 2  ; Replace 2 with your audio device ID <--- IMPORTANT
SoundSet, -1, MASTER, mute, 2  ; Replace 2 with your audio device ID <--- IMPORTANT

SoundSet, +1, MASTER, mute, 3  ; Replace 3 with your audio device ID <--- IMPORTANT
SoundSet, -1, MASTER, mute, 3  ; Replace 3 with your audio device ID <--- IMPORTANT
    • The number 2 and 3 are the default device IDs for your audio/mic device.

  3. Replace all instances of 2 and 3 with the correct ID numbers you found in FindAudio.ahk.

Now, your audio and microphone muting hotkeys will work with your custom devices!

📸 Previews

Keybinds Help FindAudio Power Menu
Keybinds Help FindAudio Power Menu

🎹 Keybindings

Keys Action
Alt+T Open Powershell
Alt+E Open File Explorer
Alt+F Open Default Browser
Alt+G Toggle Taskbar Visibility
Alt+S Hide/Show Desktop Icons
Insert Mute microphone
Pause/Break Mute volume
Alt+Shift+Up Increase Volume
Alt+Shift+Down Decrease Volume
Alt+Backspace Open Power Menu
Ctrl + Alt + R Reload/Restart Script
Alt+Shift+? Open Keybinds Help Menu

🤝 Contributions

Feel free to fork this repository and submit pull requests. Contributions to improve functionality, documentation, or adding features are welcome. For guidelines, please refer to the CONTRIBUTING.md.