Getting Started
From Remuco
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
This installs the adapter as a plugin for Rhythmbox. Start Rhythmbox and activate the plugin Remuco in the menu Edit → Plugins.
Totem
Note: The Totem adapter requires Totem ≥ 2.22.
To install the Totem adapter run:
$ sudo make install-totem |
|
This installs the adapter as a plugin for Totem. Start Totem and activate the plugin Remuco in the menu Edit → Plugins.
TVtime
Note: The TVtime adapter requires TVtime ≥ 1.0.
To install the TVtime adapter run:
$ sudo make install-tvtime |
|
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 |
|
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 |
|
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/confto 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.
