WinQL is a lightweight, highly customizable Windows taskbar utility built with PowerShell and C#. It brings shortcuts, system controls, window management, application launching, and adaptive media controls directly to your Windows taskbar.
Designed to stay out of your way while remaining instantly accessible, WinQL lets you build a taskbar workflow tailored to the way you use your PC.
Current Version:
v1.0.0Built With: PowerShell + C#
WinQL provides an intelligent media control system that automatically detects and interacts with active media sessions.
- Integrates with Windows System Media Transport Controls (SMTC).
- Displays:
- Currently playing track
- Artist
- Album artwork
- Browser support includes:
- Chrome
- Microsoft Edge
- Firefox
- Brave
- Opera
- Zen
- Automatically switches to the player that starts playing a new track.
- Use Middle-Click to cycle between active media sessions.
Turn your taskbar into a personalized command center.
- Configure up to 10 custom taskbar buttons.
- Assign a custom single-character icon or label to each button.
- Each button can have completely independent actions.
Every button can respond differently depending on how you interact with it. Supported inputs:
- Left Click
- Left Double-Click
- Right Click
- Right Double-Click
- Middle Click This allows a single taskbar button to perform multiple functions without taking up additional space.
WinQL includes a broad collection of actions for everyday Windows workflows.
- Toggle Wi-Fi
- Toggle Bluetooth
- Adjust volume
- Adjust brightness
- Back
- Forward
- Copy
- Cut
- Paste
- Launch applications
- Open websites
- Execute PowerShell scripts
- Execute CMD commands
- Run scripts visibly or silently
- Switch to open windows
- Terminate processes
- Change wallpapers
- Toggle Windows Light/Dark mode
Customize WinQL to match your desktop and workflow. Available options include:
- Taskbar alignment:
- Left
- Center
- Right
- Element spacing
- Button hitboxes
- Fonts
- Text and UI colors
- Automatic Windows theme synchronization
Your entire WinQL configuration can be exported and imported through settings.json.
This makes it easy to:
- Back up your configuration
- Move your setup to another PC
- Restore your preferred workflow
- Share configurations
Before installing WinQL, make sure you have:
- Windows 10 or Windows 11
- PowerShell
- Administrator privileges
The installer will request administrator privileges automatically when required.
- Open terminal(powershell) as administrator
- Enter the following command
irm "https://raw.githubusercontent.com/avm3005/WinQL/main/Setup/setup.ps1" | iex - The installer will:
- Remove previous WinQL installations when applicable.
- Set up the required components.
- Compile required assets.
- Configure taskbar integration.
- Launch WinQL. Once installation is complete, WinQL will appear on your taskbar.
WinQL provides multiple interaction methods for controlling your currently playing media.
| Action | Function |
|---|---|
| Left Click | Play / Pause |
| Left Double-Click | Bring the media application to the foreground |
| Middle Click | Cycle between active media sessions |
| Right Click | Temporarily hide the media player |
| Action | Function |
|---|---|
| Left Click | Play / Pause |
| Left Double-Click | Previous Track |
| Right Double-Click | Next Track |
| Middle Click | Cycle between active media sessions |
| Right Click | Temporarily hide the media player |
When the media player is hidden, a small pin remains available to restore it.
WinQL can be configured entirely through its settings interface.
Right-click the WinQL system tray icon in the bottom-right corner of Windows and select Settings.
Navigate to: Button Actions → Buttons From here you can:
- Enable between 1 and 10 buttons.
- Assign an icon or one-character label to each button.
Open the Clicks sub-tab. Enable whichever interactions you want to use:
- Left Click
- Left Double-Click
- Right Click
- Right Double-Click
- Middle Click
Open the Actions sub-tab and use the Action Builder to determine what each interaction does. For example:
Button 1
├── Left Click → Open Spotify
├── Left Double-Click → Play/Pause
├── Right Click → Next Track
└── Middle Click → Open Music Folder
This allows a single button to become a compact multi-purpose shortcut.
WinQL stores its configuration in:
settings.json
Use the built-in Export and Import functionality to back up or restore your setup.
WinQL includes its own cleanup process.
To uninstall:
- Open Windows Settings.
- Go to Apps → Installed apps.
- Search for WinQL.
- Click Uninstall.
The uninstaller will clean up WinQL's associated:
- Registry entries
- Scheduled tasks
- Application data
- Installation files
Potential future improvements may include:
- Additional media-player integrations
- More Windows system controls
- Additional taskbar customization
- More automation actions
- Expanded configuration options
- Additional media metadata providers
- If-else scripts
Contributions, bug reports, and feature requests are welcome. If you find a problem:
- Check the existing issues.
- Create a new issue if the problem has not already been reported.
- Include:
- Windows version
- WinQL version
- Steps to reproduce
- Expected behavior
- Actual behavior
- Relevant screenshots or logs For feature requests, describe the problem you're trying to solve and how you would like WinQL to behave.
Created by Detaroxz. If you encounter a bug or want to request a feature, use the integrated options in the About tab of the WinQL settings to get in touch.
Made for Windows users who want more from their taskbar.