Matt

To create an Action File, follow these steps: Create a new text document. Input the command that you want to use. Save the file as <file_name>.action in the Actions directory of your PreShow Experience content folder. You can also find pre-built Actions for different home automation solutions in the Downloads section of our website. If you have any improvements or new Actions that you create, please share them with us. We can host them on the site for others to use. Action Files use the following Syntax, Methods, and Protocols: Syntax: Use "#" at the beginning of a line to ignore the contents of that line. Use "<protocol>://" at the beginning of a line to specify the protocol for that command. Use "<method>:" at the beginning of a line to specify the method for that command. Protocols: Currently supported protocols: "http://" or "https://": Passes JSON commands via a URL. "addon://": Runs a script or add-on. "command://": Runs a command or application at the OS level and pass arguments. "module://": Runs a Python script with a main() method that is imported and called. "python://": Run a Python script. "sleep://<milliseconds>": Pauses the Action File for the specified time in milliseconds. Methods: Currently supported methods to communicate with the target device or application: "HEADERS:": Sends header information. "POST:": Sends a POST command to create information. "PUT:": Sends a PUT command update information. "DELETE:": Sends a DELETE command to delete information. Actions in Action Files can be single-line or multiple-line commands. Blank lines are used to separate commands. The first line of any Action is the Execution Line. The line following the Execution Line can be a Headers Line or a Data Line. Headers Line: Specifies the content type or any other headers. Prefix the line with "HEADERS:". Data Line: Used to pass arguments or data. Prefix the line with the desired Method ("POST:", "PUT:", or "DELETE:"). If no method is specified, the default method used is POST. Examples Example 1: Sending a JSON command via URL # This is a comment http://api.example.com/endpoint?param1=value1&param2=value2 Example 2: Running a script or add-on by add-on ID with arguments addon://1234567890?arg1=value1&arg2=value2 Example 3: Running a command or application at the OS level with arguments command://path/to/executable --option1 value1 --option2 value2 Example 4: Running a Python script with a main() method that is imported and called module://path/to/script.py Example 5: Calling a normal Python script via the operating system python://path/to/script.py Example 6: Adding a sleep (pause) of 500 milliseconds before moving to the next action sleep://500 Example 7: Sending a POST command with data and headers to activate a Home Assistant Webhook https://YOUR_DNS_HOSTNAME.com/api/services/scene/turn_on HEADERS: {"Authorization": "Bearer LLATStringOfRandomCharacters", "Content-Type": "application/json"} POST: {"entity_id": "scene.movie_start"} Example 8: Sending a PUT command to change Hue brightness http://<hue-bridge-ip>/api/<hue-bridge-user>/groups/<hue-light-group>/action PUT:{"on":true,"bri":40,"transitiontime":10} Example 9: Sending a PUT command to turn off Hue light http://<hue-bridge-ip>/api/<hue-bridge-user>/groups/<hue-light-group>/action PUT:{"on":false,"transitiontime":30} These examples demonstrate various use cases and combinations of syntax, methods, and protocols in Action Files.

This module is only recommended for advanced users. Action modules allow you to add dynamic functionality to your sequence, including changing settings in Kodi or interacting with your home automation. Action scripts must be configured outside of the sequence editor and saved in your action folder of your PreShow sequence. More information about creating action files can be found here:

This modules allow you to set up loops in your sequences. This you to set loops in your sequence or skip content before your first or last movie in your queue. Settings for this module include: Direction - Back or Skip Number of modules - Number of modules to jump back or forward Condition - Set the condition for the loop Duration Time of Day Number of loops Feature queue is full (This requires your to have your feature count set to greater than 1.) Feature queue is empty

This module includes your feature film and ratings, if you choose to show them. Settings for this module include: Count - The number of movies you want to show. Rating Bumper - You must have ratings content in your content folder to display these. Options include: Default - Use whatever you have selected in your PreShow settings. Video - Show only videos from your ratings bumper content folder Image - Show only images from your ratings bumper content folder None - Don't show ratings Ratings Style Selection Default - Use whatever you have selected in your PreShow settings. Random - Randomly pick from any files that you have in your ratings bumper content folder Style - Creates an additional option of Rating Style Ratings Style -Select a single folder from your ratings bumper content Volume (% of current) This module is required to be in every sequence.

This module will display a video based on the detected audio format of your feature film. You must have audio format bumpers in your content folder to display these. Audio Format Bumpers can be downloaded here: https://preshowexperience.com/files/category/5-audio-format/ Settings for this module include: Method - The default is Auto select from source. Other options include Choose format and Choose file. If file is selected, a new option of Path will appear below File - Select the video that you would like to play Fallback - You can choose a file or format here in case your video doesn't match any of existing audio bumpers. Format - Select a default format folder to be played Play 3D if 3D Feature - Select a default single video file to be played. Volume (% of current) - Sets the volume for the audio format bumpers Dolby Atmos and DTS:X are not currently detected in Kodi. In order to properly trigger those animations, your movie file name must include "atmos" or "dtsx" to show the appropriate video.

Module: Trailers The settings for the Trailers module include: Source - Select your trailer source from the following options: Content Source filter (scraper) - Select from the scrapers selected in your settings. Scrapers include: PreShow Trailers Folder - These are any trailers that you have in the Trailers folder in your PreShow content directory. Kodi Database - These are YouTube trailers for movies on your system Apple iTunes - iTunes trailers from the apple site.. The Movie Database - These are YouTube trailers from TMDB. Content order - Select how your content is selected: Newest Random Directory Path - Select a folder on your system that may contain multiple files to be selected randomly Single File File - Select a single trailer file to show. Count - The number of trailers to be shown. Rating Limit - Options include: None - Allows any trailers of any ratings Max - Limit the ratings to a selected in the Max setting below Match Feature - Filters trailers with a rating that matched the feature film Match feature genre - Selects trailers with one of the same genres as the feature film Filter for 3D based on feature - Will play 3d trailers, if available Quality - select your preferred resolution of 720 or 1080 Volume (% of current) - Sets the volume for trailers

Trivia Packs can be downloaded here: https://preshowexperience.com/files/category/6-trivia/ Trivia is a set of images in a folder that is either grouped as Question and Answer or Facts. Question slides contain multiple images. A question image and answer image are required. Up to 9 clues can also be added. Filename requirements Question images must end with _q. Answer images must end with _a. Clue images must end with _c(#1-9). Fact images can't end with _q, _a, or _c#. Here is an example ..\Trivia Pack Name\PackNameFact1.jpg ..\Trivia Pack Name\PackNameFact21.jpg ..\Trivia Pack Name\PackNameQA1_q.jpg ..\Trivia Pack Name\PackNameQA1_c1.jpg ..\Trivia Pack Name\PackNameQA1_c2.jpg ..\Trivia Pack Name\PackNameQA1_c3.jpg ..\Trivia Pack Name\PackNameQA1_c4.jpg ..\Trivia Pack Name\PackNameQA1_a.jpg ..\Trivia Pack Name\PackNameQA2_q.jpg ..\Trivia Pack Name\PackNameQA2_c1.jpg ..\Trivia Pack Name\PackNameQA2_c2.jpg ..\Trivia Pack Name\PackNameQA2c3.jpg ..\Trivia Pack Name\PackNameQA2_c4.jpg ..\Trivia Pack Name\PackNameQA2_a.jpg Trivia must be contained in a subfolder within your PreShow Trivia content folder. Files in the root PreShow Trivia content folder will not be scanned. Module Settings The settings for your trivia module are primarily the same as the PreShow Experience Trivia settings. You can use the defaults or select unique settings per sequence is desired. Format - Select between slide or video. You need to have the appropriate files in the trivia folder of your PreShow content. Select Trivia - This is the one option that isn't in your basic settings. Default - randomly select trivia from all the folders in your Trivia content folder. Directory - Reveals Directory (in trivia folder) below. Directory (in trivia folder) - Select the trivia folder in your content settings that you want the sequence to pull from. The sequence will only select files from this folder. It currently allows you to select any folder. If you select a folder that's outside of your trivia folder the sequence will not play trivia. Duration (minutes) - Set how long you would like your trivia sequences to run. Question duration (seconds) - Set how long you would like your trivia questions to be on screen. Clue duration (seconds) - If a pack includes them, set how long you would like your trivia clues to be on screen. Answer duration (seconds) - Set how long you would like your trivia answers to be on screen. Single duration (seconds) - If a pack includes them, set how long you would like your trivia single slides to be on screen. Transition - Transition between slides. Options include fade, slide up, slide down, slide right and slide left. Transition duration (milliseconds) - Set the transition time between slides. Music Music - Select your music source if you want to play music during your trivia. Options include: None - No music will be played Content - This will play from the music folder in your PreShow content folder. Directory - This will play from the folder selected below in Music: Path. File - This will play the track selected below in Music: File. Music: Path - Select a folder that contains your music that can be anywhere. Music: File - Select a single file to play with your music. Trivia Controls Here is a list of controls to navigate your trivia slides. Space - Pauses trivia Left Arrow - Jumps to the previous trivia slide Right Arrow - Jumps to the next trivia slide Up arrow - Jump 3 questions/facts back Down Arrow - Jump 3 questions/facts forward Page Up - Fades out the currently trivia image and music and jumps to the next module Pade Up (Double Click) - Jumps to the next module immediately with no fade Page Down - Jumps to the previous module

Video Bumpers are probably the module that will appear the most in any sequence. The module plays videos from your PreShow content folder. You must have video bumpers in your content folder to display these. Video bumpers can be downloaded here: https://preshowexperience.com/files/category/2-preshow-videos/ Settings for this module include: Type - Each type represents a folder in your PreShow content video bumper folder. The types/folders are: 3D Intro 3D Outro PreShow Sponsors Commercials Countdown Courtesy Feature Intro Feature Outro Intermission Short Film Theater Intro Theater Outro Trailers Intro Trailers Outro Trivia Intro Trivia Outro Random - If set to yes, it module editor will add options for Count and Play 3D if 3D Feature. If set to no, it will add options for Source. Count - The number of videos that you want to show. Play 3D if 3D Feature - Will play 3d video, if available and feature is 3D Source - Select a single video to play Volume (% of current) - Sets the volume for the video bumper

Sequences are how you configure your PreShow Experience. The sequence consists of modules that show content. PreShow doesn't come with any of the content. You need to download content to be shown in your sequence. Content can be downloaded from here: https://preshowexperience.com/files/ Sequence modules include: Video Bumpers Trivia Trailers Audio Format Bumper Features Command Actions You can edit your sequence to show any number of these modules in your sequence that will play before, between or after your movies.