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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
.TH ROFI\-SCRIPT 5 rofi\-script
.SH NAME
.PP
\fBrofi script mode\fP \- Rofi format for scriptable modi.
.SH DESCRIPTION
.PP
\fBrofi\fP supports modes that use simple scripts in the background to generate a list and process the result from user
actions. This provide a simple interface to make simple extensions to rofi.
.SH USAGE
.PP
To specify a script mode, set a mode with the following syntax: "{name}:{executable}"
.PP
For example:
.PP
.RS
.nf
rofi \-show fb \-modi "fb:file\_browser.sh"
.fi
.RE
.PP
The name should be unique.
.SH API
.PP
Rofi calls the executable without arguments on startup. This should generate a list of options, separated by a newline
(\fB\fC\\n\fR) (This can be changed by the script).
If the user selects an option, rofi calls the executable with the text of that option as the first argument.
If the script returns no entries, rofi quits.
.PP
A simple script would be:
.PP
.RS
.nf
#!/usr/bin/env bash
if [ x"$@" = x"quit" ]
then
exit 0
fi
echo "reload"
echo "quit"
.fi
.RE
.PP
This shows two entries, reload and quit. When the quit entry is selected, rofi closes.
.SH Environment
.PP
Rofi sets the following environment variable when executing the script:
.SS \fB\fCROFI\_RETV\fR
.PP
An integer number with the current state:
.IP \(bu 2
\fB0\fP: Initial call of script.
.IP \(bu 2
\fB1\fP: Selected an entry.
.IP \(bu 2
\fB2\fP: Selected a custom entry.
.IP \(bu 2
\fB10\-28\fP: Custom keybinding 1\-19
.SH Passing mode options
.PP
Extra options, like setting the prompt, can be set by the script.
Extra options are lines that start with a NULL character (\fB\fC\\0\fR) followed by a key, separator (\fB\fC\\x1f\fR) and value.
.PP
For example to set the prompt:
.PP
.RS
.nf
echo \-en "\\0prompt\\x1fChange prompt\\n"
.fi
.RE
.PP
The following extra options exists:
.IP \(bu 2
\fBprompt\fP: Update the prompt text.
.IP \(bu 2
\fBmessage\fP: Update the message text.
.IP \(bu 2
\fBmarkup\-rows\fP: If 'true' renders markup in the row.
.IP \(bu 2
\fBurgent\fP: Mark rows as urgent. (for syntax see the urgent option in dmenu mode)
.IP \(bu 2
\fBactive\fP: Mark rows as active. (for syntax see the active option in dmenu mode)
.IP \(bu 2
\fBdelim\fP: Set the delimiter for for next rows. Default is '\\n' and this option should finish with this. Only call this on first call of script, it is remembered for consecutive calls.
.SH Parsing row options
.PP
Extra options for individual rows can be set.
The extra option can be specified following the same syntax as mode option, but following the entry.
.PP
For example:
.PP
.RS
.nf
echo \-en "aap\\0icon\\x1ffolder\\n"
.fi
.RE
.PP
The following options are supported:
.IP \(bu 2
\fBicon\fP: Set the icon for that row.
.IP \(bu 2
\fBmeta\fP: Specify invisible search terms.
.IP \(bu 2
\fBnonselectable\fP: If true the row cannot activated.
.SH SEE ALSO
.PP
rofi(1), rofi\-sensible\-terminal(1), dmenu(1), rofi\-theme(5), rofi\-theme\-selector(1)
.SH AUTHOR
.PP
Qball Cow
\[la]qball@gmpclient.org\[ra]
.PP
Rasmus Steinke
\[la]rasi@xssn.at\[ra]
.PP
Quentin Glidic
\[la]sardemff7+rofi@sardemff7.net\[ra]
.PP
Original code based on work by: Sean Pringle
\[la]sean.pringle@gmail.com\[ra]
.PP
For a full list of authors, check the AUTHORS file.
|
