A retro-looking volume setting program for Linux.
Clone or download
Permalink
Failed to load latest commit information.
images Adjust icon colors Feb 14, 2014
m4 Update for automake 1.14.1 and autoconf 2.69 Feb 14, 2014
po Bump version number to 0.13.1 May 15, 2013
src Only draw slider window when tray icon is enabled Oct 16, 2014
.gitignore Create .gitignore, remove unneeded file from repo May 8, 2013
ABOUT-NLS Added i18n support. Oct 6, 2009
AUTHORS Adjusted things to use the auto tools. Mar 15, 2009
COPYING Corrected the COPYING file and added notices in Public Domain source … Mar 15, 2009
ChangeLog Added i18n support. Oct 6, 2009
INSTALL Adjusted things to use the auto tools. Mar 15, 2009
Makefile.am Added i18n support. Oct 6, 2009
Makefile.in Update for automake 1.14.1 and autoconf 2.69 Feb 14, 2014
NEWS Adjusted things to use the auto tools. Mar 15, 2009
README Clarify when eggtrayicon is used (gtk < 2.16) May 10, 2013
TODO Retrovol has moved to GitHub. May 8, 2013
aclocal.m4 Update for automake 1.14.1 and autoconf 2.69 Feb 14, 2014
compile compile should be a file, not a link Feb 14, 2014
config.guess Added i18n support. Oct 6, 2009
config.h.in Update to work with newer autotools versions May 9, 2013
config.rpath Added i18n support. Oct 6, 2009
config.sub Added i18n support. Oct 6, 2009
configure Bump version number to 0.14.1 Oct 16, 2014
configure.ac Bump version number to 0.14.1 Oct 16, 2014
depcomp Adjusted things to use the auto tools. Mar 15, 2009
dot.retrovolrc Made program remember window position and dimensions May 2, 2010
gpl.txt Updated the README to clairify that the eggtrayicon code is NOT mine,… Feb 3, 2009
install-sh Adjusted things to use the auto tools. Mar 15, 2009
lgpl.txt Updated the README to clairify that the eggtrayicon code is NOT mine,… Feb 3, 2009
missing Adjusted things to use the auto tools. Mar 15, 2009

README

Retrovol
https://github.com/pizzasgood/retrovol
git://github.com/pizzasgood/retrovol.git

---- Legal Jazz --------------------------------------------------------------
 
 This software is released into the public domain.
 
 This software includes the eggtrayicon.c and eggtrayicon.h libraries, which
 were released under the GNU LGPL.  They are copyrighted by Anders Carlsson,
 not myself.  I claim no credit for them; they are unmodified.  Copies of the
 GNU GPL and GNU LGPL are included in this package named gpl.txt and lgpl.txt,
 in compliance with Section 4e of the GNU LGPL.

 Note that eggtrayicon is only required for versions of GTK prior to 2.16.
 
---- End Legal Jazz ----------------------------------------------------------

Retrovol is a volume setting program.  It adds an icon to the tray that can be
scrolled on to change the volume.  It can be middle-clicked to mute/unmute. It
can be right-clicked to get a menu with an option to display the main window,
which lists all the volume controls it can detect on your system.

Sliders can be controlled by clicking, draging, scrolling (either up/down or
left/right), and by using the left/right and PgUp/PgDown keys.  Note that for
the keyboard to work, you have to select the control with the keyboard.  There
is no visual feedback yet to show whether a control is selected (this will be
improved eventually).

For stereo audio controls, you can modify only the left or right channels by
holding the shift or control keys respectively while manipulating the slider.

Configuration changes can be made in the ~/.retrovolrc file, or through the
preferences window at File->Configure.  For example, you can change the colors
to green and blue, make the segments fatter, disable the tray icon, and have
the main window only display specific sliders.

Retrovol will only allow one instance to run at a time.  If you attempt to
launch a second instance it will instead pop up the main window if it isn't
already visible.

Also, Retrovol accepts a -bg <hexcolor> commandline option to specify the tray
icon's background color.  Normally it will just use the normal GTK background
color, but if that doesn't match your tray, you can use this to adjust it.
This can also be specified in the config file (or through the preferences gui)
but those are not convenient to automatically update to match the colorscheme
when you change WM themes or whatever.  Thus the -bg option is provided so
that the script which launches Retrovol could look at the color of the theme
and supply that on the commandline, without needing to modify the config file.