winner - a alt+tab alternative for windows
==========================================

description
-----------
winner is a lightweight alt+tab alternative for windows, written in c using winapi.
winner shows an overlay with all open windows, lets you filter them by typing part of the title, and switch quickly using a configurable hotkey.

features
--------
- lightweight, fast, no dependencies
- configurable hotkey (default: ctrl+alt+q)
- windows 11 native look
- configurable ui 
- dpi aware rendering

installation
------------
1. download the latest release from github (github.com/misopog/winner/releases)
3. extract the zip file into a folder (e.g. C:\winner)
4. configure settings in winner.ini 
5. run winner.exe
6. (optional) make a shortcut to winner.exe in shell:startup if you want it to start automatically on login

configuration
-------------
the configuration file winner.ini is located in the same folder as winner.exe (or the root of the git repo). it contains the following settings:

```
[general]
hotkey_mod=ctrl+alt ; modifier keys for the hotkey 
hotkey_key=q ; key for the hotkey
; debug=1 ; enable debug mode (opens a console for logging)

[ui]
width=900 ; width of the overlay
padding=14 ; padding around the items
item_spacing=18 ; outer spacing 
icon_size=16 ; size of the window icons
font_size=16 ; size of the font
font_name=Segoe UI Variable ; font name for the text

[colors]
bg=#202024 ; background color of the overlay
sel=#FFFFFF ; color of the selected item
text=#A0A0A0 ; color of the text
text_sel=#A0A0A0 ; color of the text of the selected item
match=#FFFFFF ; color of the matched text
```

usage
-----
- to use winner, press the configured hotkey (default: ctrl+alt+q)
- this will show the overlay with all open windows. 
- you can start typing to filter the list by window title.
- use the arrow keys to navigate through the list and press enter to switch to the selected window.
- press escape to close the overlay without switching.
- right click the tray icon to quit or left click to toggle the overlay.

note
---- 
- you can provide your own icon for the tray icon by placing a file named icon.ico in the same folder as winner.exe.
- for now there is a pure white icon, if you want to contribute a better one, please open a pull request on github.

build
-----
- use the provided build.bat script to build the project
- it requires msvc, before running the script, make sure to set your vcvarsall location in the script
- the script will compile tabber.exe and tabber.ini into bin/

license
-------
gplv3