Remoot

Remoot Installation

ReMoot - the pseudo-universal remote control wrapper

ReMoot is a remote control that supports many popular multimedia applications running on GNU/Linux
and possibly other *nix platforms as well. It wraps around these apps and provides a unified and easy-to-use
interface which can be accessed in many different ways. You can use the remote control from the
command-line, with desktop icons or panel buttons, over the web with "rewwwoot" or by mapping your
multimedia keyboard to it so that you can control all supported applications with the same keys
(the way it was always meant to work).



Supported applications (v0.9)

  1. amarok
  2. aqualung
  3. audacious
  4. banshee
  5. bmp
  6. exaile
  7. gmusicbrowser
  8. juk
  9. kaffeine
  10. kmplayer
  11. kscd
  12. listen
  13. moc
  14. mpd
  15. mplayer
  16. noatun
  17. pytone
  18. quark
  19. quodlibet
  20. rhythmbox
  21. smplayer
  22. totem
  23. vlc
  24. xine
  25. xmms
  26. xmms2

Some of these apps requires a little extra love to work correctly while others have some quirks and limitations

that can be good to know about.


The ReMoot package

ReMoot is written in Perl and consists of three executables:

  • daemoot - the main program. It runs in the background and passes arguments to the targeted apps.
  • remoot - a command-line client. It contacts daemoot and is typically with key-bindings.
  • remoot-remote - a simple proof-of-concept graphical client to daemoot written in Tk.

Installation

Installing ReMoot is not difficult. We provide both generic archives and distribution specific ones.
Ask your distro package maintainers to include it in their repositories to make it even easier!
No configuration is required beyond installation.

Generic archives

1. Download the latest release as either a gzip or bz2 archive. Here we assume it is version 0.9.

2. Open the archive. For instance:

i) Locate the downloaded archive in a terminal.

ii) For the gzip archive, run:

tar xzvf remoot-0.9.tar.gz


For the bz2 archive, run:

tar xjvf remoot-0.9.tar.bz2


iii) Enter the newly extracted directory from a terminal:

cd remoot-0.9


3. Make the programs executable, if they are not already:

chmod +x daemoot remoot remoot-remote


4. Put the executables in your $PATH. For instance:

i) Switch to root or use sudo in the extracted directory and run:

cp *moo* /usr/bin/.

Debian package

1. Download the latest release as a deb package. Version 0.9 has been confirmed to install
fine on both Ubuntu 7.04 and Debian Sid.

2. Navigate to the package in a terminal and switch to root or use sudo and run:

dpkg -i remoot.deb

Usage

By using daemoot with or without remoot, only your own imagination sets the limits for how you
control you multimedia apps. The basic requirement is that the method should be able to pass
arguments to daemoot, for instance by executing the remoot client. ReMoot plays really nice with
key-mapping programs like LinEAK and Keytouch and integrates well with KDE's or Gnome's keymapping features. It can also be controlled over the web.

To pause any of the supported app you can just execute the command

remoot pause

while the app is playing. remoot then sends the argument "pause" to the daemon, which translates it to
whatever command the playing app understands and passes it on to that app. You can also control
the audio volume. Supported arguments are:

  • play
  • pause
  • playpause (toggles between play and pause)
  • stop
  • next (next track/file in most apps, fast forward in a few video players)
  • prev (previous track/file in most apps, reverse in a few video players)
  • voldown
  • volup
  • mute

remoot checks if the daemon is running and starts it for you if not. When the daemon is started it
generates a help-file (if one does not already exist) that it puts in its hidden directory in your home
directory, which could come in handy.

Chances are that you have more than one supported application open at any given time. The daemon
assumes that you only want to control and play one application at the time and uses a fairly elaborate
learning algorithm that we call "Do the Right Thing" to guess which one. Hopefully, once you have the

package installed and configured to your liking, you will forget about it being there at all as it always
does exactly what you expect :-)

If you feel like ruining the magic, please visit our Under the Hood section to learn more about
Do the Right Thing and other aspects, possibilities and limitations of ReMoot.


License

The ReMoot programs are licensed under the Perl Artistic License 2.0.

Contact

Please contact us if you have ideas, find bugs or have heaps of nicely documented code to donate.

Hugs and fanmail are also welcome. And money. Please use the Sourceforge contact resources,
such as the email list and forum, primarily. As the last option you can find our email addresses
in the packages..

Thanx

Thanx for using ReMoot!

Disclaimer

The code should be considered highly experimental. Do not run it as root or on production systems
or any systems with sensitive and important data, at least not before you have inspected the code
and confirmed that it is ok. You are responsible for any data loss caused by running these
experimental programs!