Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
panel-plugins:xfce4-verve-plugin:start [2019/11/12 00:28] – removed kevinbowenpanel-plugins:xfce4-verve-plugin:start [2025/05/20 15:53] (current) – [Required Packages] Meson andreldm
Line 1: Line 1:
 +~~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/meson.build|meson.build]] 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]]