summaryrefslogtreecommitdiff
path: root/run-shell/README.md
blob: ca7b26813079aee511ebf78517b4b9eca078b396 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Run Shell

Blurs background and shows widget with run prompt:

![screenshot](./screenshot.png)

## Installation

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).