~~NOTOC~~
====== xfce4-generic-slider ======

A visual slider widget to control user-configurable variables (e.g. volume control) from the panel.

===== Introduction =====

Xfce4-generic-slider is a tool to help Xfce users deal with a variable which they wish to both GET and SET. The getting side is similar to what [[panel-plugins:xfce4-genmon-plugin:|xfce4-genmon-plugin]] does except the command's numerical output is represented visually in a slider. Dragging the slider is then used to set the value through calls to a second command.


  * **[[#Installation|Installation]]**
  * **[[#Configuration|Configuration]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Screenshots =====

{{:panel-plugins:xfce4-generic-slider.png?400|}}

----

===== Installation =====

To clone the source tree and build the package, you will need the Xfce development libraries:

  * **[[:xfce:libxfce4util:|libxfce4util]]**
  * **[[:xfce:libxfce4ui:|libxfce4ui]]**

<code>
  % git clone https://gitlab.xfce.org/panel-plugins/xfce4-generic-slider.git
  % cd xfce4-generic-slider
  % ./autogen.sh
  % make
  % make install
</code>

Be sure to specify an installation prefix ''/ DESTDIR'' so that it goes to the right place.

[[|Back to Top]]

----

===== Configuration =====

Once ''xfce4-generic-slider'' is running in your panel, you can change the color of the slider and set whether a label appears beside it. To actually use it, you need to setup three references to the variable you're interested in. Here's an example of how to make a slider for the volume:

    Adjust this command: amixer set PCM %v
    Denominator for adjusting: 255
    Synchronize with this command: amixer get PCM | tail -1 | awk '{print $4}'
    Denominator for synchronizing: 255
    Label for slider: PCM: %v
    Denominator for label: 255

When the slider is dragged to a certain fraction, this fraction times 255 will be passed to ''amixer set''. When another application changes the volume, the slider will call ''amixer get'' to determine what the returned number is as a fraction of 255. Note that the right denominator can differ depending on the sound card.

[[|Back to Top]]

----

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

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

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

  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-generic-slider/|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-generic-slider]]

----

===== Reporting Bugs =====
  * **[[:panel-plugins:xfce4-generic-slider:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports

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