Player Proxy

From Remuco

Jump to: navigation, search

A player proxy is the glue between the server and a specific media player. There are two types of player proxies - full player proxies and basic player proxies.

Contents

Full Player Proxies

Full player proxies provide all features possible with Remuco. Usually full player proxies actually are plugins of their corresponding media player and communicate with the server via DBus.

Remuco uses full player proxies for the following players: Rhythmbox, XMMS2.

See Player Proxy Writing Guide for more technical information about full player proxies.

How to install and make use of full player proxies fundamentally depends on a specific full player proxy. So there is no general information available here. Instead read the proxy specific pages (Rhythmbox, XMMS2).

Basic Player Proxies

Basic player proxies (BPPs) are the fast and easy way to attach a media player to the Remuco system. On the other hand they do not provide all features possible with Remuco.

BPPs are simple text files (suffixed .bpp) which describe how the Remuco server can interact with a media player on a command line basis. For instance they describe what shell command to run in order to toggle play/pause or to get the volume for a player.

Remuco uses basic player proxies for the following media players: Amarok, Banshee, Mpd, Totem.

Installation

BPPs must be placed in the directory ~/.config/remuco.

Usage

BPPs automatically get activated when the server starts. You can start the server with the following command:

$ remuco --start

For each installed BPP the server periodically checks if the corresponding player is running - if yes, it activates the BPP.

Writing a BPP

See Player Proxy Writing Guide.