Repository files navigation

slop (Select Operation) is an application that queries for a selection from the user and prints the region to stdout.

• Hovering over a window will cause a selection rectangle to appear over it.
• Clicking on a window makes slop return the dimensions of the window, and it's ID.
• OpenGL accelerated graphics where possible.
• Supports simple arguments:
  • Change selection rectangle border size.
  • Select X display.
  • Set padding size.
  • Force window, or pixel selections with the tolerance flag.
  • Set the color of the selection rectangles to match your theme! (Even supports transparency!)
  • Remove window decorations from selections.
• Supports custom programmable shaders.
• Move started selection by holding down the space bar.

slop can be used to create a video recording script in only three lines of code.

#!/bin/bashslop=$(slop -f"%x %y %w %h %g %i")||exit 1read -r X Y W H G ID<<<$slopffmpeg -f x11grab -s"$W"x"$H" -i :0.0+$X,$Y -f alsa -i pulse~/myfile.webm

You can also take images using imagemagick like so:

#!/bin/bashslop=$(slop -f"%g")||exit 1read -r G<<<$slopimport -window root -crop$G~/myimage.png

Furthermore, if you are adventurous, you can create a simple script to copy things from an image itself, unselectable pdf, or just VERY quick rectangular selection or for places where there is no columnar selection (very useful for dataoperators)

You need to have tesseract with support for the specific language, xclip and others are nice if you just want them in clipboard.

#!/bin/env bashimagefile="/tmp/sloppy.$RANDOM.png"text="/tmp/translation"echo"$imagefile"slop=$(slop -f"%g")||exit 1read -r G<<<$slopimport -window root -crop$G$imagefiletesseract$imagefile$text2>/dev/null cat$text".txt"| xclip -selection c

If you don't like ImageMagick's import: Check outmaim for a better screenshot utility.

Ok. Here's a comparison between 'scrot -s's selection and slop's:

You can see scrot leaves garbage lines over the things you're trying to screenshot!While slop not only looks nicer, it's impossible for it to end up in screenshots or recordings because it waits for DestroyNotify events before completely shutting down. Only after the window is completely destroyed can anything take a screenshot.

• Arch Linux: extra/slop
• Void Linux: slop
• FreeBSD: x11/slop
• NetBSD: x11/slop
• OpenBSD: graphics/slop
• Gentoo: x11-misc/slop
• NixOS: slop
• GNU Guix: slop
• Debian: slop
• Ubuntu: slop
• Fedora: slop
• Red Hat Enterprise Linux (via EPEL): slop
• CentOS Stream and similar (via EPEL): slop
• Ravenports: slop
• Alpine Linux: community/slop
• Please make a package for slop on your favorite system, and make a pull request to add it to this list.

Note: Dependencies should be installed first: libxext, glew, and glm.

git clone https://github.com/naelstrof/slop.gitcd slopcmake -DCMAKE_INSTALL_PREFIX="/usr" ./make&& sudo make install

Slop allows for chained post-processing shaders. Shaders are written in a language called GLSL, and have access to the following data from slop:

The desktop texture is upside-down because flipping it would cost valuable time.

Shaders must be placed in your${XDG_CONFIG_HOME}/slop directory, whereXDG_CONFIG_HOME is typically~/.config/. This folder won't exist unless you make it yourself.

Shaders are loaded from the--shader flag in slop. They are delimited by commas, and rendered in order from left to right. This way you can combine multiple shaders for interesting effects! For example,slop -rblur1,wiggle would load~/.config/slop/blur1{.frag,.vert} and~/.config/slop/wiggle{.frag,.vert}. Then render the selection rectangle twice, each time accumulating the changes from the different shaders.

Enough chatting about it though, here's some example shaders you can copy fromshaderexamples to~/.config/slop to try out!

The files listed to the right of the| are the required files for the command to the left to work correctly.

• slop -r blur1,blur2 -b 100 |~/.config/slop/{blur1,blur2}{.frag,.vert}

• slop -r wiggle -b 10 |~/.config/slop/wiggle{.frag,.vert}

And all together now...

• slop -r blur1,blur2,wiggle -b 50 -c 1,1,1 |~/.config/slop/{blur1,blur2,wiggle}{.frag,.vert}

Finally here's an example of a magnifying glass.

• slop -r crosshair |~/.config/slop/crosshair{.frag,.vert}

It's fairly easy to adjust how the shaders work by editing them with your favourite text editor. Or even make your own!