Mok.ini
From Mok HTPC wiki
The mok.ini file includes the main settings for MokCC. All MokCC information is saved in to simple text format. To edit these, use a text editor you like. When configuring MokCC the first time, you need only to change path settings in media sections (here) to get started.
The file is divided in to sections.
- [MOK] section has all the basic parameters. (here)
- [PLAYERS] section has the paths to the players you're using. (here)
- [PLUGIN] section as the name says, tells MokCC which plugins are to be loaded when MokCC starts. These plugins can be anything from user interfaces to external applications. You can create your own plugins with the SDK. (here)
- [Media section] defines the paths, filetypes and the player that is to be used when playing certain types of video or audio. (here)
- [CORE] section includes all the extra, fun and undocumented features you can do with MokCC: This is only for the advanced users. (here)
Contents |
MOK
This is the main section.
| Section / parameter | Description | Example |
|---|---|---|
| [MOK] | This is the main section. | [MOK] |
| CoverPath | Path where your covers (cd/dvd/movie) are saved. | CoverPath=.\covers |
| CoverType | The types of images that are to considered as covers. | CoverType=*.bmp;*.jpg |
| Theme | The theme to use. More about themes, see <xxx> | Theme=mirror |
MEDIATYPE
Here you define the Mok internal mediatypes. There are mtMOV and mtMP3 which the user can define themselves. As values different filestypes are defined. The functionality defines how different filenames and/or paths are interpreted to be parsed.
The mtNONE, mtAPP, mtCDA, mtDVD, mtDIR and mtDIRUP are not possible to specify by the user.
| Section / parameter | Description | Example |
|---|---|---|
| [MEDIATYPE] | ... | [MEDIATYPE] |
| mtMOV | Movie media type. This defines the file extensions that are handled as viewable mediatypes. | mtMOV=*.avi;*.mpg;*.mkv |
| mtMP3 | Music media type. This defines the file extensions that are handled as mediatypes to listen to. | mtMP3=*.ogg;*.mp3;*.wav; |
PLAYERS
This section defines the players that MokCC can use. In most cases it is a 3rd party player that is supported by MokCC itself. It is also possible to create an external player plugin (eg. videolan player plugin). More information on players ***here***.
You can configure any player to play any type of media. Notice thought that the chosen player might not know how to do it (eg. cd audio player can't play DVD-movies).
| Section / parameter | Description | Example |
|---|---|---|
| [PLAYERS] | ... | [PLAYERS] |
| identifier=playerdll | - identifier is an freely defined name for the player to use.
- playerdll is the dll that runs a certain player. These are by default in .\players\ dir in your installation. | |
| path\plr_winamp.dll | The player plugin for Winamp. See also <winamp.ini> | plr_winamp=.\players\plr_winamp.dll |
| path\plr_zoomplayer.dll | The player plugin for Zoomplayer. See also <zoomplayer.ini> | plr_zoomplayer=.\players\zoomplayer.dll |
| path\plr_videolan.dll | The player plugin for Videolan aka VLC. See also <videolan.ini> | plr_videolan=.\players\plr_videolan.dll |
| path\plr_fake.dll | A fake player that is useful for developers while implementing features, but don't want to see or listen to media. | plr_fake=.\players\plr_fake.dll |
PLUGIN
This section defines the plugins that are loaded and used by MokCC.
| Section / parameter | Description | Example |
|---|---|---|
| [PLUGIN] | ... | [PLUGIN] |
| path\plugin.dll | Define the path and the name of the plugin for MokCC to use. There can be several plugins defined; one per row. | .\plugins\tvgui.dll
.\plugins\lcdemu.dll |
Media section
A media section defines where MokCC looks for music, movies and other (media)files. There are some default sections that all themes use (MP3, MOVIE, DVD, CDAUDIO), but nothing limits you to define more.
| Section / parameter | Description | Example |
|---|---|---|
| [ identifier ] | Identifier of the section. The identifier can be anything. The identifier is the reference for user interfaces. See also building themes. | [MP3]
[MOVIE] [DVD] [CDAUDIO] |
| path | Path where your media is found. The scan routine will start from this directory and go through all sub-directories. Multiple paths can be added with a separator ‘;’.
You can also specify a single file. If a specific file is defined, no scanning is done and the file is launched immediately. | path=C:\mp3\
path=C:\mp3\;D:\more_mp3\ path=D:\mp3\song.mp3 path=D:\movies\movie.avi |
| type | The types of files that are to be identified as media. Multiple entries can be added with a separator ';'. Media can be in optical drive or HDD directories.
- Playlists: *.m3u; *.pls (NOTE: You should not mix Music and Playlists in the same type) - MPEG1/2: *.mpg, *.mpeg - DVD: video_ts.ifo (Both from CD/DVD-drive and HDD directory) - VCD: info.vcd (Only from CD/DVD-drive) - SVCD: info.svcd (Only from CD/DVD-drive) - Movies: *.avi; *.wmv, *.mov (not supported with H+ or Eugene) - CD audio: *.cda (Only from CD/DVD-drive) | type=*.mp3;*.ogg
type=*.avi;*.mpg |
Media section example
# Section tag for MP3 play. The name can be anything. [MP3] path=E:\new\mp3\;Z:\ type=*.ogg;*.mp3 plr_id=plr_winamp # Section tag for DVD play. The name can be anything. [DVD] path=Z:\;D:\movies\DVD\ type=video_ts.ifo;*.mpeg plr_id=plr_zoomplayer # Section tag for cd audio play. The name can be anything. [CD AUDIO] path=z:\ # Playing from complete path from a HDD is not supported. plr_id=plr_winamp # Section tag for movie play. The name can be anything. [MOVIE] path=Z:\;D:\movies\ type=*.avi;*.mpg plr_id=zoomplayer
CORE
This section is only for the professionals.
| Section / parameter | Description | Example |
|---|---|---|
| X
Y | X/Y coordinate (Left/Top) for MokCC form. Use this to hide MokCC from screen. | X=800
Y=0 |
| BrowseTime | BrowseTime is the amount of seconds to wait before a browsed list (eg. a long mp3 list) returns to the currently played position in the list.
BrowseTime=0 disables this feature | BrowseTime=10 |
| BrowseValue | BrowseValue is the amount of jumps done in a list if kLeft or kRight is pressed. This makes it possible to browse a list faster than the normal kUp and kDown which moves the list by one. | BrowseValue=5 |
| ZoomPlayerSecondsToSkip | Amount of seconds to Fast forward or rewind when kFwd or kRwd is pressed. Works only with Zoomplayer. | ZoomPlayerSecondsToSkip=30 |
| ZoomPlayerSecondsToJump | Amount of seconds to move forward or backward when kNext or kPrev is pressed. Works only with Zoomplayer. | ZoomPlayerSecondsToJump=150 |
| PlayerLoadRetry | Amount of tries to try to load a player before reporting an error. | PlayerLoadRetry=20 |
| CycleTimeOrig | The default cycle time for MokCC. Everything happens in MokCC in this cycletime; calling dll's, updating lists, etc. | CycleTimeOrig=1000 |
| ErrorWaitTime | Amount of seconds to wait before an error screen automatically presses kStop making MokCC to return to previous state. | ErrorWaitTime=10 |
| SubTitleFilter | MokCC can search for subtitles to be included in it's playlist information. Depending on the player, this information is passed to it as a parameter thus resulting in automatic subtitle activation. | SubTitleFilter=*.sub;*.srt;*.txt |
| SubTitleText | When a subtitle is available for a movie, an extrainfo item %SUBTITLETEXT% will be filled in with the SubTitleText parameter value. | SubTitleText=subtitles available |
| DebugLevel | There are three debuglevel settings for MokCC.
0 : Normal state. Only the most important information is printed. 1 : A bit more information printed out. 2 : A level where MokCC will print out a lot of things on the console. Not usable for anything else than debugging. | DebugLevel=0 |
| DebugWidth | DebugWidth limits the length of a debugmessage. In some cases MokCC prints out long-long-long messages and these are cut to DebugWidth. This is to keep the debug view somewhat readable. | DebugWidth=80 |
DBNAMEFIX
This section defines ...
| Section / parameter | Description | Example |
|---|---|---|
| [PLUGIN] | ... | [PLUGIN] |
| TBD | TBD | _=<SPACE> |
