This page is out of date! Information moved here: WIKI


file: mok.ini

Last update: 2006-02-15

This information is for v2.3.2+.

Older information for v2.3.0 and v2.3.1 here.


This 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 section] to get started.

The file is divided in to sections.
- [MOK] section has all the basic parameters
- [PLAYERS] section has the paths to the players you're using.
- [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 (link not available yet).
- [media section] defines the paths, filetypes and the player that is to be used when playing certain types of video or audio. It can be named as anything (eg. [MP3]).
- [CORE] section includes all the extra, fun and undocumented features you can do with MokCC: This is only for the advanced users.


Section: [MOK]

Section / parameter

Description

[MOK]

This is the main section.

Username

User name of the owner of this copy of MOK.ini. Currently not used; it's free!

Username=Jorma Koski

Code

Registration code received from MOK developers. Currently not used; it's free!

Code=12345676543

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=blue_jani



Section: [PLUGIN]

[PLUGIN]

This section defines the plugins that are loaded and used by MokCC.

path\plugin.dll

The path and name of a plugin to load.

[PLUGIN]
.\plugins\tvgui.dll
.\plugins\lcdemu.dll



Section: [PLAYERS]

[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.

eugene

path\station.exe (eg. .\eugene's dvd player\station.exe

hplus

path\station.exe

goatcd

path\goatcd.exe

winamp

path\winamp.exe

winamp=c:\apps\winamp\winamp.exe

zoomplayer

path\zplayer.exe

bsplayer

path\bsplay.exe (currently not supported)

playerplugin

path\playerplugin.dll

videolan=.\players\videolan.dll



Section: [MEDIA]

[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

[identifier]

Identifier of the section. The identifier can be anything. The identifier is the reference for user interfaces. See also building themes (tbd).

[MP3]
[MOVIE]
[DVD]
[CDAUDIO]

db

Path and name of the file which includes the media database. For information on how to configure your own database, see here. You can have all of them in one file or split to multiple files.

db=.\db\db.ini

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 ‘;’.

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.

- Music: *.mp3; *.ogg; *.wma
- 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

plr_id

The identifier for the player to use. 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).

The plr_id list can be found from [PLAYERS] section.

plr_id=winamp


Examples of [media sections]

# Section tag for MP3 play. The name can be anything.
# See also building themes (tbd).

[MP3]
db=.\db\db.ini
path=E:\new\mp3\;Z:\
Plr_Id=winamp

# Section tag for DVD play. The name can be anything.
[DVD]
db=.\db\db.ini
Path=Z:\;D:\movies\DVD\
Type=video_ts.ifo;*.mpeg
Plr_Id=eugene

# Section tag for cd audio play. The name can be anything.
[CD AUDIO]
db=.\db\db.ini
Path=z:\
# Playing from complete path from a HDD is not supported.
plr_id=goatcd

# Section tag for movie play. The name can be anything.
[MOVIE]
db=.\db\db.ini
Path=Z:\;D:\movies\
Type=*.avi;*.mpg
Plr_id=zoomplayer



Section: [CORE]

This section is only for the professionals.

[CORE]

Sectiong tag

X
Y

X/Y coordinate (Left/Top) for MokCC form. Use this to hide MokCC from screen.

X=800
Y=0

BrowseTime
BrowseValue

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

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.

BrowseTime=10
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
SubTitleText

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.

When a subtitle is available for a movie, an extrainfo item %SUBTITLETEXT% will be filled in with the SubTitleText parameter value.

SubTitleFilter=*.sub;*.srt;*.txt
SubTitleText=subtitles available

DebugLevel
DebugWidth

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.

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.


DebugLevel=0
DebugWidth
=80

A lot of more parameters here