Add-on:Cinema Experience

Cinema Experience

See this add-on on the kodi.tv showcase Author: Giftie Type: Program Repo: Source: Source code Summary: Re-create a full movie theater experience.

Add-ons

Cinema Experience

Need help with this add-on? See here.

Play trailers, slideshows, intro videos, outro videos: To re-create a movie theater experience in the comfort of your home.

Installing

This add-on is installed from the Add-on browser located in Kodi as follows:

1. Settings
2. Add-ons
3. Install from repository
4. Program Add-ons
5. Cinema Experience
6. Install

History

This add-on has a lot of history. It started life in 2009 as the Home Theatre Experience script, written by an amazing and skilled Python programmer nuka1195. Through out its life it has brought many changes to XBMC. In December 2010, giftie took the reigns, and the script was modified to work with the new add-on engine in XBMC's Dharma. The name was changed, and the incarnation of Cinema Experience you know was born.

In the beginning, the script was only being maintained to function with XBMC. Then the script needed some functional repairs. Later, some major changes (and even some that brought about negative feedback). Now it's 2013, and XBMC Frodo is here. Cinema Experience is here to stay. Cinema Experience is currently maintained and improved by giftie. He's added numerous features to the script, and provides invaluable support via the Kodi forums.

What does it do?

The Cinema Experience script will add that WOW factor to your home theater, and give you a true Cinema Experience! Yes, you will still have to supply the popcorn and drinks. There's not much we can do about that. This script allows you to play trivia slides, movie trailers and other videos (intros and outros) that will help you get that Cinema Experience - just like at the local theater. Trivia slides can be any JPG or PNG image (many Movie Trivia, Stills, and Movie Fact packs already exist). The Feature Presentation Movie(s) must be in your Video Library. Cinema Experience can stream trailers, download them from Apple Movie Trailers, or play locally stored trailer(s) that are on your system or in your Movie Library.

What doesn't it do?

The Cinema Experience script will NOT work with any movies that are NOT local and scraped into your Movie Library. This means that any streaming content (let's use Netflix as an example, but this applies to any and all Video Add-ons that stream content to XBMC) either supported and in the official repository or not supported and in a third party repository will not work with the Cinema Experience script.

How do I get it?

At the moment, for XBMC Dharma and Eden this add-on is only available through installable ZIP files. The Frodo version has been added to the Official Official XBMC Repository, making it easier to get.

• Dharma: Download
• Eden: Download
• Frodo: Available from the Official XBMC Repository

Reporting Bugs & Requesting Features

Cinema Experience is an evolving creature, getting better and more feature-rich with each release. That said, bugs happen. When they do, a bug report needs to be made. These are to be made on the Cinema Experience forum thread. A debug log is ALWAYS required, along with the steps needed to re-create the bug. I won't be able to help you if I can't understand what's happening.

Reporting Bugs: Method 1

Use the Debug Log Script.

Reporting Bugs: Method 2

Manually locate your Kodi.log file. Copy & paste your Kodi.log file to Kodi Paste (or a similar site).

Note: If you feel that you have private information in your log file that you don't want the public be able to see, set up an account on pastebin.com and store it as a private paste.

Uploading Logs

1. Put XBMC into Debug Mode.
2. Restart XBMC.
3. If you have add-ons that run automatically when XBMC starts, wait a few minutes for these scripts to run (ShareThe.TV, Weather.com Plus, etc.).
4. Run Cinema Experience.
5. Upload your FULL xbmc.log file to Kodi Paste (or a similar site).
6. Create a new forum message in this thread. Includethe steps required to reproduce the bug and your pastebin.com URL.

Requesting Features

I accept feature requests in this thread. Be sure to be specific about what you'd like to see added.

Information & Setup

Supported Ratings Systems

Cinema Experience currently supports the MPAA, BBFC, FSK and DEJUS ratings systems. If you'd like a new rating system supported, post in this thread. You may need to provide a database file, or some screenshots of the table. I need to know each different rating in that column. What I need to see will depend on your database. If you are using the default database format (i.e. you haven't made any changes to XBMC) you can post the database file to Google Drive or Drop Box and then PM me a link to the file. If you are using MySQL, you will need to access it yourself (using a viewer of some sort) and send me some screenshots movieview table. Generally, column c12 contains the ratings.

The database you need depends on the OS you are using. This Wiki Page will help you find the proper file. The Video database is named MyVideosXX.db - with XX representing the database version. Use the one with the latest date.

Sequence Overview

Cinema Experience gives you the ability to enable or disable any introduction videos, or the trivia slideshow. You have the power to customize your cinema experience. The following is an example of the complete script flow:

1. Trivia Intro Video(s)
2. Trivia Slides with Optional Music Playlist
3. Trivia Outro Video(s)
4. Movie Theater Intro Video(s)
5. Coming Attractions Intro Video(s)
6. Trailer(s)
7. Coming Attractions Outro Video(s)
8. 3D Intro Video(s) - if upcoming Movie is in 3D format
9. 3D Trailers( from folder as I haven't found a site that has them really available) - if upcoming Movie is in 3D format
10. Countdown Video
11. Feature Presentation Intro Video(s)
12. Rating Video (MPAA, BBFC and FSK ratings are currently supported)
13. Audio Format Video
14. FEATURE PRESENTATION
15. Intermission Video(s) (note)
16. Rating Video
17. Audio Format Video
18. FEATURE PRESENTATION 2
19. Intermission Video(s) (note)
20. Rating Video
21. Audio Format Video
22. FEATURE PRESENTATION 3
23. Intermission Video(s) (note)
24. Rating Video
25. Audio Format Video
26. FEATURE PRESENTATION 4
27. Intermission Video(s) (note)
28. Rating Video
29. Audio Format Video
30. FEATURE PRESENTATION 5 (end note)
31. Feature Presentation Outro Video(s)
32. 3D Outro Video(s) - if upcoming Movie is in 3D format
33. Movie Theater Outro Video(s)

Available in 3D if upcoming movie is 3D and settings enabled

(note) At this point in the script, if multiple features have been queued and the skin uses home menu integration, multiple rating videos, audio format videos, features, and intermission videos will take the place of a single feature. A total of 5 features can be queued. This option can be even larger if you use one of the starting methods suggested in the Script Starting methods section.

Directory Tree Overviews

Root Directory Structure

This is the suggested directory structure for all of your Cinema Experience content.

Audio Format Directory Structure

The only directories that need to be in a specific format are in the Audio Format directory. This is because the script uses the name of the Audio Format (DTS, Dolby Digital, etc.) to determine what video to play.

Intro & Outro Directory Structure

Even though these directories don't need to be in a specific format, it's a good idea to use the standard shown below. If you're having trouble, switch to the standard and reconfigure Cinema Experience for the new directory structure.

Trivia Directory Structure

Even though these directories don't need to be in a specific format, it's a good idea to use the standard shown below. If you're having trouble, switch to the standard and reconfigure Cinema Experience for the new directory structure. The example below shows some popular slide sets copied into the appropriate directory.

Trivia Slideshow Explained

The script can display a slideshow at the start of the experience. The slides can be standard still slides or Q&A(with clues). The best method of storing the slides are to have them in separate folders, the script can search the folders recursively.

Types of Slides

Stills

Stills are trivia slides that only have one part, or are not multiple part slides like the Question & Answer slides. These slides do not require the use of a slides.xml file.

Q&A

Question & Answer slides have multiple parts (for example: Question, Clue, Answer). This type of slide does require the use of a slides.xml file to enable the script to determine how and when to display each Q&A slide.

XML File Explained

A Breakdown of the XML File

<slide rating="X" />	This can be used to match the rating of the feature being played, or to set a limit on which slides are played based on value set in the Settings.
<question format="X" />	Provides the format that identifies slides as an Question slide.
<clue format="X" />	Provides the format that identifies slides as an Clue slide.
<answer format="X" />	Provides the format that identifies slides as an Answer slide.

     <slides>
         <slide>
             <slide rating="R">
             <question format=".([0-9]{1,3})+_q.jpg" />
             <clue format=".([0-9]{1,3})+_c.jpg" />
             <answer format=".([0-9]{1,3})+_a.jpg" />
         </slide>
     </slides>

A Breakdown of ".([0-9]{1,3})+_q.jpg"

.	Provides identification of any leters (i.e. identifies the word "stills" in "stills20_q.jpg")
([0-9]{1,3})	Provides identification of any number from 0 - 999 (i.e. identifies the number "20" in "stills20_q.jpg").
+_q	This allows the script to determine if it is a Question, Clue or Answer (i.e. "stills20_q.jpg" is a question, but "stills20_c.jpg" is a clue).

The "+_q" can be any letter or combination of letters as long as the pattern is kept. For example:

Question	<question format=".([0-9]{1,3})+_q.jpg" />	<question format=".([0-9]{1,3})+_a.jpg" />
Clue	<clue format=".([0-9]{1,3})+_c.jpg" />	<clue format=".([0-9]{1,3})+_b.jpg" />
Answer	<answer format=".([0-9]{1,3})+_a.jpg" />	<answer format=".([0-9]{1,3})+_c.jpg" />

Example XML Files

This example of a slides.xml file is for a two part trivia question (Q&A) with words and ordering numbers (i.e. slidename1_q").

     <slides>
         <slide>
             <slide rating="R">
             <question format=".([0-9]{1,3})+_q.jpg" />
             <clue format="N/A" />
             <answer format=".([0-9]{1,3})+_a.jpg" />
         </slide>
     </slides>

This example of a slides.xml file is for a two part trivia question (Q&A) without ordering numbers (i.e. slidename_q").

     <slides>
         <slide>
             <slide rating="R">
             <question format=".+_a.jpg" />
             <clue format="N/A" />
             <answer format=".+_b.jpg" />
         </slide>
     </slides>

Settings Explained

Trivia Mode

Three(3) modes available: None, Slide Show and Movie Quiz Script.

None

No Trivia pre-show

Trivia Slideshow

Slide Show specific settings

Duration(in Minutes)

Set the total length, in minutes, of the slide show

Slides Folder

The parent folder of the slides

Show Question Slide for(seconds)

The time, in seconds, that the question slide is displayed on the screen

Show Clue Slide for(seconds)

The time, in seconds, that the clue slide is displayed on the screen

Show Answer Slide for(seconds)

The time, in seconds, that the answer slide is displayed on the screen

Show Still Slide for(seconds)

The time, in seconds, that the still slide is display on the screen

Play Music during Slide Show

Enabling this settings the script will play music during the slide show

Music Mode

Two modes available, Music File/Playlist or Music Folder

Music File/Playlist

Select the music file or playlist that is played during the slide show. Only standard playlist(.m3u, .pls, .asf, .ram) are allowed(no SmartPlaylist)

Music Folder

Select the folder which to play music from during the slide show

Adjust Volume during Slide Show

Enabling this setting allows the script to drop the volume level during slide show

Music Volume Level

Set the volume level(0-100)

Fade Volume at end of Slide Show

Enabling this setting allows the script to fade the volume down, then back up at the end of the slide show

Fade time in seconds

Set the fade time in seconds

Select Only Unwatched slides

Enabling this setting tells the script only to use unviewed slides. The script will automatically reset the watched status during the slide show if slides run out before the end of the slide show

Reset Slide watched status

Manually reset the watched status of slides

Limit Slides by movie rating(requires slides.xml)

Enabling this setting informs the script to limit the slides to a maximum MPAA rating of the movie. Other movie rating formats are roughly assessed and matched to MPAA Ratings

Rating Limit for Trivia(requires slides.xml)

If the previous setting is not enabled, adjusting this setting will fix the MPAA level of the slides used in slide show

Movie Quiz Script

Use the Movie Quiz Script in place of the Slide Show

Common Settings to the two trivia modes

Intro Video

Enabling this setting will play Intro video(s) before Trivia

Single Video

Select a video to play, this also can be a playlist file(.m3u, .pls, .asf, .ram)

1 Random Video

Select a folder to play a single video from, randomly selected

2 Random Videos

Select a folder to play a two(2) videos from, randomly selected

3 Random Videos

Select a folder to play a three(3) videos from, randomly selected

4 Random Videos

Select a folder to play a four(4) videos from, randomly selected

5 Random Videos

Select a folder to play a five(5) videos from, randomly selected

Outro Video

Enabling this setting will play Outro video(s) at the end of the trivia

Single Video

Select a video to play, this also can be a playlist file(.m3u, .pls, .asf, .ram)

1 Random Video

Select a folder to play a single video from, randomly selected

2 Random Videos

Select a folder to play a two(2) videos from, randomly selected

3 Random Videos

Select a folder to play a three(3) videos from, randomly selected

4 Random Videos

Select a folder to play a four(4) videos from, randomly selected

5 Random Videos

Select a folder to play a five(5) videos from, randomly selected

Integration

Home Automation Integration

home_automation.py

When the script runs for the first time, the script will copy a folder named ha_scripts and it's contents to your userdata\addon_data\script.cinema.experience folder. Inside that folder is a file named home_automation.py, which is a python script that Cinema Experience will trigger. Here is were the coding begins. It may seem intimidating, but it's actually fairly simple. Edit home_automation.py in a text or script editor. Beginning on line 53 of the file, you will notice commented parts of the code that say # place code below this line, example shown below in bold text.

class Automate:
    def __init__( self ):
        pass
   
    def sab_pause(self, mode):
        """
            This function provides a method to pause and resume SabNZBd downloading, very useful on a limited network or low powered system
           
            Usage:
           
                apikey - Your SabNZBd API key goes here
                ip     - The IP of your SabNZBd Machine, if local, leave as is, if it does not work, put the actual address in
                port   - Normally 5000 but change it to match you SabNZBd program
               
                Pause:
               
                    self.sab_pause( "pause" )
               
                Resume:
               
                    self.sab_pause( "resume" )
        """
        apikey = ""
        ip = "127.0.0.1" # address
        port = "5000"
        url = "http://%s:%s/sabnzbd/" % ( ip, port )
        query = {}
        query[ "mode" ] = mode
        query["apikey"] = apikey
        response = urllib2.urlopen( urllib2.Request( url + "api?", urlencode( query ) ) )
        response_data = response.read()
     
    def activate_ha( self, trigger = None, prev_trigger = None, mode="normal" ):
        if ha_settings[ "ha_enable" ]:
            if ha_settings[ "ha_multi_trigger" ] and prev_trigger == trigger:
                pass
            elif mode != "thread":
                self.activate_on( trigger )
            else:
                thread = Thread( name='ha_trigger', target=self.activate_on, args=( trigger, ) )
                thread.start()
            prev_trigger = trigger
        return prev_trigger

    def activate_on( self, trigger = None ):
        """
            Scripting to trigger almost anything(HA, other scripts, etc...) when videos start. 
           
            Usage:
                activate_on( "Movie" )
                will trigger code that is set under the Movie heading.
               
        """
        if not trigger:
            utils.log( " - [ home_automation.py ] - No Trigger Sent, Returning", xbmc.LOGNOTICE )
            return
        utils.log( " - [ home_automation.py ] - activate_on( %s ) Triggered" % trigger, xbmc.LOGNOTICE )
        if trigger in triggers:
            utils.log( " - [ home_automation.py ] - Trigger %s" % trigger, xbmc.LOGNOTICE )
        # Script Start
        if trigger == "Script Start" and ha_settings[ "ha_script_start" ]:
            # place code below this line
            pass
        # Trivia Intro
        elif trigger == "Trivia Intro" and ha_settings[ "ha_trivia_intro" ]:
            # place code below this line
            pass

This line is where we will start. For those not familiar with python, lines beginning with '#' are comment lines. To get the information to EventGhost, we need the script to send a broadcast. On XBMC Version Eden and Dharma, we used to use the xbmc.executehttpapi() function. Frodo and newer, HTTP API had been removed. Now the script includes it's own UDP Broadcaster. The home_automation.py script module already imports the utils module, all that is need it to used the utils.broadcastUDP() function.

The broadcast we need to send from Cinema Experience is something that we can easily identify and distinguish in EventGhost. For this example we will use "CE_Automate". We will also use the html <b> tag to start the broadcast, and </b> to end the broadcast, as well as <li> to separate the trigger. For example:

<b>CE_Automate<li>script_start</b>
<b>CE_Automate<li>trivia_start</b>

Now let's put it into the code, but first a little tip about the indentation. Python really likes indentation, in fact it will not work and throw a fit if the indentation is not correct. The script uses 4 spaces per indentation, these are also not tabs. The code we insert will need to line up with the other indented lines. For example:

# Script Start
if trigger == "Script Start" and ha_settings[ "ha_script_start" ]:
    # place code below this line
    utils.broadcastUDP( "<b>CE_Automate<li>script_start</b>" )

Now, when the script starts, it will broadcast: <b>CE_Automate<li>script_start</b>

EventGhost Setup

Now we need to turn our attention to EventGhost. Install the XBMC Event Receiver plugin found here and setup with these settings(use the IP 127.0.0.1 if EventGhost is on the same machine as XBMC, otherwise use your XBMC IP address).

Setting	Value
Event-Prefix:	XBMC-Event
XBMC Host IP:	127.0.0.1
XBMC HTTP Port:	8083
XBMC Broadcast IP:	255.255.255.255
UDP Port:	8278
Respond to Self Broadcast:	checked
Payload Delimiter:	<b></b>

The triggers we need to look for are the messages that we have broadcast from Cinema Experience. The XBMC Event Receiver prefixes the broadcast with XBMC-Event., so the event we will be looking for messages like this: XBMC-Event.<b>CE_Automate<li>script_start</b>

So now we can create a macro, and use XBMC-Event.<b>CE_Automate<li>script_start</b> as the event, then add what you want EventGhost to do when this event occurs. If the script senses that the playback has stopped (by pressing stop, video crash, etc.) it will trigger the script_end trigger.

Script Triggers

Here are a list of the triggers that are available:

Event	Trigger
Script Start	XBMC-Event.<b>CE_Automate<li>script_start</b>
Script End	XBMC-Event.<b>CE_Automate<li>script_end</b>
Trivia Intro	XBMC-Event.<b>CE_Automate<li>trivia_intro</b>
Trivia Start	XBMC-Event.<b>CE_Automate<li>trivia_start</b>
Trivia Outro	XBMC-Event.<b>CE_Automate<li>trivia_outro</b>
Movie Theater Intro	XBMC-Event.<b>CE_Automate<li>movie_theatre_intro</b>
Coming Attraction Intro	XBMC-Event.<b>CE_Automate<li>coming_attractions_intro</b>
Trailer	XBMC-Event.<b>CE_Automate<li>trailer</b>
Coming Attraction Outro	XBMC-Event.<b>CE_Automate<li>coming_attractions_outro</b>
Feature Presentation Intro	XBMC-Event.<b>CE_Automate<li>feature_intro</b>
Countdown Video	XBMC-Event.<b>CE_Automate<li>countdown_video</b>
Audio Format Video	XBMC-Event.<b>CE_Automate<li>audio_video</b>
Rating Video	XBMC-Event.<b>CE_Automate<li>mpaa_rating</b>
FEATURE PRESENTATION	XBMC-Event.<b>CE_Automate<li>movie_start</b>
Intermission	XBMC-Event.<b>CE_Automate<li>intermission</b>
Feature Presentation Outro	XBMC-Event.<b>CE_Automate<li>feature_outro</b>
Movie Theater Outro	XBMC-Event.<b>CE_Automate<li>movie_theatre_outro</b>
Paused	XBMC-Event.<b>CE_Automate<li>paused</b>
Resumed	XBMC-Event.<b>CE_Automate<li>resumed</b>

Skin Integration

Skin developers can now seamlessly integrate Cinema Experience! Often the chosen location for such integration is in the DialogVideoInfo.xml file. There are two methods, the old way and the new Movie ID way. Choose the method for your platform.

Old Method (Dharma/Eden)

     <control type="button" id="49">
         <description>Home Theatre</description>
         <include>ButtonInfoDialogsCommonValues</include>
         <label>Cinema</label>
         <onclick>Dialog.Close(MovieInformation)</onclick>
         <onclick>XBMC.RunScript(script.cinema.experience)</onclick>
         <visible>system.hasaddon(script.cinema.experience) + Container.Content(movies)</visible>
     </control>

New Method (Frodo v3.0.1+)

     <control type="button" id="49">
         <description>Home Theatre</description>
         <include>ButtonInfoDialogsCommonValues</include>
         <label>Cinema</label>
         <onclick>Dialog.Close(MovieInformation)</onclick>
         <onclick>XBMC.RunScript(script.cinema.experience,movieid=$INFO[ListItem.DBID])</onclick>
         <visible>system.hasaddon(script.cinema.experience) + Container.Content(movies)</visible>
     </control>

Script Starting Methods

There are a few different arguments available to change the starting the script. This are mostly for starting from with-in a skin or from an outside source(remote). Each cause the script to behave differently.

Using the built-in RunScript Method often used in skins and keymaps

RunScript(script.cinema.experience,argument)

Using the JSON RPC Method

{"jsonrpc": "2.0", "method": "Addons.ExecuteAddon", "params": { "wait": false, "addonid": "script.cinema.experience", "params": [ "arguments" ] }, "id": 1}

Available Arguments

Window ID

This is primarily used to put the script into multiple feature mode, though it can be used for a single Movie. The user will need to queue the movies into a playlist(normal queuing methods are used, Q on a keyboard, 0 on a remote or from the context menu)

Possible window IDs to use:

movietitles

moviegenres

movieyears

movieactors

moviedirectors

moviestudios

moviesets

moviecountries

recentlyaddedmovies

These match the general quick library links available from the homepage.

eg.

RunScript(script.cinema.experience,movietitles)

This will open up the library using Movie Titles, with the script waiting for the set number of features to be queue.

Movie ID

This is a new method introduced in version 3.0.1 of the script, to replace the former method of starting the script from a skin. The former method(no arguments sent to the script) caused an unsightly jump in the Movie Library list. This was due to the method XBMC uses to queue a video. With Frodo, skins now can extract the database ID for the Movie(using $INFO[ListItem.DBID] ) This method also allow a known database ID to be sent. Multiple database IDs can be sent at the same time, causing the script to go into Multiple Feature mode(fixed in version 3.0.4). The database IDs need to be separated by a semi-colon(;)

eg.

RunScript(script.cinema.experience,movieid=$INFO[ListItem.DBID]) skin method

RunScript(script.cinema.experience,movieid=35) single movie database ID

{"jsonrpc": "2.0", "method": "Addons.ExecuteAddon", "params": { "wait": false, "addonid": "script.cinema.experience", "params": [ "movieid=35" ] }, "id": 1}

RunScript(script.cinema.experience,movieid=35;123;112) multiple movie database IDs

{"jsonrpc": "2.0", "method": "Addons.ExecuteAddon", "params": { "wait": false, "addonid": "script.cinema.experience", "params": [ "movieid=35;123;112" ] }, "id": 1}