XBMC - Dharma Guide

XBMC Dharma Guide

HenryFord

06/15/2011

©HenryFord 2011 Licensed under the Creative Commons Attribution-Noncommercial-Share Alike 3.0

http://creativecommons.org/licenses/by-nc-sa/3.0/



1 | P a g e X B M C – D h a r m a G u i d e – V e r s i o n 1 . 0 – H e n r y F o r d

Contents Contents .................................................................................................................................................. 1

Introduction ............................................................................................................................................. 2

XBMC ....................................................................................................................................................... 3

Download and Install XBMC ................................................................................................................ 3

Windows .......................................................................................................................................... 3

Mac OS............................................................................................................................................. 3

Linux ................................................................................................................................................ 3

Keyboard Binding ................................................................................................................................ 4

Setup the Sources ................................................................................................................................ 5

Movies ............................................................................................................................................. 5

TV-Shows ......................................................................................................................................... 7

Advanced Library Configuration ...................................................................................................... 8

Additional Settings .............................................................................................................................. 9

Library Settings ................................................................................................................................ 9

Customization (Skins!) ..................................................................................................................... 9

Networking and external access ................................................................................................... 11

Setup additional Add-ons .................................................................................................................. 11

Repositories ................................................................................................................................... 11

Extras ................................................................................................................................................. 11

Advanced-Launcher ....................................................................................................................... 11

Logo-/Tunes-Skins ......................................................................................................................... 17

Configure Gamepads ..................................................................................................................... 18

SABnzbd+ ............................................................................................................................................... 25

Sickbeard ............................................................................................................................................... 25

Installation and Setup ........................................................................................................................ 25

General .......................................................................................................................................... 26

Episode Downloads ....................................................................................................................... 28

Search Providers ............................................................................................................................ 30

Adding TV-Shows ............................................................................................................................... 33

Add New Show .............................................................................................................................. 33

Add Existing Show ......................................................................................................................... 34

Post-Processing ................................................................................................................................. 34


Couch Potato ......................................................................................................................................... 35

Setup.................................................................................................................................................. 35

General .......................................................................................................................................... 35

NZBs / Torrents .............................................................................................................................. 37

Providers ........................................................................................................................................ 38

Quality ........................................................................................................................................... 38

Renaming ....................................................................................................................................... 39

Extras ............................................................................................................................................. 40

Userscript ...................................................................................................................................... 40

Restart ........................................................................................................................................... 41

Add Movies ........................................................................................................................................ 41

Introduction Don’t worry; this is going to be short: This guide was created after a lot of people complained that

“getting into “XBMC was kind of difficult for them. Thus I decided to create this guide to help them –

so I do not have to explain it over and over again. This guide includes instructions for a fully

automatic PVR without actually owning a TV-Card. Also – it heavily relies on some stuff that may be

illegal in your country. Check your local copyright-laws whether they apply, if they do – go ahead and

decide for yourself if you want to continue. I take no responsibility.

At this point I also want to thank the community around the XBMC and the projects which rose in the

near context. Thanks go out to:

- Team XBMC – For creating the XBMC in all its glory

- Team sabNZBd+ - For creating a good UseNet-download-application

- Ruudburger – Creator of CouchPotato

- Midgetspy – Creator of Sickbeard

- Angelscry – Creator of the “Advanced Launcher” Add-On

They put a lot of work into this and deserve to be appreciated. Take that into account and consider

donating something, because all of the mentioned projects are completely community-driven open-

source projects and they do not take a cent for the supplied software.

Donations can be made to:

XBMC – Donation-Page

Sickbeard – Homepage with Donation-Button

http://xbmc.org/contribute/donate/

http://www.sickbeard.com/


Couch Potato – Homepage with Donation-Button

Sabnzbd – Donation-Page

I am sure they will appreciate your support.

Special Note:

In order to make XBMC what it is today, the communities around www.themoviedb.org and

www.thetvdb.com are also needed. You always can add information there, so go ahead and help out.

XBMC Homepage: http://www.xbmc.org

Download and Install XBMC You can get the XBMC here:

http://xbmc.org/download/

Windows

Click the Windows-Logo to get the newest stable Windows-Build for your machine. Download the

Setup-File and install it. It will also install the needed libraries (DirectX, C++), so it will take a little bit

to complete.

Mac OS

Download the current Mac-Version by clicking on the OSX-Logo (or – if you run a PPC – on the OSX-

PPC-Link beneath the logo) and save the DMG-File to your drive. Install the DMG by clicking on it.

Drag XBMC to your application folder as usual. You can delete the DMG-File after installation.

Linux

The installation varies between the different distributions of Linux. You may want to take a look at

the XBMC-Wiki; you’ll find instructions for the various distributions:

http://wiki.xbmc.org/index.php?title=Installing_XBMC_for_Linux

After the installation launch your XBMC. You will be presented with the following screen:

http://couchpotatoapp.com/

http://sabnzbd.org/contribute/#donate

http://www.themoviedb.org/

http://www.thetvdb.com/

http://xbmc.org/download/

http://wiki.xbmc.org/index.php?title=Installing_XBMC_for_Linux


You will notice that you cannot do anything right now, the Videos-Section is completely empty and so

is everything else. We are going to change that in the next step.

Keyboard Binding In order to control XBMC properly, you should know a few keyboard-bindings to get you started. This

will help you navigating through the XBMC and using its functions. It is important to know that the

XBMC uses different mappings for different views. So if you are playing a video in fullscreen the

button-mapping might change. I will show you some global mappings which will be used if no other

mapping is defined by the keyboard.xml-file. You can find all the proper commands which are used

by default on this XBMC-Wiki-Page:

http://wiki.xbmc.org/index.php?title=Default_Controls

I will list the common, global commands:

Key Action, Description

O Displays CPU usage and video diagnostic information

P Play

Space Pause

X Stop

F Fast Forward

R Rewind

Left-arrow Left

Right-arrow Right

Up-arrow Up

Down-arrow Down

http://wiki.xbmc.org/index.php?title=Default_Controls


Page Up Page Up

Page Down Page Down

Return Select

Backspace Parent Directory (Step back)

Q Current Queue

W Mark file as Watched

M Activate OSD Player Controls (while playing media)

S Activate Shutdown Menu

Esc Home menu

I Media Info

C Context Menu

Period Skip Next

Comma Skip Previous

Tab Toggles fullscreen modes (either visualization or video playback)

Print Screen Screenshot

Minus (-) Volume Down

Plus (+) Volume Up

Zero (0) Number0

One (1) Number 1

Two (2) Number 2

Three (3) Number 3

Four (4) Number 4

Five (5) Number 5

Six (6) Number 6

Seven (7) Number 7

Eight (8) Number 8

Nine (9) Number 9

End Shutdown XBMC

Setup the Sources This is where XBMC looks for your media-files. The Sources will determine the content of your library,

they are necessary in order for XBMC to index your Video -Files into the proper libraries. Be aware

that you always should name your video- and music-sources according to XBMC’s set. This will make

sure that you have the best possible experience with the XBMC. Let’s get started.

Movies

Before we are adding your files to your XBMC-Sources you should make sure that the files are named

properly. Ideally you have your movie-files all in one folder. It does not matter if there are subfolders

and/or single files in this directory. The best way however is to use subfolders for each movie you

have. The folder should then be named like the following Layout: “Movie Name (Release-Year)”. The

part “Release Year” is technically not necessary but it will make sure that XBMC scrapes the right


movie and you have the right movie in your library. If you currently have not sorted your movie-

directory, you can do this with the help of some additional tools which are available. Some free tools:

- XBNE - http://forum.xbmc.org/showthread.php?t=59800

- MediaCompanion - http://mediacompanion.codeplex.com/

- XMM2 - http://www.plyoung.com/projects/xmm2/

- Ember Media Manager - http://sourceforge.net/projects/emm-r/

- MythicalLibrarian - http://wiki.xbmc.org/?title=MythicalLibrarian (for MythTV-Recordings)

These tools also will generate usable NFO-Files for the XBMC. NFO-Files are little text-files in which all

information about the movie is stored in a XML-Layout. If XBMC finds a NFO-File inside a subfolder, it

will use the information from this NFO rather than downloading the information from the internet.

For some more information on NFO-Files head down, you’ll find a section dedicated to them. A neat

function of the XBMC provides the possibility to play two video-files as if they are merged to one file.

This is helpful for movies which contain multiple CDs. If you have the movie “The Matrix” for example

split into two files, you should name those files like “The Matrix.CD1.FileExtension” and “The

Matrix.CD2.FileExtension” (this will be done by the media managers mentioned above as well). When

scraping this movie to the library, XBMC will know that this is supposed to be one movie and will

index the both files only as one movie in your library. If you then play this movie via the library in

your XBMC both files will be played – the CD2 after CD1 ends obviously. You won’t even notice the

cut between those (unless the files have an overlay of course) two.

Back to the XBMC. To start adding a source for movies hit the “Videos” button in the home- You will

see a list of your CD-Drives and removable media-devices which are connected right now. You will

also find a Button “Add Source” – hit it in order to bring up the Source-Menu.

You will find a screenshot below, how that should look like:

http://forum.xbmc.org/showthread.php?t=59800

http://mediacompanion.codeplex.com/

http://www.plyoung.com/projects/xmm2/

http://sourceforge.net/projects/emm-r/

http://wiki.xbmc.org/?title=MythicalLibrarian


Hit the “Browse”-Button and locate your movie-location. Click “OK” and move to the Content-Screen.

It will look like this:

If you want to add your movies right now (you want to ;-)) hit the selection “Run automated scan”. If

you use subfolders in your main movie-folder you should set “Use folder names for lookups” and

“Scan recursively” too. Hit “Ok” – XBMC will now search for your stored movies with the Movie-

Scraper and adds the contents to your library. This will take a while.

TV-Shows

Before adding TV-Shows to XBMC you should complete the Sickbeard-Tutorial first. Click here to read

it now. Come back when Sickbeard is fully configured. Open up Sickbeard in your Browser and click

on the button “Manage”. A list of all your TV-Shows should be presented to you – click on the empty

field beneath “Rename”. This should mark all the “Rename”-Fields of the shows. Now click on

“submit” below. Use it in order to change your entire TV-Show-Collection to the right naming

convention for XBMC. Also – It will help you to actually sort your Collection and to make it more

accessible. With TV-Shows you also have the option to use locally stored NFO-Files for XBMC. In this

case XBMC will also use the provided information in the NFO-Files to check for your TV Shows. This

will make sure that you do not have problems with the scanning. Check the option in the sickbeard-

config if you want the Files to be created. Be aware that you should apply the naming-convention

“TV-Show-Name (Starting-Year)” to the subfolders holding your TV-Shows. This will make sure that

you do not get the wrong information.

Now head back to the XBMC and hit the “Add Source”-Button. Select your TV-Show-Directory and

click OK. In the “Content”-Screen you should then select “TV Shows”. Mark the option “Run

automated scan” if you want to. XBMC will now scrape all your Shows to your library.


Advanced Library Configuration

Using advanced “nfo”-files

(thanks to pseudo7)

As mentioned in the steps above NFO-files can be used by the XBMC to correctly read the

information about your files instead of relying on online-data. But you can do more with those NFO-

Files then simply replacing the online-stored information. An example is grouping movies into a set.

For example:

• Die Hard

• Die Hard 2

• Die Hard With a Vengeance

• Live Free or Die Hard

These films are all part of the “Die Hard”-Quadology, however because “Live Free or Die Hard” begins

with an “L” rather than a “D” it is ordered elsewhere and not nearby all the other “Die Hard”-Movies.

You can add information to your NFO-File of the movie to correct this issue:

<xml>

<movie>

<title>Live Free or Die Hard</title> (Title of the movie)

<set>Die Hard Collection</set> (Set name to which it belongs)

<sorttitle>Die Hard 4</sorttitle> (Title within the set)

</movie>

http://www.themoviedb.org/movie/1571

</xml>

Repeat these steps for the other Die Hard films, re-scrape and they should display as one movie set

in your library.

NFO-Files can influence many aspects of XBMC’s library. For more information visit the XBMC-Wiki:

http://wiki.xbmc.org/index.php?title...ining_XML_data

Automatic cleaning of the library

If you delete a lot of movies/TV Shows after you have watched them, you will notice that the XBMC

will not clean these files if you launch the Library-Update. You can erase those movies only if you pick

the “Clean Library”-Function in the settings-menu. Another solution however would be to put a file

“advancedsettings.xml” into your XBMC-Userdata-Folder. For Windows just hit “Windows-Key” + “R”

and type in “%AppData%/XBMC/userdata”. Create a new text-file with the following content inside

this directory:

<advancedsettings>

<videolibrary>

<cleanonupdate>true</cleanonupdate>

</videolibrary>

</advancedsettings>

Rename the file to “advancedsettings.xml” and restart your XBMC. Your XBMC will now clean your

video-library every time it updates it.

http://wiki.xbmc.org/index.php?title=Import_-_Export_Library#Video_nfo_Files_containing_XML_data


You can do a lot more with the “advancedsettings.xml” – for more information check the XBMC-Wiki:

http://wiki.xbmc.org/index.php?title=Advancedsettings.xml

Additional Settings

Library Settings

Navigate back to the Home-Window (hit Backspace to get back) and open up the Settings-Menu.

Open the “Video”-Tab and click on the Library-Tab. I recommend using “Automated Scan on

Startup”, this way you make sure that every new file you add will be there after you restart your

XBMC. I will explain later how you can start the scan by yourself. Remember the “Clean Library”-

Button – if you delete files out of the folders you specified under your Sources it still will show up in

the library of XBMC, even after you scanned for new content. To remove dead entries hit the button

“Clean Library”, it will remove them. Be aware: If you added a removable device as a source and you

hit the “Clean Library”-Button while the device is disconnected you can lose your library.

Customization (Skins!)

You can modify the behavior and appearance of your skin by applying extended settings. Each skin

has specific settings; you have to choose what you like. Generally you can disable/enable specific

Home-Menu-Buttons and more. Play a little bit with the settings if you are not sure and see what you

like. You should in any case activate the home-screen menus “TV Shows” and “Movies” (accordingly

to your sources) – because this are the library-sections which you want to use later.

Every skin has also own views for the different media-sections (TV Shows, Movies, Music) between

which you can choose in order to customize everything for your needs. This is also a little bit of a

“Trial & Error”-Game – switch between the different views in order to find out what you like most. In

order to apply a new view for a specific section, navigate back to the home-menu and click on the

“Movie”-Tab for example. Now – in the movie section – click the Right-Arrow-Key on your keyboard.

http://wiki.xbmc.org/index.php?title=Advancedsettings.xml


This will open up the side-menu, where you can choose the view. In this example you see the view

“Thumbnail” selected:

You can apply complete new skins to your XBMC which will change the look and feel of XBMC

entirely. I recommend the Night-Skin, although you might prefer something else. To install a new

skin, open up the “Appearance”-Settings. You will find an option “Skin” – click here to open the Skin-

Selector. Click on the “More”-Button at the bottom of the selector. Choose the skin you want to try

and it will download. After the download completes you will be asked to switch to the skin – choose

what you like.


Networking and external access

XBMC has advanced features available. Several external applications can make use of these features

in order to communicate with the XBMC. They also have the possibility to actually control the XBMC.

These advanced features require you to enable the http-access of the XBMC because it is not enabled

by default. This can be done under “Settings” -> “Network”. You also have the possibility to share

your libraries via UPnP. This again gives you the opportunity to use DLNA-certified devices with your

XBMC – this way you can share and stream the contents of your library. Be advised though: XBMC

will share nothing which is not indexed in your library. A list of compatible software/hardware can be

found here (it may be incomplete…):

http://wiki.xbmc.org/index.php?title=UPnP_Sharing

In order to use the Webserver of XBMC properly I advise to use a predefined IP instead of obtaining

one via DHCP. This way you’ll always know where your XBMC is located. This also comes in handy

when using Sickbeard, Couch Potato and sabNZBd. This however is not required – you always can

access the XBMC, Sickbeard, Couch Potato and sabNZBd via “localhost” (if you do not change the

default settings that is).

After enabling webaccess you can secure your XBMC with a username and a password. Just enter the

values in the boxes below the option. By default XBMC restricts access from the network to your

machine. Every request coming from another machine than the XBMC’s machine will be rejected.

You can lift this restriction by enabling the “Allow programs on other computers to control”-Option

in the network-settings.

Setup additional Add-ons You can expand your XBMC-Experience by installing Add-Ons/Plugins. Since XBMC Dharma we have a

repository installed from which we can choose additional Add-ons/Plugins. You can find this sub-

section on the home-screen. Hit the “Add-On”-Section in XBMC and choose “Get Add-ons” – browse

and install what you like.

Repositories

You have the option to install extended repositories which will enhance the available Add-Ons for

your experience. To find repositories just check this site in the XBMC-Wiki:

http://wiki.xbmc.org/index.php?title=Unofficial_Add-on_Repositories

Download the Zip-File, open up the “Settings” -> “Add-Ons”-Menu and choose the option “Install

from Zip-File”. From the dialog-window pick the downloaded zip-file. After the installation you can

choose Add-Ons from this repository. If you do not see any Add-Ons after you added the Repository,

navigate to the Repository (“Add-Ons” -> “Get Add-ons”); bring up the context-menu and hit

“Refresh Repository” in order to load available entries to the database.

Extras

Advanced-Launcher

The Advanced Launcher is an add-on which was developed by XBMC-Community-Member Angelscry.

This Add-On enables you to launch installed programs on your computer from inside the XBMC.

Through this Add-On you practically can build a library from programs/games which are installed on

http://wiki.xbmc.org/index.php?title=UPnP_Sharing

http://wiki.xbmc.org/index.php?title=Unofficial_Add-on_Repositories


your machine. The Add-On also makes use of some advanced features for emulator-applications. You

can add specific Command-Line options in order to browse and launch your games which are running

through an emulator. This again gives you the opportunity to index your Nintendo 64 games for

instance which are present as ROM-Files on your system and launch them with the proper emulator.

The Add-On also features scraping mechanisms. These will scrape the information about your games

like XBMC does with TV Shows and Movies. In order to enable the Add-On I recommend adding the

repository to your XBMC. Once the repository is added, Advanced Launcher will update itself if you

install it. This way you stay on top of current developments.

In order to install the Repository go to your settings-menu and open up “Add-Ons”. You should see a

line “Install from zip-file”. Choose this option and in the dialog that appears navigate to the file you

downloaded from this location:

http://code.google.com/p/xbmc-advanced-

launcher/downloads/detail?name=repository.angelscry.xbmc-plugins.1.2.0.zip

Afterwards click on the Button “Get More…” and choose the newly installed repository. Under

“Program Add-Ons” you should find an entry “Advanced Launcher” – click it in order to install it. If

you do not see any entries in this repository, navigate back and open up the context menu while

highlighting the right repository (It should be “Angelscry Add-On Repository”) and choose the option

“Force Refresh” – now go back inside the repository, you should see everything now. After the

installation completes head to the next section.

Hint

For the Windows-Version of XBMC you should disable the fullscreen for “Advanced Launcher” to

work properly. Head to “Settings” -> “System” in your XBMC and click on the menu “Video Output”.

You will see a line “Use a fullscreen window rather than true fullscreen” – set this option active.

Configuration

You have some options available for Advanced Launcher which will help you with your setup. Click on

the Add-On again in order to bring up the “Add-On-Page”. You will find an option “Configure” inside

it. After you clicked this option you will be presented with the options-screen of the Advanced

Launcher. Configure it to your likes (I heavily borrowed from the tutorial at

http://www.gwenael.org/forum/viewtopic.php?id=3 ):

General

This menu contains general configuration options for Advanced Launcher.

Launchers Thumbs Default Path

Define the default folder in which your thumbs are being stored (more in the section

Thumbnail/Fanart/Rom-Folders below). If not defined Advanced Launcher will ask for the folder-path

whenever you create a new launcher.

Launchers Fanart Default Path

Define the default folder in which your fanarts are being stored (more in the section

Thumbnail/Fanart/Rom-Folders below). If not defined Advanced Launcher will ask for the folder-path

whenever you create a new launcher.

http://code.google.com/p/xbmc-advanced-launcher/downloads/detail?name=repository.angelscry.xbmc-plugins.1.2.0.zip

http://code.google.com/p/xbmc-advanced-launcher/downloads/detail?name=repository.angelscry.xbmc-plugins.1.2.0.zip

http://www.gwenael.org/forum/viewtopic.php?id=3


Action on Playing Media

Define an action that will be executed if you are currently playing media when you launch an

application. The available options are: stop (stop the current playback when launching an

application), put into pause (pause current playback), or let to play (just let the current playback

continue).

Recursive Scan

Activate or deactivate the capability or Advanced Launcher to recursively scan items in subfolders.

Data & Infos

This menu contains configuration options for the data scrapers.

Scraper Source

Define the scraper-source. The data-scraper will look here in order to receive information about your

stored media-files. Results may differ depending on the kind of games you scrape.

Import during scan

Select which method will be used to import the data (when you run a scan for new items): None

(nothing will be imported), Semi-automatic (you will be asked to select from a list of results) and

Automatic (will automatically select the first matching result).

Ignore BIOS Files

This option is dedicated for MAME games. When activated, Advanced Launcher will automatically

ignore any detected BIOS files during folders scan.

Clean Items Titles

Activate or deactivate the clean title option. For example, the title “Alien Invaders (1983)(UA

Ltd.)*aka Alien aka Les Envahisseurs Etrangers+” will be displayed as Alien Invaders. Any text after

brackets will be ignored.

Titles formatting

When activated any articles at the beginning of a title (like "The", "An" or "A") will be placed at the

end of the title.

Covers & Thumbs

This menu contains configuration options for the thumb-image-scraper.

Scraper Source


stored media-files. Results may differ depending on the kind of games you scrape.

Thumbs Region

Select the geographic region (America, Japan or Europe) for the box-art. If this is not activated the

first found thumbnail will be used.

Images Size

Select the resolution (size) of the images which will be downloaded while scraping.


Import during scan

Select which method will be used to import the data (when you run a scan for new items): None



Overwrite Existing Files

If this option is selected, existing thumbnail images will be overwritten by new scraped ones.

Screen & Fanarts This menu contains configuration options for the fanart-image-scraper.

Scraper Source


stored media-files. Results may differ depending on the kind of games you scrape

Images Size

Select the resolution (size) of the images which will be downloaded while scraping.

Import during scan

Select which method will be used to import the fanarts (when you run a scan for new items): None



Overwrite Existing Files

If this option is selected, existing fanart images will be overwritten by new scraped ones.

Debug Menu

This menu contains configuration options for debugging Advanced Launcher. It could be used by

advanced users during the built-up of their XBMC/Advanced Launcher/Scripts/Executable Application

system.

Show Batch command windows

This option show/hide the window display of started .BAT scripts by advanced launcher on windows

operating system.

Sources

The “Advanced Launcher”-Add-On uses your program-sources. In order to add a source to this

specific type you have to do the following: Go back to your home-screen and select the “programs”

item (assuming you are using the “Confluence”-Skin which is default) - do not open the menu-item! -

and click on the arrow next to the title “Programs”. A little menu should extend – select “Files” in this

menu. In the next screen add a source via the “Add Source”-Button. Now technically it does not

matter what you add as a source. In order to use your whole hard-drive just add the whole hard-

drive to the sources, you won’t have any side-effects (except you will have to navigate more while

creating new launchers).

Thumbnail/Fanart/Rom-Folders

I recommend using separate standard-folders. Create a folder on your hard-drive for the “Advanced

Launcher”-Thumbnails and –Fanarts. Advanced Launcher can download those images automatically


while scraping for new games but more on that later. The Thumbnails represent the Box-Arts of the

several games (like the poster in the movie-section) and the Fanarts are exactly the same as in the

video-library. Several Skins have own views defined for Advanced Launcher, you can use them in

order to make use of the advanced features like Fanarts. It is also recommended that you keep the

ROM-Files in a folder, where you have subfolders for the different gaming systems. So you would

have a Folder “ROM-Files” with the subfolders “N64” and “PS2” for instance – this way you can

handle the setup in a quicker, easier way. If you want to add Windows-Games to your Advanced

Launcher I also recommend using a subfolder inside the ROM-Folder for shortcuts. Place a shortcut

(an “.lnk”-file – note it is an “l” as in “low”) to the exe-file of the games you want to add inside this

folder.

Adding a Launcher

When you run Advanced Launcher for the first time (click on the programs item in the home-menu in

order to bring it up) it will ask you to add a launcher. You will be presented with two different

choices: “Standalone” and “File launcher”. For explanation: The “Standalone” simply runs an

executable which sits on your hard-drive while the “File launcher” is used to start an application with

a special file passed to it. So for example you will run an emulator with a ROM-File passed to it, so

that the emulator will then begin to run the ROM you passed to it. In order to use this feature with

an application, this application has to understand command-line arguments.

The general configuration of those two launchers:

Standalone Launcher

1. Select the “Standalone (normal PC executable)“ option

2. Browse and select the executable file of the application you want to start

3. In the next window you can pass command-line arguments. If the application you want to

run does not need any arguments or does not support them you can leave this field blank.

Otherwise just fill in the argument you have to pass.

4. This title will be used when viewing the application in Advanced Launcher.

5. Choose the game platform. This indicates the platform of your game-system for the image-

/data-scrapers. If you do not add a game but an application, this option does not matter.

If you did not configure Advanced Launcher to use default fanart- and thumbnail-folders you have to

do these steps too, otherwise you’re through at this point:

6. Select the thumbnail path. This is the folder where the thumbnail image of the launcher will

be downloaded to. If there is already an image (jpeg, gif, png or bmp format) with the same

name as the executable file (can include the _thumb suffix),, this image will be automatically

used for the launcher.

7. Select the fanart path. This is the folder where the fanart image of the launcher will be

downloaded to. If there is already an image (jpeg, gif, png or bmp format) with the same

name as the executable (can include the _fanart suffix), this image will be automatically used

for the launcher.

File launcher

(You’ll find more specific explanations on the items below – indicated with a *)


1. Select the “File launcher (e.g. game emulator)“ option.

2. Browse and select the executable file of the application you want to use (the emulator’s

“exe”-file for instance)*.

3. Enter the arguments you want to use with the application**. To fill these arguments you

have the possibility to use 5 variables:

%rom% : this tag will be replaced by the complete path of the file.

%romfile% : this tag will be replaced by the filename (name + extension).

%romname% : this tag will be replaced by the name of a file (name without extension).

%appath% : this tag will be replaced by the folder path of started executable file.

%rompath%: this tag will be replaced by the folder path of launched files.

4. Select the folder containing the file which will be launched with the application you choose

(the folder of your ROM-Files for instance – we’ll call this folder ROM-Folder from this point

onwards)

5. Indicate the files extensions that will be listed by the launcher. The extension must be

separated using the | character***.

6. Indicate the title of the launcher. The Launcher will be displayed using this defined title.

7. Choose a platform. The selected option will correspond to the platform system of the started

application or emulated system. This option will be used by the scrapers to identify the

games in the ROM-Folder****.

8. Select the thumbnails path. This folder contains all the thumbnails of the items inside the

ROM-Folder not of launcher itself! If there is already an image (jpeg, gif, png or bmp format)

with the same name as an item in the folder you defined (including the _thumb suffix) this

image will be automatically used with that item.

9. Select the fanarts path. This folder contains all the fanarts of the items inside the ROM-

Folder not of launcher itself If there is already an image (jpeg, gif, png or bmp format) with

the same name as an item in the folder you defined (including the _thumb suffix) this image

will be automatically used with that item.

*= If you want to add Windows-Games just choose any application, it does not matter what you

select, the launcher will always launch the shortcut which is placed in the directory.

**= The arguments are defined by your application. If you use an emulator for instance, there is the

highly possible chance that it can use command-line-arguments to pass a certain file. So normally you

could just open a command-line window in Windows and type something like “Path\to\emulator.exe

–s Path\to\ROM-File.rom” to launch a desired ROM-file inside the emulator. Advanced Launcher

makes use of those command-line arguments. So in this case it would be the argument “-s” followed

by the path to the actual ROM-File which is needed by the emulator to launch directly to load a ROM.

You then should type the following into the argument-textbox: “-s %romfile%”

If you do not know what command-line arguments you can use with what application you should

look on the page of the emulator. It most likely will explain the command-line usage somewhere in

the manual or the wiki.


***= For Windows-Games type “lnk” (“l” as in “low”) in order to start the right applications.

Otherwise choose the file-extension of the ROM-Files. If you have more than one file-extension per

file-type you can add multiple extension, separated with the “|”-character.

****= For Windows-Games choose “IBM PC Compatible”

You will notice that after adding a “File launcher” you have no items in it, regardless of the contents

of the ROM-Folder. This is because Advanced Launcher needs to be instructed to add the items to

the launcher. Highlight the specific launcher in Advanced Launcher and open up the Context-Menu

(“c” on your keyboard) – pick the item “Add Items” from the list. In the next step you will be asked

how the items in that folder should be scraped. In “automatic”-mode Advanced Launcher will scrape

all items in the folder automatically using the scrapers you defined in the configuration. Advanced

Launcher will use the best matching title and does the rest alone (including the import of Thumbnails

and Fanarts). If you pick the manual-mode Advanced Launcher will prompt you for an item. Specify

an item you want to add and Advanced Launcher will scrape it. You could also choose an item which

is not located in the ROM-Folder but somewhere else. This can take a while – of course depending on

the contents of your ROM-Folder. After it finishes importing, the File launcher will open itself and

you’ll see all the scraped items.

Advanced

Look at this post for more features and a take on how to use them:


In order to make full use of the Advanced Launcher it is probable that you want an item for it on the

home-screen so you do not have to go to “Programs -> Add-Ons” every time. Most skins allow you to

add items to the home-screen which are present in you “Favorites”-File. To add Advanced Launcher

itself to your list of favorites navigate to “Programs -> Add-Ons” and highlight “Advanced Launcher”,

then bring up your context-menu and pick the item “Add to favorites”. You also have the possibility

to add the specific launchers to your favorites. Just open Advanced Launcher, highlight the specific

launcher and open up the context-menu. Pick here “Add to favorites” as well.

Now get back to your settings-menu and choose the option “Skin” from the list. Open up the section

for “Custom Home” – you can now pick individual home-screen items to display.

Logo-/Tunes-Skins

There are several skins with advanced features which can be applied to your TV-Library. Your skin

may support either TV-Show-Logos or TV-Show-Tunes. A logo should be self explanatory – it is a title-

image for the specified show. The Tunes will play as soon as you navigate to one of your show (e.g. If

you have a show called 30 Rock and a proper tunes-file in the folder of 30 Rock, the tune will play as

soon as you hit the “30 Rock”-entry in the library.

For both of those features most supported skins have built-in support and scripts in order to get the

necessary stuff. Search for an option “Run logo script” and/or “Run tunes script” which will then

download the necessary files in order to view the advanced features. You may have to apply these

features in additional settings of your skin.



Bear in mind that both features generally require some “hacking” on the skin-developers end. If you

have any problems with the scripts, please report them to the maker of these scripts. XBMC by

default does not have any support for those features built in.

Configure Gamepads

This is an explanation of the various Keymap-Files. The Keymap-Files control in which way your

Gamepad will interact with the XBMC if it is connected. You can map any button to a lot of actions in

XBMC. This way you are able to use your XBMC in a more comfortable way.

This guide shows the steps for an Xbox-360-Controller but can be applied to every Gamepad which is

recognized and the proper driver is installed...

Important

If your controller does not work or/and you are using XBCD for your controller, you have to check the

correct button-assignments which are used by SDL. Start your XBMC and open up the settings. Go

into the system-settings and click on “Debug”. Enable the Debug-Logging. Now press every key on

your gamepad and remember in which order you pressed them (better yet – write it down). Quit

XBMC and hit “Windows-Key” + “R” on your keyboard. In the little text-box that appears write

“%APPDATA%\XBMC\” and hit Enter. Open up the file “xbmc.log” with a text-editor. You then should

see something like the following:

NOTICE: Enabled Joystick: XBOX 360 For Windows (Controller) NOTICE: Details: Total Axis: 5 Total Hats: 1 Total Buttons: 10

And the buttons which have been pressed are below. Now – it is important that you notice the

correct Joystick-Name, because we will need it later. Also write down the button-assignment which is

used by XBMC (compare your notes in which order you pressed them and you should be able to

match them).

For the Xbox-360-Controllers (Wired and Wireless) the Button-Layout is the following:

Button id 1 = A Button id 2 = B Button id 3 = X Button id 4 = Y Button id 5 = Left Shoulder Button Button id 6 = Right Shoulder Button Button id 7 = back Button id 8 = start Button id 9 = left stick button Button id 10 = right stick button axis limit="1" id="2" Up on left stick axis limit="+1" id="2" Down on left stick axis limit="1" id="3" Left on left stick axis limit="+1" id="3" Right on left stick axis limit="1" id="1" Left Trigger axis limit="+1" id="1" Right Trigger


axis limit="1" id="4" Up on right stick axis limit="+1" id="4" Down on right stick axis limit="1" id="5" Left on right stick axis limit="+1" id="5" Right on right stick hat id="1" position="up" Up on DPAD hat id="1" position="right" Right on DPAD hat id="1" position="down" Down on DPAD hat id="1" position="left" Left on DPAD

Simple steps to create your own keymap.xml:

1. Go to your XBMC-Folder and open the subfolder “system\keymaps”

2. Copy the Xbox-Joystick-XML-File

3. Hit “Windows-Key” + “R” and type “%APPDATA%\XBMC\userdata\keymaps”

4. Paste the copy of the XML-file into this folder

5. Open the XML-File with a file-editor

6. Replace everything after the tag “<joystick name=” and before the “>” with the name of the

controller you wrote down before.

7. Create/Change the nodes for your needs. Check the Wiki for Instructions (more below).

8. Done, you should be up and running! (Note: You must restart the XBMC in order to apply the

changes you made)

Good to know

Here is a list of actions you can use:

http://wiki.xbmc.org/index.php?title=Keymap.xml#Actions

The full list of actions is here:

http://xbmc.svn.sourceforge.net/view...pp?view=markup

Look at the part below "static const ActionMapping actions[] =" .

On the left side you find the name to use for the action, on the right side the action which is

executed. You can also run XBMC's internal commands, just put "XBMC." before function

(XBMC.Function).

A list of commands is here:

http://wiki.xbmc.org/index.php?title=List_of_Built_In_Functions

And a list of available windows (for the “OpenWindow”-Function):

http://wiki.xbmc.org/index.php?title=Window_IDs

Example 

<keymap>

<global>

<joystick name="Controller (XBOX 360 For Windows)">

<altname>Controller (Xbox 360 Wireless Receiver for Windows)</altname>

<button id="1">Select</button>

<button id="2">ParentDir</button>

<button id="3">FullScreen</button>

<button id="4">ContextMenu</button>

<button id="5">Stop</button>

<button id="6">Pause</button>

<button id="7">PreviousMenu</button>

<button id="8">XBMC.ActivateWindow(settings) </button>

<button id="9">Playlist</button>

<button id="10">XBMC.UpdateLibrary(video)</button>

<hat id="1" position="up">Up</hat>

<hat id="1" position="down">Down</hat>

<hat id="1" position="right">Right</hat>

<hat id="1" position="left">Left</hat>

<axis limit="-1" id="4">VolumeUp</axis>

<axis limit="+1" id="4">VolumeDown</axis>

<axis limit="-1" id="5">AnalogSeekBack</axis>


<axis limit="+1" id="5">AnalogSeekForward</axis>

<axis limit="-1" id="3">ScrollDown</axis>

<axis limit="+1" id="3">ScrollUp</axis>

</joystick>

</global>

<Home>



<button id="8">XBMC.ActivateWindow(shutdownmenu)</button>

</joystick>

</Home>

<FullscreenVideo>





<button id="3">FullScreen</button>

<button id="4">SkipNext</button>

<button id="5">CodecInfo</button>

<button id="6">ShowTime</button>

<button id="7">Info</button>

<button id="8">OSD</button>

<axis limit="-1" id="3">AnalogFastForward</axis>

<axis limit="+1" id="3">AnalogRewind</axis>

<hat id="1" position="up">BigStepForward</hat>

<hat id="1" position="right">StepForward</hat>

<hat id="1" position="down">BigStepBack</hat>

<hat id="1" position="left">StepBack</hat>

</joystick>

</FullscreenVideo>

<FullscreenInfo>



<button id="7">Close</button>


</joystick>

</FullscreenInfo>

<PlayerControls>






</joystick>

</PlayerControls>

<MusicOSD>





</joystick>

</MusicOSD>

<VisualisationSettings>





</joystick>

</VisualisationSettings>


<VisualisationPresetList>





</joystick>

</VisualisationPresetList>

<SlideShow>





</joystick>

</SlideShow>

<SelectDialog>





</joystick>

</SelectDialog>

<VideoOSD>






</joystick>

</VideoOSD>

<OSDVideoSettings>






</joystick>

</OSDVideoSettings>

<OSDAudioSettings>





</joystick>

</OSDAudioSettings>

<VideoBookmarks>





</joystick>

</VideoBookmarks>

<ContextMenu>






</joystick>

</ContextMenu>

<AddonInformation>






</joystick>

</AddonInformation>

<AddonSettings>





</joystick>

</AddonSettings>

<TextViewer>





</joystick>

</TextViewer>

<MyPicturesSettings>





</joystick>

</MyPicturesSettings>

<MyProgramsSettings>





</joystick>

</MyProgramsSettings>

<MyWeatherSettings>





</joystick>

</MyWeatherSettings>

<MyMusicSettings>





</joystick>

</MyMusicSettings>

<SystemSettings>





</joystick>

</SystemSettings>

<MyVideosSettings>






</joystick>

</MyVideosSettings>

<NetworkSettings>





</joystick>

</NetworkSettings>

<AppearanceSettings>





</joystick>

</AppearanceSettings>

<Profiles>





</joystick>

</Profiles>

<systeminfo>





</joystick>

</systeminfo>

<shutdownmenu>





</joystick>

</shutdownmenu>

<submenu>





</joystick>

</submenu>

<MusicInformation>





</joystick>

</MusicInformation>

<MovieInformation>





</joystick>

</MovieInformation>

<LockSettings>






</joystick>

</LockSettings>

<ProfileSettings>





</joystick>

</ProfileSettings>

</keymap>

SABnzbd+ Homepage: http://sabnzbd.org/

Since the documentation around SAB is very well done and helpful, I won’t do anything on SABnzbd+

besides pointing to the right direction. Download the latest Windows build at:

http://sabnzbd.org/

After the download check the Setup Walkthrough – it will help you get things up and running:

http://wiki.sabnzbd.org/quick-setup

This may be interesting in the context as you may want to use the PP-Script of Sickbeard (more on

that later):

http://wiki.sabnzbd.org/configure-categories

http://wiki.sabnzbd.org/configure-directories

Sickbeard Homepage: www.sickbeard.com

Installation and Setup Sickbeard is fairly easy to handle. Download the latest build from the Sickbeard-Homepage:

www.sickbeard.com

Just unzip it and run “sickbeard.exe” – You can now access your Sickbeard via the Web-Interface,

which should be reachable under http://localhost:8081 in your Web browser. Please note that the

first time you want to show Sickbeard's-Page it runs a little bit. Just stay calm – eventually the site

will pop up.

After you reached the Web-Interface you want to configure everything before you put in your

already existent TV-Shows. For the sake of this manual, I’ll just go ahead and copy the content from

http://www.sickbeard.com/config.html into this document. This was not done by me, but by the

Sickbeard-Community and the guide is very good. Note that everything may look a bit different on

your end. In the newer updates of Sickbeard you will find that Twitter-Notifications are actually

working, etc.

http://sabnzbd.org/

http://sabnzbd.org/

http://wiki.sabnzbd.org/quick-setup

http://wiki.sabnzbd.org/configure-categories

http://wiki.sabnzbd.org/configure-directories



http://localhost:8081/

http://www.sickbeard.com/config.html


General

Misc

1. Logging directory

The directory where you want your logs to be stored

2. Create Metadata

If checked, Sick Beard will generate NFO files for use with XBMC (and other compatible HTPC

applications)

3. Create Images

If checked, Sick Beard will download posters, fanart, and tbn for XBMC


4. Launch browser on startup

If checked, Sick Beard will open the GUI homepage in your browser when you start it.

5. Notify when new versions are available

If you’re running the Windows binaries, Sick Beard will let you know when a new version is available

Web Interface

6. HTTP Port

The port you want Sick Beard to run on

7. Enable HTTP log

If checked, Sick Beard will tell cherrypy to place a log in your log folder

8. Sick Beard username

Username required to log in to the Sick Beard web GUI (Leave blank for no authentication)

9. Sick Beard password

Password required to log in to the Sick Beard web GUI (Leave blank for no authentication)

Defaults

10. Initial Quality

When you add a show it will be assigned this quality by default.

11. Use Season Folders

When a show is added its "use season folders" setting will be this.

Episode Naming

12. Include show name

If checked, the name of the show will be part of the filename

13. Include episode name

If checked, the name of the episode title will be part of the filename

14. Use periods

If checked, periods will be used instead of spaces

15. Separator Style

Choose your separator style

16. Number Style

Choose your number style

17. Multi-episode Style

Choose the style of multi-episode files


Episode Downloads

Episode Search

1. NZBs

If this is unchecked then the search will not look for NZBs at all, no matter what providers you have

selected.

2. Torrents

Sick Beard will only search for torrent files if this is checked.

3. Search Frequency

The number of minutes between searches (min 10)

4. Backlog Search Frequency

The number of days between backlog searches


NZB/Torrent Options

5. NZB Action

Black hole: saves NZBs to a folder that your newsgroup client is watching

SABnzbd: passes the NZB URLs directly to SABnzbd so it can download them itself. For this your

SABnzbd section must be configured properly and you must be running SABnzbd 0.5+

6. NZB Black Hole

If black hole is selected then NZB files will be saved to this folder. Your newsgroup client should be

configured to watch this folder and automatically pick up NZBs inside.

7. Usenet Retention

The number of days of retention that your UseNet provider offers. NZBs older than this won't be

downloaded.

8. Torrent Black Hole

If torrents are enabled then they will be downloaded to this folder. Your torrent client should be

configured to watch this folder and automatically pick up any torrents it finds.

SABnzbd

These settings are required if you have your NZB Action set to "SABnzbd". If you are using Black hole

you can leave this section blank.

9. Username

Your SAB auth username

10. Password

Your SAB auth password

11. API Key

The API key specified in your SAB config

12. Category

The name of the category you want your downloads to go to ("TV" is default)

13. IP/Port

The address of your SAB host - no http:// or /sabnzbd/ required. Only IP/port, e.g.

192.168.1.100:8080

Post-Processing

14. TV Download Dir

The folder where your download client puts your TV downloads (only needed if you're not using SAB

post processing OR if SAB and Sick Beard are on different PCs)

15. Keep folder

If checked, Sick Beard won't delete the episode folder and any extra files (original nfo, sfv, etc)

16. Rename episodes

If checked, Sick Beard will rename the episode according to the naming settings in General

17. Scan & Process TV Download Dir

Will scan your TV Download Dir and attempt to post-process every file it finds. NOTE: If you use

sabToSickbeard w/ SABnzbd+ do not check this!


Search Providers

Provider Priorities

1. Provider Priorities

Drag the providers into the order you want them to be searched

NZBs.org

Log in and go to http://nzbs.org/index.php?action=rss

Near the top there is a string like:

Add this string to your feed URL to allow NZB downloads without logging in:

&i=12345&h=abcdef1234567890fedcba1234567890

The numbers after &i= are your UID, the string after &h= is your hash (UID=12345 and

hash=abcdef1234567890fedcba1234567890 in the example above)

2. Enable NZBs.org

Check to enable searching for episodes on NZBs.org

3. NZBs.org UID

Your NZBs.org UID

4. NZBs.org hash

Your NZBs.org hash

http://nzbs.org/index.php?action=rss


NZBs'R'US

Log in and go to http://www.nzbsrus.com/rss.php

In the "User defined" select box at the bottom, click on any option

At the bottom of the page, an URL will appear like this:

http://www.nzbsrus.com/rssfeed.php?cat=87&i=21345&h=abcdef1234567890fedcba1234567890

The numbers after &i= are your UID, the string after &h= is your hash (UID=12345 and

hash=abcdef1234567890fedcba1234567890 in the example above)

5. Enable NZBs'R'US

Check to enable searching for episodes on NZBs'R'US (Only currently Airing)

6. NZBs'R'US UID

Your NZBs'R'US UID

7. NZBs'R'US hash

Your NZBs'R'US hash

Bin-Req

8. Enable Bin-Req

Check to enable searching for episodes on NZBs'R'US (Only currently Airing)

NZBMatrix

Log in and go to http://nzbmatrix.com/account.php

Retrieve your API key from that page

9. Enable NZBMatrix

Your SAB auth username

10. NZBMatrix username

Your SAB auth password

11. NZBMatrix API Key

The API key specified in your SAB config

http://www.nzbsrus.com/rss.php

http://www.nzbsrus.com/rssfeed.php?cat=87&i=21345&h=abcdef1234567890fedcba1234567890

http://nzbmatrix.com/account.php


Notifications

XBMC

1. Notify XBMC on NZB retrieval

Send XBMC a notification when we find an NZB?

2. Notify XBMC on episode download

Send XBMC a notification when we finish a download?

3. Update XBMC library

Update XBMC library when we finish a download?

4. XBMC host

XBMC HTTP API address (IP:port, e.g. 192.168.1.100:8080).(multiple host strings can be separated by

commas)

5. XBMC Username

Username of your XBMC server (blank for none)

6. XBMC Password

Password of your XBMC server (blank for none)

7. Test XBMC

Click this to send a test notification to your XBMC host(s)


Adding TV-Shows You have two different options available: New Show and Existing Show. If you want to download a

TV-Show you do not own at this time, click on the button „Add New Show“ and head to the section

below. If you want to add one or more TV-Shows you already have saved on your disk click on the

button „Add Existing Shows“ and head to the section „Existing Shows“ further below.

Add New Show

There are three steps in order to add a new Show to your database:

1. Find TV-Show on TVDB

2. Pick the folder in which the Show will be stored

3. Customization

The third step however is optional – you can just apply the settings which are stored in your

configuration.

First type in the name of the Show you want to add. Sickbeard will the look in the TVDB for a

corresponding title and will present you with the results.

Hit the results which suit your Show and click the “Next”-Button. As you do not have a parent-folder

specified right now, click the “New”-Button in the next step and choose the folder in which the Show

should be stored.


In the next step choose your likings and click on “Add Show” at the bottom of the page.

Add Existing Show

First click on the button “Manage Directories” and add the Root-Folder of your existent TV-Shows.

You can add more folders if you like (if you – for example – have a folder Shows and Shows2, you

could add them both). You should notice that Sickbeard starts to load and indexes the new folders

which are subfolders of your Shows-Folder(s).

Now click on the button “Customize Options” and set everything accordingly and hit the button

“Submit”.

You will now be presented with the “Step 1”-screen of the Add-Show-Dialog. It will show you the

search results for the Show lookups based on your Show-Directory.

Click on the right Show and hit the button “Add Show” below. This will continue until every folder is

scanned and checked. If you do not want to add a specific show, just hit the button “Skip Show” and

if you want to customize your choices hit “Next” and “Next” again to get to Step 3. Here you can

configure special settings for the single show.

After you added the Shows to Sickbeard you have to wait a little bit – Sickbeard is now gathering all

the required information and then will start looking up the series (if you specified it) in the NZB-

Databases. Otherwise Sickbeard is now completely ready for usage – just hit the button “Coming

Episodes” in Sickbeard to see what Sickbeard will download next and what episodes already were

missed.

Post-Processing At this point Sickbeard is configured to look for new releases. But how will Sickbeard now know if a

download finished? Post-Processing is the key-word. Post-Processing is the ability of Sickbeard to

automatically rename your downloads and sort them into the proper folders. Without this you will

need to manually copy them over and then re-scan the show directory to find the new episodes.

There are two possibilities to do this:


1. Head back to the section “Episode Downloads” under “Installation and Setup” and you will

find the options “TV Download Dir” and “Scan and Process TV Download Dir”. Set these

settings accordingly.

2. You can configure SABnzbd to launch a Post-Processing-Script for Sickbeard. Again I will copy

the content of the Sickbeard-page regarding this process

(http://code.google.com/p/sickbeard/wiki/PostProcessing):

To set up post processing, first copy the contents of the autoProcessTV directory from your

Sick Beard installation to your SABnzbd+ scripts folder (or set your scripts folder to the

location of the autoProcessTV directory). Rename autoProcessTV.cfg.sample to simply

autoProcessTV.cfg and open it in a text editor. Change the host, port, username, and

password values to the appropriate settings for your Sick Beard server. Then set the

appropriate script as your post processing script inside SABnzbd+/HellaNZB:

sabToSickbeard.py - Linux/OSX SABnzbd+

sabToSickbeard.exe - Windows SABnzbd+

hellaToSickbeard.py - HellaNZB

Note: If your SABnzbd+ is running on a different PC than your Sick Beard you may need to enter your TV download dir into your Sick Beard settings so that Sick Beard knows how to find the SABnzbd+ downloads.

Note 2: You must disable SAB sorting to use Sick Beard post processing, all episodes should be being post-processed from a temporary download folder.

Couch Potato Homepage: http://couchpotatoapp.com/

Download the current build of Couch Potato on the homepage above. For Windows click on the

Windows-Button and download the zip-file. Extract it and run the file “Couch Potato.exe” – that’s it,

Couch Potato is running and should open your default browser with CP already launched.

Click on Options-Button in the top-bar (it is the little Gear-Icon) to setup your Couch Potato.

Setup

General

In the Settings-Window click on the button “General” above to be presented with the following

screen:

http://couchpotatoapp.com/


Enter the information accordingly:

1. Host: This is under which IP Couch Potato should be reachable (of course this should

correspond to the IP of your machine.

2. Port: This is the Port which will be used by Couch Potato.

3. Username/Password: These are required if you want to lock the access to Couch Potato. If

you don’t want to, just leave these fields blank.

4. Launch Browser: If checked, Couch Potato will open up the default browser after it is started.

5. Use Updater: Couch Potato will check for new releases and will update itself (the update has

to be accepted before)

6. Search every: The interval in which CP will check for new movie-releases.

7. Ignore Words: These words are being ignored while searching for new releases.

8. Preferred words: CP will look for these words with priority while searching for new releases.

9. Required Words: These words have to come up while searching for new releases, otherwise

CP won’t download.

After you put in these information hit “Save” below and click the button “NZBs / Torrents”.


NZBs / Torrents

You will see the following screen:

NZBs

1. Enable: If checked CP will look for new releases in the NZB-Indexes specified

2. Retention: The File-Retention which is supported by your NZB-Provider (check your provider

for information)

3. Download to: What kind of Usenet-Downloader are you running?

4. Host: Where is your Usenet-Downloader located (in case of sabnzbd+: Enter the host-address

of the sabnzbd-installation)

5. Apikey: Can be found in the general config on SABnzbd. You need this in order to allow 3rd-

Party-Programs access to you installation.

6. Username/Password: The data which is required in order to access your sabnzbd+-

installation.

7. Category: Which category should be used for the downloads

Torrents

1. Enable: If checked CP will look for new releases in the Torrent-Indexes specified

2. Download to: The destination where the torrent-files should be downloaded to.

3. Wait: The time CP will wait before looking for a release on the torrent-indexes. If the movie is

found before in the nzb-indexes, CP won’t download any torrent-files (If NZBs are enabled).

Hit Save and click on the button “Providers”.


Providers


Activate the proper index, this depends on the indexes you use – for some you need a premium (=

paid) account to use them. Set the settings, you will get the necessary data from the specific indexes.

Hit Save once more and click on the button “Quality”.

Quality


This is the page were you define the qualities which you want to download. You can choose from the

default Qualities on the right side – there are pretty much standard-types, you should be able to

figure out what quality download what file. On the left handed sided you can define your own


qualities. The above example will look for new releases in the qualities “BR-Rip” (= Blu-ray-Rip),

“720p” and “1080p” but it will only finish when it has found a “1080p”-version of the release. So it

will download a “720p”-version if it finds one, but will replace it as soon as it finds the “1080p”-

version of the release. After you defined the qualities you are able to choose from them while adding

a new movie to your database.

After you’re done, click “Save” below and continue with “Renaming”.

Renaming

You will see this:

1. Enable: If this is checked, Couch Potato will rename and move the downloaded movie-files

2. Download Folder: This is where SABnzbd downloads the movies to

3. Movie destination: This is the place where the files should be moved to

4. Folder naming: Define a pattern for the new folder name after file-moving

5. File naming: Define a pattern for the new file name after file-moving

6. Name Separator: This will be placed between the words of the resulted name.

7. Cleanup: If checked CP will remove everything in the download-folder which does not belong

to the downloaded movie.

Click “Save” and hit the button “Extras” above.


Extras

You will see the following:

In this section you can define additional settings. For example you can instruct CP to inform your

XBMC about new downloads and update your library after a downloaded finished successful. You

also can enable trailer-download and various sub-settings, see for yourself what settings you want to

apply.

Hit “Save” and click on the button “Userscript” if you use either Google Chrome (or a Chromium-

Derivate) or Mozilla Firefox for browsing. Otherwise click on “About”.

Userscript

You will see this screen:


You can install an extension which will help you add movie to your database easily. Follow the on-

screen instructions to set it up. This way you will have a little “Add to CouchPotato” button at the

bottom of IMDB-Movie-Pages.

After you’re finished hit “About” above.

Restart

In order to apply all the settings restart your CP. The General-Settings need a restart in order to be

applied; all other settings can be changed while running CP. You can restart CP by clicking on the

button “About” and hit “Restart”.

Add Movies You have to possibilities:

1. Use the Userscript which was mentioned in the Setup

2. Manually add a movie

In order to add a movie by yourself open CP in a browser-window. You will find a field “Movie name”

in the top bar. Add the title of the movie you want to add in this field and hit enter:

CP will now look up the title in the IMDB and shows you the matches for the title afterwards. Pick the

correct film from the drop-down list and choose the quality which you want to assign from the drop-

down box on the right. After you set everything correct hit “Add”. Wait a little bit – after CP finished

you can see the entries of your movies on the homepage of Couch Potato. CP will start looking for

new releases in the desired interval and after you added a movie to your database.

Date post:	12-Mar-2015
Category:	Documents
Upload:	silversurger
View:	9,177 times
Download:	0 times

XBMC - Dharma Guide

Documents