INTERROBANG

Interrobang - A tiny launcher menu packing a big bang syntax

Author: Jesse McClure, Copyright 2013 License: GPLv3

Synopsis

interrobang [-h] [-v] [-o config-string] [-] [hushbang]

Description

Interrobang is a scriptable launcher menu with a customizable shortcut syntax and completion options.

Options

-h

Print help and exit

-v

Print version information and exit

-o config-string

Override a setting from the runtime configuration with a full line in quotes with a syntax matching that described below for configuration files

-

Read configuration file from the standard input

hushbang

Specify a bang syntax (see below) to use by default

Configuration

Runtime configuration is read from the following files, in order, stopping at the first file found: stdin if - is specified on the command line,

$XDG_CONFIG_HOME/interrobang/config

$HOME/.interrobangrc

A template configuration file is distributed as

/usr/share/interrobang/config

Each non-empty non-comment line in a configuration file must start with set, bang, or tab. Lines starting with a

#

Set

set parameter = setting

The following parameters can be set:

font

Select a font as either an XLFD font string, or a string that would be matched by font-config (fc-match)

geometry

One of `top`, `bottom`, or a geometry string as `WxH+X+Y`. If X or Y are -1 the bar will be centered in that direction.

colors

Provide six `#RRGGBB` color strings for foreground and background for each of normal text, option listings, and selected options.

border

Select a border width in pixels and an #RRGGBB color for the boarder as `Npx #RRGGBB`

bangchar

Specify the "bang" character. ! is the default, : is a common alternative.

run_hook

A format string into which the selected command will be placed before running. This can be used to store a history of commands. This string should contain one %s which will be replaced by the selected command.

autocomp

Whether commands should be autocompleted. Select 0 for no autocompletion, or a positive number of characters as the minimum number required from the user before completion options are provided.

list

Completion options displayed in bar: true or false.

last

Last "word" only in completion options: true or false.

margin

Number of pixels for the margin between the displayed completion options and the end of the entered text. Positive values will left-align the options at this margin, while negative values will right-align the options in the window and use this value as the minimum space between entered text and the first option.

shell

Specify an alternative shell for launching commands

flags

Specify alternative flags to the shell. The default -c can be replaced with -ic for an interactive shell which will allow for the use of shell rc-defined aliases.

Bang

bang keyword = command-string

Bangs - inspired by the duckduckgo search engine - are customizable commands which allow the user to extend interrobang's functionality in creative ways. If the first character entered in interrobang matches the bangchar (! by default), the word immediately following the bangchar is read as the bang. This bang is looked up in the configuration, and the remainder of the entry takes the place of the

%s

See the default configuration for examples of how bangs can be customized.

Tab

tab keyword = command-string

For each defined bang, there can be a separate tab-completion mechanism. Various examples can be found in the default configuration file. The special keyword "default" is used for tab-completion for regular entries. Two default options are provided for either bash's built in completion with compgen, or with the percontation tool which is distributed with interrobang.

command-string must be a format string with two

%s

%s

See the default configuration for examples of how tab completion can be customized.

Author

Copyright ©2013 Jesse McClure

License GPLv3: GNU GPL version 3: http://gnu.org/licenses/gpl.html

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law.

Submit bug reports via github: http://github.com/TrilbyWhite/interrobang.git

I would like your feedback. If you enjoy Interrobang see the bottom of the site below for details on submitting comments: http://mccluresk9.com/software.html