Gentoo Plugin

emerge

Here the installation of a plugin is described on an example with the help of emerge. For a lot of plugins it is a precondition that one has imported the portage tree of gentoo.de doing the steps of GENTOO_Vdr_ebuilds.

First Step: Which plugin?

First one must find out which plugin has the needed functionality and how its name is. For that the best way is the page Plugins. On the subpages for the single plugins there is sometimes a hint for what to look at when installing it on Gentoo.

The name of the plugin is almost always created from the prefix

vdr-

and the title of the corresponding page in the wiki (naturally skipped the postfix -plugin).

The plugin Mailbox-plugin now gives the gentoo name vdr-mailbox (or longer media-plugins/vdr-mailbox, but the category media-plugins can almost everytime be skipped).

Second Step: Installation

The plugin now is installed with this command:

ACCEPT_KEYWORDS="~x86" emerge vdr-mailbox

With the statement ACCEPT_KEYWORDS="~x86" the newest available version (this can be also an alpha or beta version) gets installed. It is much easier for updates in the future to insert media-plugins/vdr-mailbox in the file /etc/portage/package.keywords.

Third Step: Configuration

The activate the plugin one has two equal ways:

Either one edits

/etc/conf.d/vdr

and adds mailbox to this line. This changes

PLUGINS=""

to

PLUGINS="mailbox"

Multiple plugins are sperated by spaces.

PLUGINS="mailbox dvd femon"

Or second possibility: One calls emerge like in the installation step:

emerge --config vdr-mailbox

Some plugins have an own configuration-file. This is then called /etc/conf.d/vdr.PLUGINNAME. e.g. for the Mailbox-Plugin /etc/conf.d/vdr.mailbox. The options inside here diverge from plugin to plugin and are documented directly inside this file.

After a restart of VDR one can configure the plugin (here the mailboxes) over the OSD.