Rhythmbox plugin to show a 'Jump to' window when a hotkey is pressed
Python
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
ui
.gitignore
COPYING
JumpToWindow.plugin
Makefile
README

README

                            JumpToWindow
                            ============

            Copyright 2012 Beat Küng <beat-kueng@gmx.net>


JumpToWindow is a Rhythmbox plugin which shows a 'Jump to' window when a certain
hotkey is pressed. It allows to fast selecting a song from the currently playing
source (without having to use the mouse).
It's very similar to the 'Jump to File' feature in Winamp, including the ability
to enqueue a song.


Note: This plugin requires Rhythmbox 3.0 or newer. For older versions use 
git tag v0.95 (git checkout v0.95)


Installation
------------

	1) Run make install
	   Or copy the content of this folder to the directory
	   "/home/<user>/.local/share/rhythmbox/plugins/JumpToWindow/"
	   (If this directory doesn't exist, create it!)
	
	2) install packages 'python3-dbus' (eg yum install python3-dbus)

	3) Install a global hotkey that executes the script
	   "/home/<user>/.local/share/rhythmbox/plugins/JumpToWindow/src/activate.py"

	   - For gnome go to System -> Preferences -> Keyboard Shortcuts -> Add
	   - Or you can use the window manager independant package 'xbindkeys'
	     (http://www.nongnu.org/xbindkeys/xbindkeys.html)

	4) Enable the plugin in Rhythmbox under 'Edit > Plugins'

	5) You probably have to lower the focus prevention level in your window
	   manager, that the Jump to window gets the focus, when the hotkey is
	   pressed.


Keyboard usage
--------------

	- Enter to play the selected song & hide the window
	- Alt+Enter to enqueue the selected song
	- Esc to hide the window
	- Up/Down arrow to select the previous/next item
	  pressing Space repeatedly also selects the next item
	  (Shift+Space for previous item)
	- Shift + F: scroll one page down
	- Shift + B: scroll one page up


Miscellaneous
-------------

if you have any improvements or suggestions you are welcome to 
implement them and/or contact me