From f65a12034b71e7535b6c567072810768907915f1 Mon Sep 17 00:00:00 2001
From: streetturtle <streetturtle@gmail.com>
Date: Sat, 9 Mar 2019 14:50:47 -0500
Subject: add run shell

---
 run-shell-3/README.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 run-shell-3/README.md

(limited to 'run-shell-3/README.md')

diff --git a/run-shell-3/README.md b/run-shell-3/README.md
new file mode 100644
index 0000000..039a23c
--- /dev/null
+++ b/run-shell-3/README.md
@@ -0,0 +1,34 @@
+# Run Shell
+
+Blurs / pixelates background and shows widget with run prompt:
+
+![screenshot](./blur.png)
+
+![screenshot](./pixelate.png)
+
+## Installation
+
+1. To blur / pixelate the background this widget used [ffmpeg](https://www.ffmpeg.org/) and [frei0r](https://frei0r.dyne.org/) 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
+    ```
+
+1. Clone this repo under **~/.config/awesome/**:
+
+    ```bash
+    git clone https://github.com/streetturtle/awesome-wm-widgets.git ~/.config/awesome/
+    ```
+
+1. Require weather widget at the beginning of **rc.lua**:
+
+    ```lua
+    local run_shell = require("awesome-wm-widgets.run_shell.run_shell")
+    ```
+
+1. Use it (don't forget to comment out the default prompt):
+
+    ```lua
+    awful.key({modkey}, "r", function () run_shell.launch() end),
+    ```
+:warning: I am not 100% sure but it may (memory) leak. If awesome uses lots of RAM just reload config (Ctrl + Mod4 + r).
-- 
cgit v1.2.3