Getting Started

From Remuco

Jump to: navigation, search

Image:start-big.png

Contents


In version 0.8.2 the install destinations changed so that we recommend you remove a previous version first. See the README for more information.

Ubuntu users may use a Launchpad package repository to install Remuco with a package manager (Synaptic, Aptitude).

Debian users may install Remuco from unstable.

Gentoo users can obtain an ebuild from Gentoo Bug #276587. Which player adapters are installed is controlled via USE flags.

Installation and Usage

Download

If you use a package manager as noted above, you still need to download as described here to get the client application!

Download and extract the latest Remuco package to a place of your choice (referenced below as place-of-your-choice).

On a command line, switch into the directory where you extracted the Remuco package:

$ cd place-of-your-choice/remuco-0.8.x

Now, as described below, install one or more player adapters and the client application.



Amarok

Note: The Amarok adapter requires Amarok 2.

To install the Amarok adapter run:

$ sudo make install-amarok

16px-Ubuntu.png 16px-Debian-icon.png Install package remuco-amarok in Ubuntu/Debian.

The Amarok adapter can be started with:

$ remuco-amarok

The best way to use the Amarok adapter is to let it start automatically when you log in to your Desktop session (it is in sleep mode when Amarok is not running).

Audacious

To install the Audacious adapter run:

$ sudo make install-audacious

16px-Ubuntu.png 16px-Debian-icon.png Install package remuco-audacious in Ubuntu/Debian.

The Audacious adapter can be started with:

$ remuco-audacious

The best way to use the Audacious adapter is to let it start automatically when you log in to your Desktop session (it is in sleep mode when Audacious is not running).

Banshee

Note: The Banshee adapter requires Banshee ≥ 1.4.

To install the Banshee adapter run:

$ sudo make install-banshee

16px-Ubuntu.png 16px-Debian-icon.png Install package remuco-banshee in Ubuntu/Debian.

The Banshee adapter can be started with:

$ remuco-banshee

The best way to use the Banshee adapter is to let it start automatically when you log in to your Desktop session (it is in sleep mode when Banshee is not running).

MPD

Note: The MPD adapter requires MPD ≥ 0.13.

To install the MPD adapter run:

$ sudo make install-mpd

16px-Ubuntu.png 16px-Debian-icon.png Install package remuco-mpd in Ubuntu/Debian.

The MPD adapter can be started with:

$ remuco-mpd

Once started, a configuration file will be created -- you probably want to adjust it to comply with your MPD setup.

Rhythmbox

To install the Rhythmbox adapter run:

$ sudo make install-rhythmbox

16px-Ubuntu.png 16px-Debian-icon.png Install package remuco-rhythmbox in Ubuntu/Debian.

This installs the adapter as a plugin for Rhythmbox. Start Rhythmbox and activate the plugin Remuco in the menu EditPlugins.

Totem

Note: The Totem adapter requires Totem ≥ 2.22.

To install the Totem adapter run:

$ sudo make install-totem

16px-Ubuntu.png 16px-Debian-icon.png Install package remuco-totem in Ubuntu/Debian.

This installs the adapter as a plugin for Totem. Start Totem and activate the plugin Remuco in the menu EditPlugins.

TVtime

Note: The TVtime adapter requires TVtime ≥ 1.0.

To install the TVtime adapter run:

$ sudo make install-tvtime

16px-Ubuntu.png 16px-Debian-icon.png Install package remuco-tvtime in Ubuntu/Debian.

The TVtime adapter can be started with:

$ remuco-tvtime

For navigating in TVtime's menu with the Remuco client, the keys on the client have special functions when using the TVtime adapter:

Client key Toggle playing Toggle repeat Toggle shuffle Play previous Play next Volume down Volume up
TVtime key MENU ENTER SHOW MENU SHOW MENU UP DOWN LEFT RIGHT

VLC

Note: The VLC adapter requires VLC ≥ 0.9.

To install the VLC adapter run:

$ sudo make install-vlc

16px-Ubuntu.png 16px-Debian-icon.png Install package remuco-vlc in Ubuntu/Debian.

The VLC adapter can be started with:

$ remuco-vlc

The best way to use the VLC adapter is to let it start automatically when you log in to your Desktop session (it is in sleep mode when VLC is not running).

Note: The VLC adapter only works if DBus control is enabled in VLC. The is true if VLC gets started like this:

$ vlc --control dbus

XMMS2

Note: The XMMS2 adapter requires XMMS2 ≥ 0.5.

To install the XMMS2 adapter run:

$ sudo make install-xmms2

16px-Ubuntu.png 16px-Debian-icon.png Install package remuco-xmms2 in Ubuntu/Debian.

This installs the adapter as a script in the system-wide XMMS2's startup directory /usr/share/xmms2/scripts/startup.d. On the next start of XMMS2 the script automatically gets copied into the user XMMS2 startup directory (usually ~/.config/xmms2/startup.d) so that it gets started and stopped automatically whenever XMMS2 starts and stops.

Note: The automatic copy of the script to the user startup directory seems to fail on some XMMS2 installations. In that case, please copy the script manually, for instance:

$ cp /usr/share/xmms2/scripts/startup.d/remuco-xmms2 ~/.config/xmms2/startup.d/




Client

The client requires a mobile device with JavaME support (MIDP ≥ 2.0, CLDC ≥ 1.1). If you use Bluetooth to connect to a player adapter, additionally JSR-82 (Java Bluetooth) must be supported. You can check these requirements at Sun's Jave ME Device Table or at the FPC Bench Result Dababase.


In the directory place-of-your-choice/remuco-0.8.x/client/app you find two files:

remuco.jar
the client application to install on your mobile
remuco.jad
a descriptor file which is needed additionally by some mobiles for installation

The concrete steps to install the client depend on your mobile, please instruct its manual for how to install JavaME applications.

Once installed, start the Remuco client application. Using the client should be quite obvious -- just try out everything that is possible ;).

Known Issues

Rhythmbox 0.12

In rare cases Rhythmbox 0.12 may crash when the Remuco plugin is activated (seen in Debian Testing/Ubuntu Jaunty).

This is not a Remuco bug but related to pygtk or pygobject. Work on this is in progress and tracked at Bug 2767502.

Sony Ericsson M600 / Symbian UIQ3

A user reported that Remuco 0.8 fails on a SE-M600 device while it worked with Remuco 0.7. I'll work on this issue once I have access to a M600 device.

Please give some feedback if it works on your M600 or Symbian UIQ3 device!

Troubleshooting

General
  • If you experience any problems first have have a look into the log file of the player adapter your are using (~/.cache/remuco/player/log - replace player with a specific player name).
  • In case this does not help to find and solve the problem, enable debug log by setting the option log-level in ~/.config/remuco/player/conf to DEBUG. Restart the player adapter and inspect the log again.
  • Additionally you may inspect the log messages on the client (there is an option/menu called Log).
  • If you are still lost, then it's time for the help forum.
Client
  • If the client fails to start on your device, although it meets all requirements, have a look at Client Customization for possible reasons and solutions.