Add-on:Cinema Experience

From Official Kodi Wiki
Revision as of 04:07, 18 March 2013 by >Giftie
Jump to navigation Jump to search

Cinema Experience

See this add-on on the kodi.tv showcase

Author: Giftie

Type: Program
Repo:

Summary: Re-create a full movie theater experience.
Home icon grey.png   ▶ Add-ons ▶ Cinema Experience

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

About Cinema Experience

What is Cinema Experience

This scripts will add the wow factor to your home theatre and give you the true cinema experience you deserve(except you still have to supply the popcorn and drinks). This script allows you to play slides, previews(trailers) and other videos that give the full cinema feel(Intro's and Outro's) Slides can consist in almost any jpg picture(many Movie Q&A, Movie Stills, Movie Fact packs already exist). The Feature Presentation Movie(s) must be in your Video Library. It can stream or download from Apple Movie Trailers, play locally stored trailer that are on you system or play trailers from your Movie Library.

History

This add-on has a lot of history, starting its life in 2009 as the Home Theatre Experience script, by an amazing and skilled python programmer nuka1195. Through out its life it had brought changes to XBMC. In December 2010, the script was modified to work with the new add-on engine in XBMC's Dharma version, and changed names to Cinema Experience. In the start, the script was only being maintained to function with XBMC, then functional repairs, then some big changes(some brought about some negative feedback). Now it's 2013 and XBMC Frodo is here, so is Cinema Experience..

How to get it

At the moment this add-on is only available through zip-file downloads. The Frodo version will be soon added to the Official Repo, making it easier to get. But for the time being...

Dharma Version: http://www.mediafire.com/file/6r7d1pqnfeib7xx/script.cinema.experience.1.0.53.zip

Eden Version: https://www.dropbox.com/s/9xqnclvosuhm2o1/script.cinema.experience.2.0.57.zip

Frodo Version: http://www.mediafire.com/file/aod1erp3gbi469q/script.cinema.experience.3.0.3.zip

Reporting bugs and requesting features

Since this script is always an evolving creature, getting better with every release, bugs do come up. 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(repeat, ALWAYS) required, along with the steps to create the bug.

Also on this forum thread I will accept feature requests.

Now the fun stuff

Script Flow

Video Folder Outline

Home Automation Integration

Integration

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}

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.3 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. 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}

Skin Integration