Add-on:PinSentry

PinSentry

Author: robwebset Type: Video Repo: License: GPL v2.0 Source: Source code Summary: Protect Kodi Content With A Pin Code

Add-ons

PinSentry

Need help with this add-on? See here.

Force users to enter the correct pin code for given content.

Introduction

PinSentry is an addon that will allow you to set a pin code that you can then force to be input when you play a particular video file or navigate into a given TV Show or Plugin.

After install you need to:

• Go to settings and select your pin
• Enable which videos you want the pin to be displayed for (Either via Settings, Programs->PinSenty or Videos->Addons->PinSentry)

Pin Contol

Whenever a user selects an item that has been protected by PinSentry they will be prompted with a dialog like the following:

The correct pincode should be entered via the onscreen buttons or a remote control numeric pad in order to gain access. It you have "Allow Direction Keys In Pin Code" enabled in the settings then you can also use a pin code made up of Up, Down, Left and Right, this is useful if you have a remote control without numbers.

Configuring Access

In order to configure which files or operations require the entry of the pin number you can access the menu be either via:

• Videos -> Addons -> PinSentry
• Programs -> PinSenty
• Settings

That will present the main settings menu:

That will allow you to set values as follows:

Movies

Specify individual Movies to restrict

TV Shows

Specify individual TV Shows to restrict

Movie Sets

Specify individual Movie Sets to restrict, this will also flag the movies in the movie set as restricted

Music Videos

Specify individual Music Videos to restrict

Plugins

Specify individual Plugins to restrict

Classifications

Specify Movie or TV Show classification to restrict

Classifications

Each country has their own set of classifications, each meaning different things. Pin Sentry currently supports the following countries classifications

• Australia
• Brazil
• Germany
• Hungary
• Ireland
• Netherlands
• UK
• USA

If you would like another countries classifications supported then please post a request to the forum. The classifications have been taken from the following documents:

• http://en.wikipedia.org/wiki/Motion_picture_rating_system
• http://en.wikipedia.org/wiki/Television_content_rating_systems

Note: Not all countries have TV Show classifications

The classifications used on your Kodi library will depend on the settings (and scraper) that you used when you loaded them into the library initially. It is always worth noting that some videos can end up with incorrect classifications being set in your library. There are two options in the PinSentry settings to help you identify videos that do not require a pin when using the current classification settings.

Settings

This section details all the settings options for PinSentry

Setup

Pin Length The number of digits required when entering a pin Allow Direction Keys In Pin Code Allows the direction keys (Up, Down, Left, Right) to be used in the pin code, this is useful if you have a remote control without numbers on. Invalid Pin Notification How to inform the user that an invalid pin has been entered. Options include "None", "Notification" and "Dialog" Number Of Security Levels Allows multiple security levels to be used, so different pins are required for different videos - Show Security Level On Permissions Screen When using more than one security level, will show the current level on the permissions screen Operations Set Pin Value Sets the current pin Set Permissions Allows the setting of which items require the user to enter a pin before access. Clean Database Clears the database that contains all the rules for which items require a pin

Activity

Video Playing Check if a pin is required each time a video is played Navigation Check if a pin is required to access certain menu items (Such as looking inside Movie Sets or TV Shows) Plugins Check if a pin is required to use a given plugin File Source Check if a pin is required when accessing soming using a give file source - Only Restrict File Sources During Navigation Only prompts for file source restrictions when navigating into one (Not when playing a video) Block Movies Without A Classification Requires a pin if an attempt to access a movie that has no valid classification set Block TV Shows Without A Classification Requires a pin if an attempt to access a TV Show that has no valid classification set

Advanced

Remember Pin In the pin should be remembered after it has been entered. Options are Off, On (will be remembered until the screensaver starts or the system is restarted) and "For Time Period" - Remember Pin For (Minutes) If configured to remember the pin for a given time period, this sets that period (Between 1 and 120 minutes) Background What to display behind the pin dialog. Options are None (the default background will be visible), Black (the screen behind the dialog will be blacked out), PinSentry (the PinSentry fanart will be displayed) and Custom (a user defined image is used) - Custom Background Image Allows the user to select their own background image Only Enforce Pin Between Set Times Will only prompt for a pin at certain times of the day - Start Time The time that the pin starts to be required - End Time The time that the pin is no longer required Highlight Videos Not Protected By Classifications If enabled, any you are using classification restrictions, will highlight the videos (with a play triangle) that are not currently protected with a pin in the "Set Permissions" menu Debugging Enable Debug logging Enables VideoScreensaver debug logging into the Kodi log file

Debugging

If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:

• Kodi logging from the main setting menu
• PinSentry debug from the PinSentry addon settings menu

Please do not paste the log into the forum thread, just link to it.

Donations

If you have found the PinSentry Addon useful and would like to help support future development and bug fixes, then please feel free to make a small donation.

Please use the link on the top of the PinSentry Forum