mirror of
https://github.com/davatorium/rofi.git
synced 2024-11-18 13:54:36 -05:00
Add hide scrollbar option.
This commit is contained in:
parent
465d027c1e
commit
e10aa09f74
8 changed files with 233 additions and 312 deletions
|
@ -132,8 +132,13 @@ Settings config = {
|
||||||
.fuzzy = FALSE,
|
.fuzzy = FALSE,
|
||||||
/** Monitor */
|
/** Monitor */
|
||||||
.monitor = -1,
|
.monitor = -1,
|
||||||
|
/** set line margin */
|
||||||
.line_margin = 2,
|
.line_margin = 2,
|
||||||
|
/** Set filter */
|
||||||
.filter = NULL,
|
.filter = NULL,
|
||||||
|
/** Separator style: dash/solid */
|
||||||
.separator_style = "dash",
|
.separator_style = "dash",
|
||||||
|
/** Hide scrollbar */
|
||||||
|
.hide_scrollbar = FALSE,
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|
|
@ -326,6 +326,10 @@ Set separator style. Possible options are "solid" or "dash".
|
||||||
|
|
||||||
Default: *dash*
|
Default: *dash*
|
||||||
|
|
||||||
|
`-hide-scrollbar`
|
||||||
|
|
||||||
|
Hide the scrollbar.
|
||||||
|
|
||||||
### Layout
|
### Layout
|
||||||
|
|
||||||
`-lines`
|
`-lines`
|
||||||
|
|
357
doc/rofi.1
357
doc/rofi.1
|
@ -1,7 +1,7 @@
|
||||||
.\" generated with Ronn/v0.7.3
|
.\" generated with Ronn/v0.7.3
|
||||||
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
||||||
.
|
.
|
||||||
.TH "ROFI\-MANPAGE" "" "August 2015" "" ""
|
.TH "ROFI\-MANPAGE" "" "September 2015" "" ""
|
||||||
.
|
.
|
||||||
.SH "NAME"
|
.SH "NAME"
|
||||||
\fBrofi\fR \- A window switcher, run launcher, ssh dialog and dmenu replacement
|
\fBrofi\fR \- A window switcher, run launcher, ssh dialog and dmenu replacement
|
||||||
|
@ -16,7 +16,7 @@
|
||||||
\fBrofi\fR can be used in three ways, single\-shot; executes once and directly exits when done, as a daemon listening to specific key\-combination or emulating dmenu\.
|
\fBrofi\fR can be used in three ways, single\-shot; executes once and directly exits when done, as a daemon listening to specific key\-combination or emulating dmenu\.
|
||||||
.
|
.
|
||||||
.SS "Single\-shot mode"
|
.SS "Single\-shot mode"
|
||||||
To launch \fBrofi\fR directly in a certain mode, specifying \fBrofi \-show <mode>\fR\. To show the run dialog:
|
To launch \fBrofi\fR directly in a certain mode, specify a mode with \fBrofi \-show <mode>\fR\. To show the run dialog:
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -29,7 +29,7 @@ To launch \fBrofi\fR directly in a certain mode, specifying \fBrofi \-show <mode
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.SS "Daemon mode"
|
.SS "Daemon mode"
|
||||||
To launch \fBrofi\fR in daemon mode don\'t specify a mode to show (\fB\-show <mode>\fR), instead you can bind keys to launch a certain mode\. To have run mode open when pressing \fBF2\fR start \fBrofi\fR like:
|
To launch \fBrofi\fR in daemon mode don\'t specify any mode, instead keys can be bound to launch a certain mode\. To show run\-mode by pressing \fBF2\fR start \fBrofi\fR like this:
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -65,26 +65,26 @@ Command\-line options: Arguments passed to \fBrofi\fR\.
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
The Xresources options and the command\-line options are aliased\. So to set option X you would set:
|
The Xresources file expects options starting with \fBrofi\.\fR followed by it\'s name\. An Example to set the number of lines:
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
rofi\.X: value
|
rofi\.lines: 10
|
||||||
.
|
.
|
||||||
.fi
|
.fi
|
||||||
.
|
.
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
In the Xresources file, and to (override) this via the command\-line you would pass the same key prefixed with a \'\-\':
|
Command line options override settings from Xresources file\. The same option set as argument: prefixed with a \'\-\':
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
rofi \-X value
|
rofi \-lines 10
|
||||||
.
|
.
|
||||||
.fi
|
.fi
|
||||||
.
|
.
|
||||||
|
@ -121,7 +121,7 @@ Boolean
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
The boolean option has a non\-default command\-line syntax, to enable option X you do:
|
Boolean options have a non\-default command\-line syntax\. Example to enable option X:
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -171,13 +171,7 @@ Set the key combination to display a {mode} in daemon mode\.
|
||||||
\fB\-dmenu\fR
|
\fB\-dmenu\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Run \fBrofi\fR in dmenu mode\. Allowing it to be used for user interaction in scripts\.
|
Run \fBrofi\fR in dmenu mode\. This allows for interactive scripts\. In \fBdmenu\fR mode, \fBrofi\fR reads from STDIN, and output to STDOUT\. A simple example, displaying 3 pre\-defined options:
|
||||||
.
|
|
||||||
.P
|
|
||||||
In \fBdmenu\fR mode, \fBrofi\fR will read input from STDIN, and will output to STDOUT by default\.
|
|
||||||
.
|
|
||||||
.P
|
|
||||||
Example to let the user choose between three pre\-defined options:
|
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -203,16 +197,13 @@ Or get the options from a script:
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Pressing \fBshift\-enter\fR will open the selected entries and move to the next entry\.
|
Pressing \fBshift\-enter\fR sends the selected entry to STDOUT and moves to the next entry\.
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-show\fR \fImode\fR
|
\fB\-show\fR \fImode\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Open \fBrofi\fR in a certain mode\.
|
Open \fBrofi\fR in a certain mode\. Available modes are \fBwindow\fR, \fBrun\fR, \fBssh\fR To show the run\-dialog:
|
||||||
.
|
|
||||||
.P
|
|
||||||
For example to show the run\-dialog:
|
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -225,16 +216,10 @@ For example to show the run\-dialog:
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
This function deprecates \-rnow,\-snow and \-now
|
\fB\-modi\fR \fImode1,mode1\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-switchers\fR \fImode1,mode1\fR \fB\-modi\fR \fImode1,mode1\fR
|
Specify a ordered, comma separated list of modes to enable\. Enabled modes can be changed at runtime\. Default key is Ctrl+Tab\. If no modes are specified all modes will be enabled\. To only show the run and ssh launcher:
|
||||||
.
|
|
||||||
.P
|
|
||||||
Give a comma separated list of modes to enable, in what order\.
|
|
||||||
.
|
|
||||||
.P
|
|
||||||
For example to only show the run and ssh launcher (in that order):
|
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -260,7 +245,7 @@ Custom modes can be added using the internal \'script\' mode\. Each mode has two
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
So to have a mode \'Workspaces\' using the \fBi3_switch_workspace\.sh\fR script type:
|
Example: Have a mode \'Workspaces\' using the \fBi3_switch_workspace\.sh\fR script:
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -287,31 +272,17 @@ Do not print any message when starting in daemon mode\.
|
||||||
.P
|
.P
|
||||||
\fB\-fuzzy\fR
|
\fB\-fuzzy\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
|
||||||
.nf
|
|
||||||
|
|
||||||
Enable experimental fuzzy matching\.
|
Enable experimental fuzzy matching\.
|
||||||
.
|
.
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
|
||||||
.P
|
.P
|
||||||
\fB\-filter\fR \fIfilter\fR
|
\fB\-filter\fR \fIfilter\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
Filter the list by setting text in input bar to \fIfilter\fR
|
||||||
.nf
|
|
||||||
|
|
||||||
Preset user filter to *filter* in the entry box and pre\-filter the list\.
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.SS "Theming"
|
.SS "Theming"
|
||||||
\fB\-bg\fR
|
All colors are either hex #rrggbb values or X11 color names\. \fB\-bg\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-bg\-active\fR
|
\fB\-bg\-active\fR
|
||||||
|
@ -320,7 +291,7 @@ Preset user filter to *filter* in the entry box and pre\-filter the list\.
|
||||||
\fB\-bg\-urgent\fR
|
\fB\-bg\-urgent\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the background text color (X11 named color or hex #rrggbb) for the menu\.
|
Set background color in menu\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -339,7 +310,7 @@ Default: \fI#f2f1f0\fR
|
||||||
\fB\-bgalt\fR
|
\fB\-bgalt\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the background text color for alternating rows (X11 named color or hex #rrggbb) for the menu\.
|
Set background color for alternating rows in menu\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -358,7 +329,7 @@ Default: \fI#f2f1f0\fR
|
||||||
\fB\-bc\fR
|
\fB\-bc\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the border color (X11 named color or hex #rrggbb) for the menu\.
|
Set border color for menu\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -377,7 +348,7 @@ Default: \fIblack\fR
|
||||||
\fB\-bw\fR
|
\fB\-bw\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the border width in pixels\.
|
Set border width in pixels\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -402,7 +373,7 @@ Default: \fI1\fR
|
||||||
\fB\-fg\-active\fR
|
\fB\-fg\-active\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the foreground text color (X11 named color or hex #rrggbb) for the menu\.
|
Set foreground text color for the menu\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -427,7 +398,7 @@ Default: \fI#222222\fR
|
||||||
\fB\-hlbg\-urgent\fR
|
\fB\-hlbg\-urgent\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the background text color (X11 named color or hex #rrggbb) for the highlighted item in the menu\.
|
Set background color for the highlighted item in the menu\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -452,7 +423,7 @@ Default: \fI#005577\fR
|
||||||
\fB\-hlfg\-urgent\fR
|
\fB\-hlfg\-urgent\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the foreground text color (X11 named color or hex #rrggbb) for the highlighted item in the menu\.
|
Set foreground text color for the highlighted item in the menu\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -471,13 +442,13 @@ Default: \fI#FFFFFF\fR
|
||||||
\fB\-font\fR
|
\fB\-font\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Pango font name for use by the menu\.
|
Specify a font\. Pango syntax is used\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
rofi \-font monospace\e 14
|
rofi \-font "Dejavu Sans Mono 14"
|
||||||
.
|
.
|
||||||
.fi
|
.fi
|
||||||
.
|
.
|
||||||
|
@ -490,7 +461,7 @@ Default: \fImono 12\fR
|
||||||
\fB\-opacity\fR
|
\fB\-opacity\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the window opacity (0\-100)\.
|
Set window opacity (0\-100)\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -530,29 +501,15 @@ The following options are further explained in the theming section:
|
||||||
.P
|
.P
|
||||||
\fB\-color\-enabled\fR
|
\fB\-color\-enabled\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
|
||||||
.nf
|
|
||||||
|
|
||||||
Enable the exteneded coloring options\.
|
Enable the exteneded coloring options\.
|
||||||
.
|
.
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
|
||||||
.P
|
.P
|
||||||
\fB\-color\-window\fR \fIbackground\fR \fIborder color\fR \fIseparator color\fR/
|
\fB\-color\-window\fR \fIbackground\fR \fIborder color\fR \fIseparator color\fR/
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
|
||||||
.nf
|
|
||||||
|
|
||||||
Set window background, border and separator color\.
|
Set window background, border and separator color\.
|
||||||
.
|
.
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
|
||||||
.P
|
.P
|
||||||
\fB\-color\-normal\fR \fIbackground, foreground, background alt, highlight background, highlight foreground\fR
|
\fB\-color\-normal\fR \fIbackground, foreground, background alt, highlight background, highlight foreground\fR
|
||||||
.
|
.
|
||||||
|
@ -562,25 +519,19 @@ Set window background, border and separator color\.
|
||||||
.P
|
.P
|
||||||
\fB\-color\-active\fR \fIbackground, foreground, background alt, highlight background, highlight foreground\fR
|
\fB\-color\-active\fR \fIbackground, foreground, background alt, highlight background, highlight foreground\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
|
||||||
.nf
|
|
||||||
|
|
||||||
Specify the colors used in a row per state (normal, active, urgent)\.
|
Specify the colors used in a row per state (normal, active, urgent)\.
|
||||||
.
|
.
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
|
||||||
.P
|
.P
|
||||||
\fB\-line\-margin\fR
|
\fB\-line\-margin\fR
|
||||||
.
|
.
|
||||||
|
.P
|
||||||
|
Set the spacing between the rows\.
|
||||||
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
Set the spacing between the rows\.
|
|
||||||
|
|
||||||
Default: *3*
|
Default: *3*
|
||||||
Min: *3*
|
Min: *3*
|
||||||
Max: *50*
|
Max: *50*
|
||||||
|
@ -592,23 +543,30 @@ Max: *50*
|
||||||
.P
|
.P
|
||||||
\fB\-separator\-style\fR \fIstyle\fR
|
\fB\-separator\-style\fR \fIstyle\fR
|
||||||
.
|
.
|
||||||
|
.P
|
||||||
|
Set separator style\. Possible options are "solid" or "dash"\.
|
||||||
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
Set the separator style, either "solid" or "dash"
|
|
||||||
|
|
||||||
Default: *dash*
|
Default: *dash*
|
||||||
.
|
.
|
||||||
.fi
|
.fi
|
||||||
.
|
.
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
|
.P
|
||||||
|
\fB\-hide\-scrollbar\fR
|
||||||
|
.
|
||||||
|
.P
|
||||||
|
Hide the scrollbar\.
|
||||||
|
.
|
||||||
.SS "Layout"
|
.SS "Layout"
|
||||||
\fB\-lines\fR
|
\fB\-lines\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Maximum number of lines the menu may show before scrolling\.
|
Maximum number of lines to show before scrolling\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -627,7 +585,7 @@ Default: \fI15\fR
|
||||||
\fB\-columns\fR
|
\fB\-columns\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
The number of columns the menu may show before scrolling\.
|
Number of columns to show before scrolling\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -646,7 +604,7 @@ Default: \fI1\fR
|
||||||
\fB\-width\fR [value]
|
\fB\-width\fR [value]
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the width of the menu as a percentage of the screen width\.
|
Set width of menu\. \fB[value]\fR is specified in percentage\.
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -659,7 +617,7 @@ Set the width of the menu as a percentage of the screen width\.
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
If value is larger then 100, the size is set in pixels\. e\.g\. to span a full hd monitor:
|
If \fB[value]\fR is larger then 100, size is set in pixels\. Example to span a full hd monitor:
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -672,7 +630,7 @@ If value is larger then 100, the size is set in pixels\. e\.g\. to span a full h
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
If the value is negative, it tries to estimates a character width\. To show 30 characters on a row:
|
If \fB[value]\fR is negative, it tries to estimates a character width\. To show 30 characters on a row:
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -694,7 +652,7 @@ Default: \fI50\fR
|
||||||
\fB\-location\fR
|
\fB\-location\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Specify where the window should be located\. The numbers map to the following location on the monitor:
|
Specify where the window should be located\. The numbers map to the following locations on screen:
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
|
@ -729,13 +687,13 @@ Default: \fI5\fR
|
||||||
.P
|
.P
|
||||||
\fB\-sidebar\-mode\fR
|
\fB\-sidebar\-mode\fR
|
||||||
.
|
.
|
||||||
|
.P
|
||||||
|
Open in sidebar\-mode\. In this mode a list of all enabled modes is shown at the bottom\. (See \fB\-modi\fR option) To show sidebar use:
|
||||||
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
Go into side\-bar mode, it will show list of modi at the bottom\.
|
|
||||||
To show sidebar use:
|
|
||||||
|
|
||||||
rofi \-show run \-sidebar\-mode \-lines 0
|
rofi \-show run \-sidebar\-mode \-lines 0
|
||||||
.
|
.
|
||||||
.fi
|
.fi
|
||||||
|
@ -754,25 +712,19 @@ Default: \fI5000\fR
|
||||||
.P
|
.P
|
||||||
\fB\-auto\-select\fR
|
\fB\-auto\-select\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
When one entry is left, automatically select it\.
|
||||||
.nf
|
|
||||||
|
|
||||||
When one entry is left, automatically select this\.
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-m\fR \fInum\fR \fB\-monitor\fR \fInum\fR
|
\fB\-m\fR \fInum\fR \fB\-monitor\fR \fInum\fR
|
||||||
.
|
.
|
||||||
|
.P
|
||||||
|
Select (Xinerama) monitor to display \fBrofi\fR on\. The special number \-1 denotes the currently focused monitor, the number \-2 denotes the currently focused window (i\.e\. rofi will be displayed on top of the focused window)\.
|
||||||
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
Select (Xinerama) monitor to display **rofi** on\. The special number \-1 denotes the currently focused monitor, the number \-2 denotes the currently focused window (i\.e\. rofi will be displayed on top of the focused window)\.
|
|
||||||
|
|
||||||
Default: *\-1*
|
Default: *\-1*
|
||||||
.
|
.
|
||||||
.fi
|
.fi
|
||||||
|
@ -819,21 +771,14 @@ Default: \fI{terminal} \-e {ssh\-client} {host}\fR
|
||||||
.P
|
.P
|
||||||
\fB\-parse\-hosts\fR
|
\fB\-parse\-hosts\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
Parse the \fB/etc/hosts\fR file for entries\.
|
||||||
.nf
|
|
||||||
|
|
||||||
Parse the `/etc/hosts` files for entries\.
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.SS "Run settings"
|
.SS "Run settings"
|
||||||
\fB\-run\-command\fR \fIcmd\fR
|
\fB\-run\-command\fR \fIcmd\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the command (\fI{cmd}\fR) to execute when running an application\. See \fIPATTERN\fR\.
|
Set command (\fI{cmd}\fR) to execute when running an application\. See \fIPATTERN\fR\.
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Default: \fI{cmd}\fR
|
Default: \fI{cmd}\fR
|
||||||
|
@ -842,7 +787,7 @@ Default: \fI{cmd}\fR
|
||||||
\fB\-run\-shell\-command\fR \fIcmd\fR
|
\fB\-run\-shell\-command\fR \fIcmd\fR
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Set the command to execute when running an application in a shell\. See \fIPATTERN\fR\.
|
Set command to execute when running an application in a shell\. See \fIPATTERN\fR\.
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
Default: \fI{terminal} \-e {cmd}\fR
|
Default: \fI{terminal} \-e {cmd}\fR
|
||||||
|
@ -859,14 +804,13 @@ Default: \fI""\fR
|
||||||
.SS "Combi settings"
|
.SS "Combi settings"
|
||||||
\fB\-combi\-modi\fR \fImode1,mode2\fR
|
\fB\-combi\-modi\fR \fImode1,mode2\fR
|
||||||
.
|
.
|
||||||
|
.P
|
||||||
|
The modi to combine in combi mode\. For syntax to see \fB\-modi\fR\. To get one merge view, of window,run,ssh:
|
||||||
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
The modi to combine in the combi mode\.
|
|
||||||
For syntax to see `\-modi`\.
|
|
||||||
To get one merge view, of window,run,ssh:
|
|
||||||
|
|
||||||
rofi \-show combi \-combi\-modi "window,run,ssh"
|
rofi \-show combi \-combi\-modi "window,run,ssh"
|
||||||
.
|
.
|
||||||
.fi
|
.fi
|
||||||
|
@ -888,12 +832,13 @@ When searching sort the result based on levenshtein distance\.
|
||||||
.SS "Dmenu specific"
|
.SS "Dmenu specific"
|
||||||
\fB\-sep\fR \fIseparator\fR
|
\fB\-sep\fR \fIseparator\fR
|
||||||
.
|
.
|
||||||
|
.P
|
||||||
|
Separator for dmenu\. Example: To show list \'a\' to \'e\' with \'|\' as separator:
|
||||||
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
Separator for dmenu\. For example to show list a to e with \'|\' as separator:
|
|
||||||
|
|
||||||
echo "a|b|c|d|e" | rofi \-sep \'|\' \-dmenu
|
echo "a|b|c|d|e" | rofi \-sep \'|\' \-dmenu
|
||||||
.
|
.
|
||||||
.fi
|
.fi
|
||||||
|
@ -903,34 +848,30 @@ Separator for dmenu\. For example to show list a to e with \'|\' as separator:
|
||||||
.P
|
.P
|
||||||
\fB\-p\fR \fIprompt\fR
|
\fB\-p\fR \fIprompt\fR
|
||||||
.
|
.
|
||||||
|
.P
|
||||||
|
Specify the prompt to show in dmenu mode\. E\.g\. select monkey a,b,c,d or e\.
|
||||||
|
.
|
||||||
.IP "" 4
|
.IP "" 4
|
||||||
.
|
.
|
||||||
.nf
|
.nf
|
||||||
|
|
||||||
Specify the prompt to show in dmenu mode\. E\.g\. select monkey a,b,c,d or e\.
|
|
||||||
|
|
||||||
echo "a|b|c|d|e" | rofi \-sep \'|\' \-dmenu \-p "monkey:"
|
echo "a|b|c|d|e" | rofi \-sep \'|\' \-dmenu \-p "monkey:"
|
||||||
|
|
||||||
Default: *dmenu*
|
|
||||||
.
|
.
|
||||||
.fi
|
.fi
|
||||||
.
|
.
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
|
Default: \fIdmenu\fR
|
||||||
|
.
|
||||||
|
.P
|
||||||
\fB\-selected\-row\fR \fIselected row\fR
|
\fB\-selected\-row\fR \fIselected row\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
|
||||||
.nf
|
|
||||||
|
|
||||||
Select a certain row\.
|
Select a certain row\.
|
||||||
|
|
||||||
Default: *0*
|
|
||||||
.
|
.
|
||||||
.fi
|
.P
|
||||||
.
|
Default: \fI0\fR
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-l\fR \fInumber of lines to show\fR
|
\fB\-l\fR \fInumber of lines to show\fR
|
||||||
|
@ -954,113 +895,68 @@ Default: \fI15\fR
|
||||||
.P
|
.P
|
||||||
\fB\-i\fR
|
\fB\-i\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
Makes dmenu searches case\-insensitive
|
||||||
.nf
|
|
||||||
|
|
||||||
Makes dmenu match menu entries case insensitively\.
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-a\fR \fIX\fR
|
\fB\-a\fR \fIX\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
Active row, mark row X as active\. (starting at 0) You can specify single element: \-a 3 A range: \-a 3\-8 or a set of rows: \-a 0,2 or any combination: \-a 0,2\-3,9
|
||||||
.nf
|
|
||||||
|
|
||||||
Active row, mark row X as active\. (starting at 0)
|
|
||||||
You can specify single element: \-a 3
|
|
||||||
A range: \-a 3\-8
|
|
||||||
or a set of rows: \-a 0,2
|
|
||||||
Or any combination: \-a 0,2\-3,9
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-u\fR \fIX\fR
|
\fB\-u\fR \fIX\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
Urgent row, mark row X as urgent\. (starting at 0) You can specify single element: \-u 3 A range: \-u 3\-8 or a set of rows: \-u 0,2 or any combination: \-u 0,2\-3,9
|
||||||
.nf
|
|
||||||
|
|
||||||
Urgent row, mark row X as urgent\. (starting at 0)
|
|
||||||
You can specify single element: \-u 3
|
|
||||||
A range: \-u 3\-8
|
|
||||||
or a set of rows: \-u 0,2
|
|
||||||
Or any combination: \-u 0,2\-3,9
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-only\-match\fR
|
\fB\-only\-match\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
Only return a selected item, do not allow custom entry\. This mode always returns an entry, or returns directly when no entries given\.
|
||||||
.nf
|
|
||||||
|
|
||||||
Only return a selected item, do not allow custom entry\.
|
|
||||||
This mode always returns an entry, or returns directly when no entries given\.
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-no\-custom\fR
|
\fB\-no\-custom\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
Only return a selected item, do not allow custom entry\. This mode returns directly when no entries given\.
|
||||||
.nf
|
|
||||||
|
|
||||||
Only return a selected item, do not allow custom entry\.
|
|
||||||
This mode returns directly when no entries given\.
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
\fB\-format\fR \fIformat\fR
|
\fB\-format\fR \fIformat\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
|
||||||
.nf
|
|
||||||
|
|
||||||
Allows the output of dmenu to be customized (N is total number of input entries):
|
Allows the output of dmenu to be customized (N is total number of input entries):
|
||||||
|
|
||||||
* \'s\' selected string\.
|
|
||||||
* \'i\' index (0 \- (N\-1))\.
|
|
||||||
* \'d\' index (1 \- N)\.
|
|
||||||
* \'q\' quote string\.
|
|
||||||
* \'f\' filter string (user input)\.
|
|
||||||
* \'F\' quoted filter string (user input)\.
|
|
||||||
|
|
||||||
Default: \'s\'
|
|
||||||
.
|
.
|
||||||
.fi
|
.IP "\(bu" 4
|
||||||
|
\'s\' selected string\.
|
||||||
|
.
|
||||||
|
.IP "\(bu" 4
|
||||||
|
\'i\' index (0 \- (N\-1))\.
|
||||||
|
.
|
||||||
|
.IP "\(bu" 4
|
||||||
|
\'d\' index (1 \- N)\.
|
||||||
|
.
|
||||||
|
.IP "\(bu" 4
|
||||||
|
\'q\' quote string\.
|
||||||
|
.
|
||||||
|
.IP "\(bu" 4
|
||||||
|
\'f\' filter string (user input)\.
|
||||||
|
.
|
||||||
|
.IP "\(bu" 4
|
||||||
|
\'F\' quoted filter string (user input)\.
|
||||||
.
|
.
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.P
|
.P
|
||||||
|
Default: \'s\'
|
||||||
|
.
|
||||||
|
.P
|
||||||
\fB\-select\fR \fIstring\fR
|
\fB\-select\fR \fIstring\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
|
||||||
.nf
|
|
||||||
|
|
||||||
Select first line that matches the given string
|
Select first line that matches the given string
|
||||||
.
|
.
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
|
||||||
.P
|
.P
|
||||||
\fB\-mesg\fR \fIstring\fR
|
\fB\-mesg\fR \fIstring\fR
|
||||||
.
|
.
|
||||||
|
@ -1070,30 +966,14 @@ Add a message line below the filter entry box\. Supports pango markup\. For more
|
||||||
.SS "Message dialog"
|
.SS "Message dialog"
|
||||||
\fB\-e\fR \fImessage\fR
|
\fB\-e\fR \fImessage\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
Popup a message dialog (used internally for showing errors) with \fImessage\fR\. Message can be multi\-line\.
|
||||||
.nf
|
|
||||||
|
|
||||||
Popup a message dialog (used internally for showing errors) with *message*\.
|
|
||||||
Message can be multi\-line\.
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.SS "Other"
|
.SS "Other"
|
||||||
\'\-pid\' \fIpath\fR
|
\'\-pid\' \fIpath\fR
|
||||||
.
|
.
|
||||||
.IP "" 4
|
.P
|
||||||
.
|
Make \fBrofi\fR create a pid file and check this on startup\. Avoiding multiple copies running simultaneously\. This is useful when running \fBrofi\fR from a keybinding daemon\.
|
||||||
.nf
|
|
||||||
|
|
||||||
Make **rofi** create a pid file and check this on startup\. Avoiding multiple copies running
|
|
||||||
simultaneous\. This is useful when running **rofi** from a keybinding daemon\.
|
|
||||||
.
|
|
||||||
.fi
|
|
||||||
.
|
|
||||||
.IP "" 0
|
|
||||||
.
|
.
|
||||||
.SS "Debug"
|
.SS "Debug"
|
||||||
\fB\-dump\-xresources\fR
|
\fB\-dump\-xresources\fR
|
||||||
|
@ -1222,13 +1102,20 @@ rofi \-color\-normal "#fdf6e3,#002b36,#eee8d5,#586e75,#eee8d5"
|
||||||
.IP "" 0
|
.IP "" 0
|
||||||
.
|
.
|
||||||
.SH "COLORS"
|
.SH "COLORS"
|
||||||
Rofi has an experimental mode for a \'nicer\' transparency\. The idea is that you can make the background of the window transparent but the text not\. This way, in contrast to the \fB\-opacity\fR option, the text is still fully visible and readable\. To use this there are 2 requirements: 1\. Your Xserver supports TrueColor, 2\. You are running a composite manager\. If this is satisfied you can use the following format for colors:
|
Rofi has an experimental mode for a \'nicer\' transparency\. The idea is to make the background of the window transparent, leaving the text opaque\. There are 2 requirements for this feature: 1\. Your Xserver supports TrueColor, 2\. You are running a composite manager\. If this is satisfied you can use the following format for colors:
|
||||||
.
|
.
|
||||||
.P
|
.IP "" 4
|
||||||
|
.
|
||||||
|
.nf
|
||||||
|
|
||||||
argb:FF444444
|
argb:FF444444
|
||||||
.
|
.
|
||||||
|
.fi
|
||||||
|
.
|
||||||
|
.IP "" 0
|
||||||
|
.
|
||||||
.P
|
.P
|
||||||
The first two fields specify the alpha level\. This determines how much the background shines through the color (00 everything, FF nothing)\. E\.g\. \'argb:00FF0000\' gives you a bright red color with the background shining through\. If you want a dark greenish transparent color use: \'argb:dd2c3311\'\. This can be done for any color; it is therefore possible to have solid borders, the selected row solid, and the others slightly transparent\.
|
The first two fields specify the alpha level\. This determines the amount of transparency\. (00 everything, FF nothing)\. The other fields represent the actual color, in hex\.
|
||||||
.
|
.
|
||||||
.SH "KEYBINDINGS"
|
.SH "KEYBINDINGS"
|
||||||
\fBrofi\fR has the following key\-bindings:
|
\fBrofi\fR has the following key\-bindings:
|
||||||
|
|
|
@ -236,6 +236,8 @@ typedef struct _Settings
|
||||||
char *filter;
|
char *filter;
|
||||||
/** style */
|
/** style */
|
||||||
char *separator_style;
|
char *separator_style;
|
||||||
|
/** hide scrollbar */
|
||||||
|
unsigned int hide_scrollbar;
|
||||||
} Settings;
|
} Settings;
|
||||||
|
|
||||||
/** Global Settings structure. */
|
/** Global Settings structure. */
|
||||||
|
|
|
@ -1022,8 +1022,13 @@ MenuReturn menu ( char **lines, unsigned int num_lines, char **input, char *prom
|
||||||
x_offset, y_offset,
|
x_offset, y_offset,
|
||||||
state.element_width, element_height, NORMAL, "" );
|
state.element_width, element_height, NORMAL, "" );
|
||||||
}
|
}
|
||||||
state.scrollbar = scrollbar_create ( main_window, &vinfo, map, state.w - config.padding-config.line_margin- 8, state.top_offset,
|
if ( !config.hide_scrollbar ) {
|
||||||
config.line_margin+8, ( state.max_rows - 1 ) * ( element_height + config.line_margin ) + element_height );
|
state.scrollbar = scrollbar_create ( main_window, &vinfo, map,
|
||||||
|
state.w - config.padding - config.line_margin - 8,
|
||||||
|
state.top_offset,
|
||||||
|
config.line_margin + 8,
|
||||||
|
( state.max_rows - 1 ) * ( element_height + config.line_margin ) + element_height );
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
scrollbar_set_max_value ( state.scrollbar, state.num_lines );
|
scrollbar_set_max_value ( state.scrollbar, state.num_lines );
|
||||||
|
|
|
@ -70,37 +70,50 @@ scrollbar *scrollbar_create ( Window parent, XVisualInfo *vinfo, Colormap map,
|
||||||
|
|
||||||
void scrollbar_show ( scrollbar *sb )
|
void scrollbar_show ( scrollbar *sb )
|
||||||
{
|
{
|
||||||
|
if ( sb != NULL ) {
|
||||||
XMapWindow ( display, sb->window );
|
XMapWindow ( display, sb->window );
|
||||||
}
|
}
|
||||||
|
}
|
||||||
void scrollbar_hide ( scrollbar *sb )
|
void scrollbar_hide ( scrollbar *sb )
|
||||||
{
|
{
|
||||||
|
if ( sb != NULL ) {
|
||||||
XUnmapWindow ( display, sb->window );
|
XUnmapWindow ( display, sb->window );
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
void scrollbar_free ( scrollbar *sb )
|
void scrollbar_free ( scrollbar *sb )
|
||||||
{
|
{
|
||||||
|
if ( sb != NULL ) {
|
||||||
XFreeGC ( display, sb->gc );
|
XFreeGC ( display, sb->gc );
|
||||||
XDestroyWindow ( display, sb->window );
|
XDestroyWindow ( display, sb->window );
|
||||||
g_free ( sb );
|
g_free ( sb );
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
void scrollbar_set_max_value ( scrollbar *sb, unsigned int max )
|
void scrollbar_set_max_value ( scrollbar *sb, unsigned int max )
|
||||||
{
|
{
|
||||||
|
if ( sb != NULL ) {
|
||||||
sb->length = MAX ( 1, max );
|
sb->length = MAX ( 1, max );
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
void scrollbar_set_handle ( scrollbar *sb, unsigned int pos )
|
void scrollbar_set_handle ( scrollbar *sb, unsigned int pos )
|
||||||
{
|
{
|
||||||
|
if ( sb != NULL ) {
|
||||||
sb->pos = MIN ( sb->length, MAX ( 0, pos ) );
|
sb->pos = MIN ( sb->length, MAX ( 0, pos ) );
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
void scrollbar_set_handle_length ( scrollbar *sb, unsigned int pos_length )
|
void scrollbar_set_handle_length ( scrollbar *sb, unsigned int pos_length )
|
||||||
{
|
{
|
||||||
|
if ( sb != NULL ) {
|
||||||
sb->pos_length = MIN ( sb->length, MAX ( 1, pos_length ) );
|
sb->pos_length = MIN ( sb->length, MAX ( 1, pos_length ) );
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
void scrollbar_draw ( scrollbar *sb )
|
void scrollbar_draw ( scrollbar *sb )
|
||||||
{
|
{
|
||||||
|
if ( sb != NULL ) {
|
||||||
// Calculate position and size.
|
// Calculate position and size.
|
||||||
const short bh = sb->h - 0;
|
const short bh = sb->h - 0;
|
||||||
float sec = ( ( bh ) / (float) sb->length );
|
float sec = ( ( bh ) / (float) sb->length );
|
||||||
|
@ -117,11 +130,15 @@ void scrollbar_draw ( scrollbar *sb )
|
||||||
// Paint the handle.
|
// Paint the handle.
|
||||||
XFillRectangle ( display, sb->window, sb->gc, config.line_margin, y, sb->w - config.line_margin, height );
|
XFillRectangle ( display, sb->window, sb->gc, config.line_margin, y, sb->w - config.line_margin, height );
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
unsigned int scrollbar_clicked ( scrollbar *sb, int y )
|
unsigned int scrollbar_clicked ( scrollbar *sb, int y )
|
||||||
{
|
{
|
||||||
|
if ( sb != NULL ) {
|
||||||
const short bh = sb->h - 2;
|
const short bh = sb->h - 2;
|
||||||
float sec = ( ( bh ) / (float) sb->length );
|
float sec = ( ( bh ) / (float) sb->length );
|
||||||
unsigned int sel = y / sec;
|
unsigned int sel = y / sec;
|
||||||
return sel;
|
return sel;
|
||||||
}
|
}
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
|
@ -129,7 +129,8 @@ static XrmOption xrmOptions[] = {
|
||||||
{ xrm_SNumber, "m", { .snum = &config.monitor }, NULL },
|
{ xrm_SNumber, "m", { .snum = &config.monitor }, NULL },
|
||||||
{ xrm_Number, "line-margin", { .num = &config.line_margin }, NULL },
|
{ xrm_Number, "line-margin", { .num = &config.line_margin }, NULL },
|
||||||
{ xrm_String, "filter", { .str = &config.filter }, NULL },
|
{ xrm_String, "filter", { .str = &config.filter }, NULL },
|
||||||
{ xrm_String, "separator-style", { .str = &config.separator_style }, NULL }
|
{ xrm_String, "separator-style", { .str = &config.separator_style }, NULL },
|
||||||
|
{ xrm_Boolean, "hide-scrollbar", { .num = &config.hide_scrollbar }, NULL }
|
||||||
};
|
};
|
||||||
|
|
||||||
// Dynamic options.
|
// Dynamic options.
|
||||||
|
|
Loading…
Reference in a new issue