tsoding/boomer

Boomer

Zoomer application for Linux.

• Development is done on https://twitch.tv/tsoding
• Archive of the streams: https://www.twitch.tv/collections/HlRy-q69uBXmpQ

Dependencies

Debian

$ sudo apt-get install libgl1-mesa-dev libx11-dev libxext-dev libxrandr-dev

Quick Start

$ nimble build
$ ./boomer --help
$ ./boomer          # to just start using

Developer Capabilities

For additional Developer Capabilities compile the application with the following flags:

$ nimble build -d:developer

This will enable reloading the shaders with Ctrl+R. The shader files (frag.glsl and vert.glsl) should be located in the same folder as boomer.nim for this feature to work. If the shader files not found the program won't even start.

Keep in mind that the developer build is not suitable for day-to-day usage because it creates the external dependency on the shader files. Compiling the program without -d:developer "bakes" the shaders into the executable and eliminates the dependency.

Controls

Configuration

Configuration file is located at $HOME/.config/boomer/config and has roughly the following format:

<param-1> = <value-1>
<param-2> = <value-2>
# comment
<param-3> = <value-3>

You can generate a new config at $HOME/.config/boomer/config with $ boomer --new-config.

Supported parameters:

Experimental Features Compilation Flags

Experimental or unstable features can be enabled by passing the following flags to nimble build command:

NixOS Overlay

$ git clone git://github.com/tsoding/boomer.git /path/to/boomer
$ mkdir -p ~/.config/nixpkgs/overlays
$ cd ~/.config/nixpkgs/overlays
$ ln -s /path/to/boomer/overlay/ boomer
$ nix-env -iA nixos.boomer

References

• https://github.com/nim-lang/x11/blob/bf9dc74dd196a98b7c2a2beea4d92640734f7c60/examples/x11ex.nim
• http://archive.xfce.org/src/xfce/xfwm4/4.13/
• https://www.khronos.org/opengl/wiki/Programming_OpenGL_in_Linux:_GLX_and_Xlib
• https://www.khronos.org/registry/OpenGL-Refpages/gl2.1/xhtml/glXIntro.xml
• https://stackoverflow.com/questions/24988164/c-fast-screenshots-in-linux-for-use-with-opencv
• https://github.com/lolilolicon/xrectsel
• https://github.com/naelstrof/slop
• https://www.x.org/releases/X11R7.7/doc/xextproto/shm.html
• http://netpbm.sourceforge.net/doc/ppm.html
• https://github.com/def-/nim-syscall
• https://github.com/dreamer/scrot

Support

You can support my work via

• Twitch channel: https://www.twitch.tv/subs/tsoding
• Patreon: https://www.patreon.com/tsoding