GithubHelp home page GithubHelp logo

sahwar / rofi Goto Github PK

View Code? Open in Web Editor NEW

This project forked from davatorium/rofi

0.0 2.0 0.0 9.74 MB

Rofi: A window switcher, run dialog and dmenu replacement

Home Page: https://davedavenport.github.io/rofi/

License: Other

Makefile 1.97% C 94.01% M4 1.14% C++ 0.11% Shell 2.77%

rofi's Introduction

Build Status codecov.io Issues Forks Stars Downloads

A window switcher, run dialog and dmenu replacement

Rofi started as clone of simpleswitcher, written by Sean Pringle a popup window switcher roughly based on superswitcher. Simpleswitcher laid the foundations and therefor Sean Pringle deserves most of the credit for this tool. Rofi, renamed as it lost the simple property, has been extended with extra features, like a run-dialog, ssh-launcher and can act as a drop-in dmenu replacement, making it a very versatile tool.

Rofi, like dmenu, will provide the user with a textual list of options where one or more can be selected. This can either be, running an application, selecting a window or options provided by an external script.

It main features are:

  • Full (configurable) keyboard navigation.
  • Type to filter
    • Tokenized: Type any word in any order to filter.
    • (toggable) Case insensitive.
    • Supports regex and glob matching.
  • UTF-8 enabled.
    • UTF-8 aware string collating.
    • intl. keyboard support (`e -> è)
  • RTL language support.
  • Cairo drawing and Pango font rendering.
  • Build in modes:
    • Window switcher mode.
      • EWMH compatible WM.
    • Run mode.
    • Desktop File Run mode.
    • SSH launcher mode.
    • Combi mode, allow several modes to be merged into one list.
  • History based ordering last 25 choices are ordered on top based on use. (optional)
  • Levenshtein distance ordering of matches. (optional)
  • Drop in dmenu replacement.
    • With many added improvements.
  • Can be easily extended using scripts.
  • Themeing.

Rofi has several buildin modes implementing common use-cases and can be exteneded by scripts (either called from Rofi or calling Rofi).

Below the different modes are listed:

Window Switcher

Window List

The window switcher shows the following informations in columns (can be customized):

  1. Desktop number
  2. Window class.
  3. Window title.

Run mode

run mode

The run mode allows users to quickly search and launch a program. Run mode features:

  • Shift-Return to run the selected program in a terminal.
  • Favorites list, frequently used programs are sorted on top.

DRun mode

The desktop run mode allows users to quickly search and launch an application from the freedesktop.org Desktop Entries. These are used by most common Desktop Environments to populate launchers and menus. Drun mode features:

  • Favorites list, frequently used programs are sorted on top.
  • Auto starting terminal applications in a terminal.

SSH launcher

SSH Launcher

Quickly ssh into remote machines

  • Parses ~/.ssh/config to find hosts.

Script mode

Loads external scripts to add modes to Rofi, for example a file-browser.

rofi  -show fb -modi fb:../Examples/rofi-file-browser.sh

COMBI mode

Combine multiple modes in one view. This is especially usefull when merging the window and run mode into one view. Allowing to quickly switch to an application, either by switching to it when it is already running or starting it.

Example to combine Desktop run and the window switcher:

rofi -combi-modi window,drun -show combi

dmenu replacement

DMENU replacement (running teiler)

Drop in dmenu replacement. (Screenshot shows rofi used by teiler ).

Rofi features several improvements over dmenu to improve usability. There is the option to add an extra message bar (-mesg), pre-entering of text (-filter) or selecting entries based on a pattern (-select). Also highlighting (-u and -a) options and modi to force user to select one provided option (-only-match). In addition to this rofi's dmenu mode can select multiple lines and write them to stdout.

Usage

If used with -show [mode], rofi will immediately open in the specified [mode]

If used with -dmenu, rofi will use data from STDIN to let the user select an option.

For example to show a run dialog:

rofi -show run

Show a ssh dialog:

rofi -show ssh

dmenu

If passed the -dmenu option, or ran as dmenu (ie, /usr/bin/dmenu is symlinked to /usr/bin/rofi), rofi will use the data passed from STDIN.

~/scripts/my_script.sh | rofi -dmenu
echo -e "Option #1\nOption #2\nOption #3" | rofi -dmenu

In both cases, rofi will output the user's selection to STDOUT.

Switching Between Modi

Type Shift-/Left/Right to switch between active modi.

Keybindings

Key Action
Ctrl-v, Insert Paste clipboard
Ctrl-Shift-v, Shift-Insert Paste primary selection
Ctrl-u Clear the line
Ctrl-a Beginning of line
Ctrl-e End of line
Ctrl-f, Right Forward one character
Alt-f Forward one word
Ctrl-b, Left Back one character
Alt-b Back one word
Ctrl-d, Delete Delete character
Ctrl-Alt-d Delete word
Ctrl-h, Backspace Backspace (delete previous character)
Ctrl-Alt-h Delete previous word
Ctrl-j,Ctrl-m,Enter Accept entry
Ctrl-n,Down Select next entry
Ctrl-p,Up Select previous entry
Page Up Go to the previous page
Page Down Go to the next page
Ctrl-Page Up Go to the previous column
Ctrl-Page Down Go to the next column
Ctrl-Enter Use entered text as command (in ssh/run modi)
Shift-Enter Launch the application in a terminal (in run mode)
Shift-Enter Return the selected entry and move to the next item while keeping Rofi open. (in dmenu)
Shift-Right Switch to the next modi. The list can be customized with the -modi option.
Shift-Left Switch to the previous modi. The list can be customized with the -modi option.
Ctrl-Tab Switch to the next modi. The list can be customized with the -modi option.
Ctrl-Shift-Tab Switch to the previous modi. The list can be customized with the -modi option.
Ctrl-space Set selected item as input text.
Shift-Del Delete entry from history.
grave Toggle case sensitivity.
Alt-grave Toggle levenshtein sort.
Alt-Shift-S Take a screenshot and store this in the Pictures directory.

For the full list of keybindings see: rofi -show keys or rofi -help.

Configuration

There are currently three methods of setting configuration options:

  • Local configuration. Normally, depending on XDG, in ~/.local/rofi/config. This uses the Xresources format.
  • Xresources: A method of storing key values in the Xserver. See here for more information.
  • Commandline options: Arguments passed to Rofi.

The Xresources options and the commandline options are aliased. To define option X set:

rofi.X: value

In the Xresources file. To set/override this from commandline pass the same key prefixed with '-':

rofi -X value

To get a list of available options, formatted as Xresources entries run:

rofi -dump-Xresources

or in a more readable format

rofi -help

The configuration system supports the following types:

  • String
  • Integer (signed and unsigned)
  • Char
  • Boolean

The boolean option has a non-default commandline syntax, to enable option X you do:

rofi -X

to disable it:

rofi -no-X

Installation

Please see the installation guide for instruction on how to install Rofi.

rofi's People

Contributors

alpha123 avatar bcremer avatar benizi avatar blueyed avatar buglloc avatar carnager avatar dantefirex avatar davedavenport avatar deiwin avatar eigengrau avatar gbitzes avatar haasn avatar hexchain avatar izmntuk avatar jamesbvaughan avatar jasperla avatar jpleau avatar jubalh avatar keidax avatar klemens avatar larkery avatar martijnktue avatar pfsmorigo avatar sardemff7 avatar seanpringle avatar serentty avatar shade-of-noon avatar shioyama avatar t-wissmann avatar tblue avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.