summaryrefslogtreecommitdiff
path: root/README.md
blob: b817d26062fbb62dc88c7eb3720d2375dced1e90 (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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# dmenu

A `dmenu`-like extension for Raycast.

Inspired by [this orange website commenter](https://news.ycombinator.com/item?id=40606300).

## Usage

1. [Install the extension.](#installation)
2. Download the [dmenu_raycast](./dmenu_raycast) script and put it somewhere in your `$PATH`
3. Run something like `printf 'one\ntwo\nthree' | dmenu_raycast`

`dmenu_raycast` will either print the selected item to stdout, or exit 0 if the user cancelled without selecting an item.

[![Screencast](./screencast.gif)](./screencast.mp4)

Whitespace is stripped, but this might change in the future once I check if `dmenu` also does that lol.

**TODO:** `-p` (prompt) support

## Installation

From source:

```shell
git clone https://github.com/irth/dmenu_raycast
cd dmenu_raycast
npm install
npx ray build -e dist -o dist
open raycast://extensions/raycast/developer/import-extension
```

In Raycast, navigate to the "dist" that `npx ray build -e dist -o dist` created
and choose it.

Now, link the `dmenu_raycast` script to somewhere in your `$PATH`, for example

```
sudo ln -s $(pwd)/dmenu_raycast /usr/local/bin/
```

or

```
ln -s $(pwd)/dmenu_raycast ~/.local/bin
```