awesome-wm-widgets/run-shell-3
streetturtle a0cd854a4d fix more warnings 2020-12-05 20:57:04 -05:00
..
README.md Fix ambiguity in run-shell-3 README 2020-04-25 16:02:55 +01:00
blur.png add run shell 2019-03-09 14:50:47 -05:00
pixelate.png add run shell 2019-03-09 14:50:47 -05:00
run-shell.lua fix more warnings 2020-12-05 20:57:04 -05:00

README.md

Run Shell

Blurs / pixelates background and shows widget with run prompt:

screenshot

screenshot

Installation

  1. To blur / pixelate the background this widget used ffmpeg and frei0r plugins (if you want to pixelate the background), which you need to install. Installation of those depends on your distribution, for ffmpeg just follow the installation section of the site, for frei0r I was able to install it by simply running

    sudo apt-get install frei0r-plugins
    
  2. Clone this repo under ~/.config/awesome/:

    git clone https://github.com/streetturtle/awesome-wm-widgets.git ~/.config/awesome/awesome-wm-widgets
    
  3. Require widget at the beginning of rc.lua:

    local run_shell = require("awesome-wm-widgets.run-shell-3.run-shell")
    
  4. Use it (don't forget to comment out the default prompt):

    awful.key({modkey}, "r", function () run_shell.launch() end),
    

⚠️ I am not 100% sure but it may (memory) leak. If awesome uses lots of RAM just reload config (Ctrl + Mod4 + r).