Profiles: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
{{Cleanup}}
{{Cleanup}}
{{XBMC faq toc Inline}}
{{XBMC wiki toc}}
 
 
XBMC supports multiple user profiles, much the same as setting up individual users on your home computer. These individual profiles allow you to customize the environment for multiple users, allowing for such functionality as:
XBMC supports multiple user profiles, much the same as setting up individual users on your home computer. These individual profiles allow you to customize the environment for multiple users, allowing for such functionality as:

Revision as of 00:48, 19 December 2011

Cleanup.png This page or section may require cleanup, updating, spellchecking, reformatting and/or updated images. Please improve this page if you can. The discussion page may contain suggestions.


Template:XBMC wiki toc   XBMC supports multiple user profiles, much the same as setting up individual users on your home computer. These individual profiles allow you to customize the environment for multiple users, allowing for such functionality as:

  • Customized view settings such as skins for each user
  • The ability to lock folders, such as network shares on a per-user basis
  • Separate Media Libraries for each user
  • Unique RSS feeds for each user
  • Unique keymapping for each user
  • Unique network settings
  • The ability to add scripts both globally or on a per-profile basis

All options stored in The UserData Folder can be customized per profile, allowing for an amazing amount of flexibility.

Note: There are many references to the Master Code below. See Master Lock for more information.

Note: Profiles is an advanced topic in XBMC. XBMC works out of the box without the need of you knowing anything about Profiles. Profiles however may increase the security on your XBMC installation if you feel the need to.

Profile Settings

Selecting Profiles from the main settings window will bring you to the screen pictured to the left. In this screen you have the following options:

Login Screen
Enables/Disables the login screen
Add Profile
Add a new profile
Default User / any available profile name
Select the given profile. In order to edit a profile, just select it. To load another profile, open the context menu by pressing the white button and choose Load profile.



Note that at the bottom of the screen, the currently selected profile is displayed.

Profile1.jpg

Adding a Profile

In order to add a profile, simply choose Add Profile... .

Profile2.jpg

First, you will be prompted to enter a name for your profile. Enter the name for your profile. Then, it will prompt you for your profile directory. This is where your personalized settings will be stored. Choose New Folder and add a folder with the same name as your profile (this is the default). Then select the new directory and choose OK.

You should then see a screen much like the one to the left. The following options are available:

Profile Name
Change the name of your profile
Profile Picture
Allows you to associate a picture with your profile
Profile Directory
Allows you to choose the folder in which your individual settings are stored
Lock Preferences
Allows you to lock many of your preferences. This is detailed below.
Media Info
Allows you to have separate information saved for your media, i.e. IMdB, AllMusic, etc. The options are
      • Separate - Profiles have separate media info with full control
      • Shares with Default - Shares media info with the default user with full control
      • Shares with Default (Read Only) - Shares media info with the default user, and is locked by the master code
      • Separate (Locked) - Profile has separate media info, but you can only change it by enabling master mode.
Media Sources
Allows you to have separate media sources for the profiles. The options are
      • Separate - Profiles have separate media sources with full control
      • Shares with Default - Shares media sources with the default user with full control
      • Shares with Default (Read Only) - Shares media sources with the default user, and is locked by the master code
      • Separate (Locked) - Profiles have separate media sources, but you can only change them by enabling master mode.

The Profile Lock Preferences

Profile Lock
Allows you to set a password for the profile. Locking a profile is essentially the same as setting a password on your computer; it disallows other users from using your profile, modifying your settings or viewing your media shares if they are configured separately from other users. The options are:
      • Numeric Password - Enter a Numeric Password using the On Screen Keyboard
      • Gamepad Button Combo - Enter a series of buttons using the Gamepad
      • Full-Text Password - Enter a plain-text password using the On Screen Keyboard
Lock Music Section
Lock Video Section
Lock Pictures Section
Lock Programs and Scripts Section
Lock File Manager
Lock Settings
Restricts access for the selected profile to the selected sections when selected

Profile3.jpg

Configuring Scripts for Profiles

You have the ability to choose to display scripts on a per-profile basis, as well as globally. This functionality allows you to block other users from using scripts that contain objectionable material.

In order to use this functionality, simply place the scripts that you would like available to all users in the XBMC/Scripts folder. All per-user scripts should be placed in a /Scripts folder within the profile's data folder.

NOTE: The global scripts folder is internally mapped as drive Q:, while the profile scripts folder for the currently loaded script is internally mapped as drive P:.

Switching Profiles

Either you you choose a profile from the login screen (if enabled above).
Or you call up the context menu while in Profile Settings and select "Load Profile".

Manually Editing Profiles

The profile settings are stored in XBMC\System\Profiles.xml. An overview of the structure can be found below.

NOTE: All profile data is stored in this file, therefore it is advisable to back up and reuse this file when upgrading to avoid reconfiguring your profiles!!!

<xml>
<profiles>
    <lastloaded>0</lastloaded>
    <!--last loaded profile.-->
    <useloginscreen>false</useloginscreen>
    <!--enable login screen or not-->

<!--now, the first profile entry is special-->
    <profile>
        <name>spiff</name>
        <directory>q:\userdata</directory>
        <!--allows to move the userdata dir-->
        <lockmode>1</lockmode>
        <lockcode>b53b3a3d6ab90ce0268229151c9bde11</lockcode>
        <!--also known as the master code-->
        <lockmusic>false</lockmusic>
        <lockvideo>false</lockvideo>
        <lockpictures>false</lockpictures>
        <lockprograms>false</lockprograms>
        <locksettings>false</locksettings>
        <lockfiles>false</lockfiles>
        <!--these are profile settings. these only applies
        to the default user. for ppl that would like to stick
        to one profile but use locks.-->

    </profile>

<!--then comes the "normal" profiles.-->
    <profile>
        <name>ba</name>
        <directory>profiles\ba</directory>
        <!--relative to the userdata dir set by the default
        profile. e.g. this means q:\userdata\profiles\ba-->
        <thumbnail>q:\userdata\Thumbnails\Profiles\30f2aad4.tbn</thumbnail>
        <!--The location of the User Picture-->
        <lockmode>1</lockmode>
        <lockcode>ac627ab1ccbdb62ec96e702f07f6425b</lockcode>
        <!--profile lock code. used for login and if applicable, protecting shares.-->
        <lockmusic>false</lockmusic>
        <lockvideo>false</lockvideo>
        <lockpictures>false</lockpictures>
        <lockprograms>false</lockprograms>
        <locksettings>false</locksettings>
        <lockfiles>false</lockfiles>
        <!--again, these are per profile.-->
        <hasdatabases>true</hasdatabases>
        <canwritedatabases>true</canwritedatabases>
        <hassources>true</hassources>
        <canwritesources>true</canwritesources>
        <useavpacksettings>true</useavpacksettings>
        <!--allows the use of customized display settings for each profile
        note: must be specified in each profile-->
   </profile>
</profiles>
</xml>

Profile Settings only Configurable Through Manually Editing Profiles

AV Pack Settings

By adding the following tag in each profile section that you wish it to apply to, you are able to customize the audio and display output options for different profiles:

<xml>

  <profile>
     <useavpacksettings>true</useavpacksettings>
  </profile>

</xml>

This functionality also allows you to customize your settings on a per-AV Pack basis. For example, you can have one set of settings when you have the High Definition Pack installed and then automatically switch to another set when you use the standard AV Pack.

The following settings are affected:

  • Video Settings
  • Game Auto Region
  • Audio Output
  • User Interface Filters
  • Video Filters
  • Display Resolution

The profile-specific AV Pack settings are stored in avpacksettings.xml within the individual profile data folders.