summaryrefslogtreecommitdiff
path: root/run-shell/README.md
blob: 9ae7f5de33fa2cb6cd69ef20f5891880983d5acd (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
# Run Shell

Run prompt which is put inside a widget:

[Demo](https://imgur.com/ohjAuCQ.mp4)

## Installation

1. Clone this repo under **~/.config/awesome/**:

    ```bash
    git clone https://github.com/streetturtle/awesome-wm-widgets.git ~/.config/awesome/awesome-wm-widgets
    ```

1. Require 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),