Mirandaboot.ini

From Miranda NG
Revision as of 23:55, 20 August 2024 by FuzzyBot (talk | contribs) (Updating to match new version of source page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Mirandaboot.ini/en
Jump to navigation Jump to search

File mirandaboot.ini contains the information required to get Miranda NG up and running, i.e., everything before a database is loaded.

Content of the file

     See: mirandaboot.ini

Description of parameters

[Database]

Settings related to the location and loading of the database.

ProfileDir

Allows you to specify the directory to search for database files. You can use environment variables.

If it's a relative path then it's relative to the directory containing Miranda*.exe file.

To comply with Windows security guidelines, it is recommended that you keep your profile in %APPDATA%\Miranda NG.

If you do not specify directory, then default will be used, which is Profiles subdirectory in Miranda NG root folder.

ProfileDir=


ShowProfileMgr

Decides whether to show the profile manager on Miranda NG startup.

Accepts values:

  • never — Show it only if the profile to use can't be guessed by any means.
  • yes — Show it always.
  • smart — (default) Show it if the command line doesn't contain a database name that exists and there is more or less than one database file in the ProfileDir.
ShowProfileMgr=smart


DefaultProfile

Name of the profile to use if there's a choice. It can contain environment variables, e.g., %USERNAME%.

If Miranda is run with a command line parameter then that parameter is used instead of this setting.

If ShowProfileMgr=never then this profile is run without a question. Otherwise the profile manager is run as usual but initially this profile is selected.

Default value: It is empty.

DefaultProfile=


AutoCreate

Accepts values:

  • yes — If DefaultProfile setting or the command line parameter gives a profile name that doesn't exist then that profile is created.
  • no — (default) The profile manager is shown in this case.
AutoCreate=no


RememberPassword

When set to 1 it will store password in Windows Credential Manager.

Default value: 0

RememberPassword=0


SilentUpgrade

When set to 1 it will not show notification window about database upgrade.

Default value: 0

SilentUpgrade=0

[AutoExec]

AutoExec is a system for batch addition of multiple settings to the database.

Use

Accepts values:

  • yes — Install .ini files automatically.
  • no — Disable the AutoExec system entirely.
  • prompt — (default) Prompt the user before each installation. This setting doesn't affect the decision of whether to display further prompts.
Use=prompt


Glob

A global expression containing the files to watch for database settings. This will be checked just after database load and continuously all the time Miranda is running.

If this contains a relative path, it's relative to the directory containing Miranda*.exe file.

Default value: autoexec_*.ini

Glob=autoexec_*.ini


Safe

A space-separated list of database module names known to be safe to alter.

Default value: CLC Icons CLUI CList SkinSounds

Safe=CLC Icons CLUI CList SkinSounds


Unsafe

A space-separated list of database module names that could be altered for malicious purposes (e.g., by faking a login server to steal passwords).

Default value: Facebook GG IRC JABBER SKYPE TWITTER VKontakte

Unsafe=Facebook GG IRC JABBER SKYPE TWITTER VKontakte


OverrideSecurityFilename

System administrators may find it desirable to install settings without prompting the user. In that case all prompts and security will be overridden if the name of the .ini file matches the name given here.

If this is used, make sure it's suitably random and hence not likely to be downloaded.

Default value: It is empty (no override possible).

OverrideSecurityFilename=


OnCreateFilename

Defines .ini file that will be executed every time new profile is created.

Default value: It is empty (no override possible).

OnCreateFilename=


Warn

Accepts values:

  • all — Warn the user before each setting change is made.
  • notsafe — (default) Warn before each change to a setting in a group that isn't listed in the Safe setting.
  • onlyunsafe — Warn before each change to a setting in a group that is listed in the Unsafe setting.
  • none — Never warn the user.
Warn=notsafe


OnCompletion

Defines what to do with the .ini file once it's imported.

Accepts values:

  • delete — Delete the file from the disk.
  • recycle — (default) Move the file to the recycle bin (same as delete if you've disabled Windows' recycle bin).
  • rename — Add the string from the RenamePrefix setting to the beginning of the filename.
  • leave — Leave the file as-is. Note that this could cause it to be imported multiple times until it's moved.
  • ask — Show a dialog to ask the user.
OnCompletion=recycle

RenamePrefix

A string to add before the filename if the rename option is used for OnCompletion setting. This can include a path specifier to move the file, e.g., ..\

Default value: done_

RenamePrefix=done_

[PluginLoader]

Settings that determine how plugins are loaded.

AskAboutIgnoredPlugins

When set to 1, will ask if re-enable a disabled plugin.

Default value: 0

AskAboutIgnoredPlugins=0

[Language]

Language related settings.

DefaultLanguage

Stores the name of the default language pack to be loaded at startup. If skipped, loads the first file that matches the langpack_*.txt mask.

Example: DefaultLanguage=langpack_german.txt

It also accepts value of:

  • default — Built-in English language.

Default value: It is empty.

DefaultLanguage=


[Interface]

Interface related settings.

DpiAware

Experimental! Enables HiDPI ("Retina Display") support when set to 1.

Default value: 0

DpiAware=0