~~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 =====

  * [[:xfce:xfce4-panel:add-new-items|Add the plugin to the panel]].
 
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 =====

<figure "Verve Plugin Indicator Normal State">
{{:panel-plugins:verve-plugin_normal.png|Verve Plugin Indicator Normal State}}
</figure>

<figure "Verve Plugin Indicator Blinking After Grabbing Focus">
{{:panel-plugins:verve-plugin_blinking.png|:projects:panel-plugins:Verve Plugin Indicator Blinking After Grabbing Focus}}
</figure>

<figure "Verve Plugin Auto-completion">
{{:panel-plugins:verve-plugin_completion.png|Verve Plugin Auto-completion}}
</figure>

<figure "Verve Plugin Indicator with Label">
{{:panel-plugins:verve-plugin_label.png|Verve Plugin Indicator with Label}}
</figure>

<figure "Verve Plugin Configuration General Tab Window">
{{:panel-plugins:verve-plugin_preferences_general_tab.png|Verve Plugin Configuration Dialog Window}} 
</figure>

<figure "Verve Plugin Configuration Behaviour Tab Window">
{{:panel-plugins:verve-plugin_preferences_behaviour_tab.png}}
</figure>

[[|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]]** (older versions of this component are also available here)

[[|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]]** -- List of currently open bugs and instructions on how to submit new bug reports

[[|Back To Top]]
----
[[:xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]