====== Verve ======

===== About =====

The Verve panel plugin is a comfortable command line plugin for the Xfce panel. It supports several nice features, such as:

  * Opens URLs, e-mail addresses, directories, and programs
  * Command history
  * Auto-completion (including command history)
  * Focus grabbing via D-BUS (so you can bind a shortcut to it)
  * Custom input field width

New features in version 1.1.0:

  * Ability to use the verve plugin to run smart bookmarks instead of commands
  * Support for tilde and variable expansion in directory paths
  * Support for running "normal" commands through your default shell (to expand variables and aliases)
  * Ability to direct command beginning with ! or \ to [[https://duckduckgo.com|DuckDuckGo]]
  * Optional label (screenshot below)

===== Usage =====

Once added to the panel, you can use the following keys to control Verve:

  * **''TAB''** to iterate through auto-completion entries
  * **''UP''** and **''DOWN''** arrows to iterate through the command history
  * **''CTRL+ENTER''** to run a command in a terminal emulator
  * **''ESC''** to clear your input

If you want to launch URLs or eMail addresses using Verve, just paste them into the input field and press **''ENTER''**.

==== Focus Grabbing ====

Verve installs a script named ''verve-focus'' which can be used to bind a keyboard shorcut for Verve to grab the focus. To do so, you first need to open the Xfce settings manager:

  xfce-setting-show

Once the dialog has appeared, chose **Keyboard**. In the next dialog, select the **Shortcuts** tab and add a shortcut for ''verve-focus''.

After this, Verve should grab the focus and start blinking whenever you press this shortcut. To stop the blinking, just type something (like a command or something else) or click on it with the mouse.

===== Screenshots =====

==== Verve in normal state ====
{{:projects:panel-plugins:verve-normal.png|:projects:panel-plugins:verve-normal.png}}

==== Verve blinking after grabbing the focus ====
{{:projects:panel-plugins:verve-blinking.png|:projects:panel-plugins:verve-blinking.png}}

==== Auto-completion ====
{{:projects:panel-plugins:verve-completion.png|:projects:panel-plugins:verve-completion.png}}

==== Version 1.1.0 config dialog ====
{{:projects:panel-plugins:verve-properties-1.png}} {{:projects:panel-plugins:verve-properties-2.png}}

{{:projects:panel-plugins:verve-label.png}}

===== Releases =====



==== Stable version ====

[[http://archive.xfce.org/src/panel-plugins/xfce4-verve-plugin/1.1/xfce4-verve-plugin-1.1.0.tar.bz2|1.1.0]]
==== Subversion / Git ====

[[http://git.xfce.org/panel-plugins/xfce4-verve-plugin]]



===== Dependencies =====

  * GTK 2
  * GLib
  * Xfce packages:
    * libexo
    * libxfce4ui
    * libxfce4util
    * xfce4-panel
  * libpcre

Optional packages:
  * dbus (for the verve-focus command)
  * version 1.1.0+: wordexp (for tilde and variable expansion in directory paths)
===== Reporting Bugs =====

Bugs should be reported to the [[http://bugzilla.xfce.org|Xfce bug tracking system]] (product ''Xfce Panel Plugins'', component ''verve'').