- Types of Media Sources
- Sharing Media from Your PC
- NAS (Network Attached Storage)
- User Profiles
- The UserData Folder
- Special protocol
- RSS Feeds
- RSS feed Control
- Advanced Configuration
- Log file
- USB Mass Storage in Xbox
- Error Recovery Mode
- Import - Export Library
- XBMC's Inner Workings
- Development Notes
- Python Development
- Skinning XBMC
- List of Built In Functions
- Web Server HTTP API
- The XBMC Database
- Audio Players
- Video Players
- HOW-TO write Media Scrapers
- Regular Expression Tutorial
- Point Releases
- HOW-TO's / Tips & Tricks
- Mods to XBMC and Xbox
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.
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:
Adding a Profile
In order to add a profile, simply choose Add Profile... .
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.
The Profile Lock Preferences
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:.
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".
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:
<profile> <useavpacksettings>true</useavpacksettings> </profile>
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.