https://github.com/creativecodecat/xwingridselect

https://github.com/creativecodecat/xwingridselect

Last synced: 1 day ago
JSON representation

• Host: GitHub
• URL: https://github.com/creativecodecat/xwingridselect
• Owner: CreativeCodeCat
• License: gpl-3.0
• Created: 2021-04-06T20:01:54.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2022-01-19T08:58:31.000Z (almost 3 years ago)
• Last Synced: 2025-01-08T05:16:31.523Z (7 days ago)
• Language: C
• Size: 221 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
XWinGridSelect

==========

X11 window switcher that draws windows list as a colorful grid

------------------------------------------------------------

Inspired by [XMonad.Actions.GridSelect](http://xmonad.org/xmonad-docs/xmonad-contrib/XMonad-Actions-GridSelect.html), but written in C + GTK+2, uses nice-looking colors and has some set of helpful features.

![xwingridselect's screenshot](/contrib/images/1920x1080_xwingridselect.png "Screenshot")

Use arrow keys (also `C-n`, `C-p`, `C-f`, `C-b` in default mode, `hjkl` in vim mode) or mouse to navigate through windows.

Start typing to search for required window.

Config file is created automatically on a first program run and stored in `~/.config/xwingridselect/config`.

### Usage:

    Usage:

      xwingridselect [OPTION...]  - show X11 windows as color grid

    Help Options:

      -h, --help                   Show help options

      --help-all                   Show all help options

      --help-gtk                   Show GTK+ Options

    Application Options:

      -r, --read-stdin             Read items from stdin (and print selected item to stdout)

      -p, --permissive             Lets search entry text to be used as individual item.

      -t, --format                 Read items from stdin in next format (comma separated):

                                        , , , , .

                                   Icon can be path to png file or icon name from theme.

                                   Any option, except  can be skipped

                                    should be a path to png file or icon name from theme

                                   Any positive value of  allowed.

                                    should be in #nnnnnn format, otherwise it will be skipped.

      -V, --vim-mode               Turn on vim-like navigation (hjkl, search on /)

      -C, --no-colors              Turn off box colorizing

      -I, --no-icons               Turn off showing icons

      -D, --no-desktops            Turn off showing desktop number

      -T, --no-titles              Turn off showing titles

      -S, --screenshot             Get screenshot and set it as a background (for WMs that do not support XShape)

      -P, --at-pointer             Place center of grid at pointer position.

      -s, --selected=           Select box number N at spawn. (default: 0)

      -W, --box-width=        Width of the boxes (default: 200)

      -H, --box-height=       Height of the boxes (default: 40)

      -i, --icon-size=        Size of window icons (default: 16)

      -f, --font="font [size]"     Which font to use for displaying widgets. (default: "Sans 10")

      -o, --hue-offset=       Set color hue offset (from 0 to 255)

      -F, --color-file=      Pick colors from file

      --display=DISPLAY            X display to use

### Dependencies:

* [EWMH compatible Window Manager](http://en.wikipedia.org/wiki/Extended_Window_Manager_Hints)

* GTK+2

* CMake

### Installation:

* ArchLinux: [AUR](https://aur.archlinux.org/packages/xwingridselect/)

Other distributions/development:

	git clone https://github.com/TheCynicalTeam/xwingridselect.git

	cd xwingridselect

	mkdir build

	cd build

	cmake ..

	make

	sudo make install

### Color file format:

	[colors]

	# Use xprop to determine window class

	WindowClass1 = #112233

	WindowClass2 = #445566

	# For other windows to use. You can omit that line and it will use standard colorizing scheme.

	fallback = #f1fa8c; #bd93f9; #ff5555; #6be5fd; #50fa7b; #E6DB74; #F83333; #ffb86c; #8BE9FD; #FF79C6;

### Example shell script

	declare options=("thunar

	xwingridselect

	google-chrome-stable

	lxrandr

	discord

	code

	hexchat

	bitwarden

	quit")

	choice=$(echo -e "${options[@]}" | xwingridselect -r)

	if [ "$choice" = "quit" ];

	then

	    echo "Program terminated." && exit 1

	else

	    exec $choice

	fi