~~NOTOC~~
====== xfce4-verve-plugin - Verve ======

The Verve panel plugin is a comfortable command line plugin for the Xfce panel

  * **[[#Usage|Usage]]**
  * **[[#Screenshots|Screenshots]]**
  * **[[#Required Packages|Required Packages]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Features =====

. The Verve plugin 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.

[[|Back To Top]]
----

===== Screenshots =====

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

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

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

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

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

[[|Back To Top]]
----

===== Required Packages =====

  * [[https://wiki.gnome.org/Projects/GLib|GLib]]
  * [[https://www.gtk.org|GTK+-3.0]]
  * [[https://gitlab.xfce.org/xfce/exo|exo]]
  * [[https://gitlab.xfce.org/xfce/libxfce4ui|libxfce4ui]]
  * [[https://gitlab.xfce.org/xfce/libxfce4util|libxfce4util]]
  * [[https://gitlab.xfce.org/xfce/xfce4-panel|xfce4-panel]]
  * libpcre

=== Optional Packages ===

  * wordexp (for tilde and variable expansion in directory paths)

For detailed information on the minimum required versions, check the [[https://gitlab.xfce.org/panel-plugins/xfce4-verve-plugin/-/blob/master/configure.ac.in|configure.ac.in]] file.

verve-focus is no longer supported in the GTK 3 version of xfce4-verve-plugin, due to changes in libraries related to dbus. (Let me know if you can contribute a patch to bring it back!)

----

===== Latest Release =====

==== 2.0 (2018/04/15) ====

{{rss>https://archive.xfce.org/feeds/project/xfce4-verve-plugin 1 date 2h}}

[[https://gitlab.xfce.org/panel-plugins/xfce4-verve-plugin/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-verve-plugin/|Download current release]]** (link also contains older versions)

[[|Back to Top]]

----

===== Source Code Repository =====

[[https://gitlab.xfce.org/panel-plugins/xfce4-verve-plugin]]

----

===== Reporting Bugs =====
  * **[[:panel-plugins:xfce4-verve-plugin:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs

[[|Back To Top]]
----
[[ :xfce:xfce4-panel:start:|Return to Main Xfce4-panel page]]