Mirandaboot.ini: Difference between revisions

From Miranda NG
Jump to navigation Jump to search
(fill [AutoExec])
(Marked this version for translation)
Line 1: Line 1:
<languages/>
<languages/>
<big><translate>File <tvar|ini_file>'''mirandaboot.ini'''</> contains the information required to get Miranda NG up and running, i.e., everything before a database is loaded.</translate></big>
<big><translate><!--T:1--> File <tvar|ini_file>'''mirandaboot.ini'''</> contains the information required to get Miranda NG up and running, i.e., everything before a database is loaded.</translate></big>


__TOC__
__TOC__


<translate>
<translate>
== Content of the file ==
== Content of the file == <!--T:2-->
</translate>
</translate>
: ''<translate>See:</translate> [[mirandaboot.ini/Raw file|mirandaboot.ini]]''
: ''<translate><!--T:3--> See:</translate> [[mirandaboot.ini/Raw file|mirandaboot.ini]]''


<translate>
<translate>
== Description of parameters ==
== Description of parameters == <!--T:4-->
</translate>
</translate>


=== [Database] ===
=== [Database] ===
<translate>
<translate>
<!--T:5-->
Settings related to the location and loading of the database.
Settings related to the location and loading of the database.
</translate>
</translate>
Line 20: Line 21:
==== ProfileDir ====
==== ProfileDir ====
<translate>
<translate>
<!--T:6-->
Allows you to specify the directory to search for database files. If it's a relative path then it's relative to the directory containing <tvar|exe_file>Miranda*.exe</> file. You can use environment variables. To comply with Windows security guidelines, it is recommended that you keep your profile in <tvar|APPDATA>%APPDATA%\Miranda NG</>.
Allows you to specify the directory to search for database files. If it's a relative path then it's relative to the directory containing <tvar|exe_file>Miranda*.exe</> file. You can use environment variables. To comply with Windows security guidelines, it is recommended that you keep your profile in <tvar|APPDATA>%APPDATA%\Miranda NG</>.


<!--T:7-->
If you do not specify directory, then default will be used, which is <tvar|Profiles_dir><code>Profiles</code></> subdirectory in Miranda NG root folder.
If you do not specify directory, then default will be used, which is <tvar|Profiles_dir><code>Profiles</code></> subdirectory in Miranda NG root folder.
</translate>
</translate>
Line 29: Line 32:
==== ShowProfileMgr ====
==== ShowProfileMgr ====
<translate>
<translate>
<!--T:8-->
Decides whether to show the profile manager on Miranda NG startup.
Decides whether to show the profile manager on Miranda NG startup.


<!--T:9-->
Accepts values:
Accepts values:
</translate>
</translate>
* <code>never</code> — <translate>Show it only if the profile to use can't be guessed by any means.</translate>
* <code>never</code> — <translate><!--T:10--> Show it only if the profile to use can't be guessed by any means.</translate>
* <code>yes</code> — <translate>Show it always.</translate>
* <code>yes</code> — <translate><!--T:11--> Show it always.</translate>
* <code>smart</code> — <translate>(default) Show it if the command line doesn't contain a database name that exists or there is more or less than one database file in the <tvar|ProfileDir>[[#ProfileDir|ProfileDir]]</>.</translate>
* <code>smart</code> — <translate><!--T:12--> (default) Show it if the command line doesn't contain a database name that exists or there is more or less than one database file in the <tvar|ProfileDir>[[#ProfileDir|ProfileDir]]</>.</translate>
  ShowProfileMgr=smart
  ShowProfileMgr=smart


Line 41: Line 46:
==== DefaultProfile ====
==== DefaultProfile ====
<translate>
<translate>
<!--T:13-->
Name of the profile to use if there's a choice. It can contain environment variables, e.g., <tvar|USERNAME><code>%USERNAME%</code></>.
Name of the profile to use if there's a choice. It can contain environment variables, e.g., <tvar|USERNAME><code>%USERNAME%</code></>.


<!--T:14-->
If Miranda is run with a command line parameter then that parameter is used instead of this setting.
If Miranda is run with a command line parameter then that parameter is used instead of this setting.


<!--T:15-->
If <tvar|ShowProfileMgr_never>[[#ShowProfileMgr|ShowProfileMgr=never]]</> then this profile is run without a question. Otherwise the profile manager is run as usual but initially this profile is selected.
If <tvar|ShowProfileMgr_never>[[#ShowProfileMgr|ShowProfileMgr=never]]</> then this profile is run without a question. Otherwise the profile manager is run as usual but initially this profile is selected.


<!--T:16-->
Default value: It is empty.
Default value: It is empty.
</translate>
</translate>
Line 54: Line 63:
==== AutoCreate ====
==== AutoCreate ====
<translate>
<translate>
<!--T:17-->
Accepts values:
Accepts values:
</translate>
</translate>
* <code>yes</code> — <translate>If <tvar|DefaultProfile>[[#DefaultProfile|DefaultProfile]]</> setting or the command line parameter gives a profile name that doesn't exist then that profile is created.</translate>
* <code>yes</code> — <translate><!--T:18--> If <tvar|DefaultProfile>[[#DefaultProfile|DefaultProfile]]</> setting or the command line parameter gives a profile name that doesn't exist then that profile is created.</translate>
* <code>no</code> — <translate>(default) The profile manager is shown in this case.</translate>
* <code>no</code> — <translate><!--T:19--> (default) The profile manager is shown in this case.</translate>
  AutoCreate=no
  AutoCreate=no


Line 63: Line 73:
==== RememberPassword ====
==== RememberPassword ====
<translate>
<translate>
<!--T:20-->
When set to <tvar|rememberPass_enabled><code>1</code></> it will store password in Windows Credential Manager.
When set to <tvar|rememberPass_enabled><code>1</code></> it will store password in Windows Credential Manager.
</translate>
</translate>


<translate>Default value:</translate> <code>0</code>
<translate><!--T:21--> Default value:</translate> <code>0</code>
  RememberPassword=0
  RememberPassword=0


Line 72: Line 83:
=== [AutoExec] ===
=== [AutoExec] ===
<translate>
<translate>
<!--T:22-->
AutoExec is a system for batch addition of multiple settings to the database.
AutoExec is a system for batch addition of multiple settings to the database.
</translate>
</translate>
Line 77: Line 89:
==== Use ====
==== Use ====
<translate>
<translate>
<!--T:23-->
Accepts values:
Accepts values:
</translate>
</translate>
* <code>yes</code> — <translate>Install <tvar|file_extension>.ini</> files automatically.</translate>
* <code>yes</code> — <translate><!--T:24--> Install <tvar|file_extension>.ini</> files automatically.</translate>
* <code>no</code> — <translate>Disable the <tvar|AutoExec>AutoExec</> system entirely.</translate>
* <code>no</code> — <translate><!--T:25--> Disable the <tvar|AutoExec>AutoExec</> system entirely.</translate>
* <code>prompt</code> — <translate>(default) Prompt the user before each installation. This setting doesn't affect the decision of whether to display further prompts.</translate>
* <code>prompt</code> — <translate><!--T:26--> (default) Prompt the user before each installation. This setting doesn't affect the decision of whether to display further prompts.</translate>
  Use=prompt
  Use=prompt


Line 87: Line 100:
==== Glob ====
==== Glob ====
<translate>
<translate>
<!--T:27-->
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.
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.


<!--T:28-->
If this contains a relative path, it's relative to the directory containing <tvar|exe_file>Miranda*.exe</> file.
If this contains a relative path, it's relative to the directory containing <tvar|exe_file>Miranda*.exe</> file.
</translate>
</translate>


<translate>Default value:</translate> <code>autoexec_*.ini</code>
<translate><!--T:29--> Default value:</translate> <code>autoexec_*.ini</code>
  Glob=autoexec_*.ini
  Glob=autoexec_*.ini


Line 98: Line 113:
==== Safe ====
==== Safe ====
<translate>
<translate>
<!--T:30-->
A space-separated list of database module names known to be safe to alter.
A space-separated list of database module names known to be safe to alter.
</translate>
</translate>


<translate>Default value:</translate> <code>CLC Icons CLUI CList SkinSounds</code>
<translate><!--T:31--> Default value:</translate> <code>CLC Icons CLUI CList SkinSounds</code>
  Safe=CLC Icons CLUI CList SkinSounds
  Safe=CLC Icons CLUI CList SkinSounds


Line 107: Line 123:
==== Unsafe ====
==== Unsafe ====
<translate>
<translate>
<!--T:32-->
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).
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).
</translate>
</translate>


<translate>Default value:</translate> <code>Facebook GG ICQ IRC JABBER MRA MSN SKYPE TWITTER VKontakte</code>
<translate><!--T:33--> Default value:</translate> <code>Facebook GG ICQ IRC JABBER MRA MSN SKYPE TWITTER VKontakte</code>
  Unsafe=Facebook GG ICQ IRC JABBER MRA MSN SKYPE TWITTER
  Unsafe=Facebook GG ICQ IRC JABBER MRA MSN SKYPE TWITTER


Line 116: Line 133:
==== OverrideSecurityFilename ====
==== OverrideSecurityFilename ====
<translate>
<translate>
<!--T:34-->
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 <tvar|file_extension>.ini</> file matches the name given here.
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 <tvar|file_extension>.ini</> file matches the name given here.


<!--T:35-->
If this is used, make sure it's suitably random and hence not likely to be downloaded.
If this is used, make sure it's suitably random and hence not likely to be downloaded.


<!--T:36-->
Default value: It is empty (no override possible).
Default value: It is empty (no override possible).
</translate>
</translate>
Line 127: Line 147:
==== OnCreateFilename ====
==== OnCreateFilename ====
<translate>
<translate>
<!--T:37-->
Defines <tvar|file_extension>.ini</> file that will be executed every time new profile is created.
Defines <tvar|file_extension>.ini</> file that will be executed every time new profile is created.


<!--T:38-->
Default value: It is empty (no override possible).
Default value: It is empty (no override possible).
</translate>
</translate>
Line 136: Line 158:
==== Warn ====
==== Warn ====
<translate>
<translate>
<!--T:39-->
Accepts values:
Accepts values:
</translate>
</translate>
* <code>all</code> — <translate>Warn the user before each setting change is made.</translate>
* <code>all</code> — <translate><!--T:40--> Warn the user before each setting change is made.</translate>
* <code>notsafe</code> — <translate>(default) Warn before each change to a setting in a group that isn't listed in the <tvar|Safe>[[#Safe|Safe]]</> setting.</translate>
* <code>notsafe</code> — <translate><!--T:41--> (default) Warn before each change to a setting in a group that isn't listed in the <tvar|Safe>[[#Safe|Safe]]</> setting.</translate>
* <code>onlyunsafe</code> — <translate>Warn before each change to a setting in a group that is listed in the <tvar|Unsafe>[[#Unsafe|Unsafe]]</> setting.</translate>
* <code>onlyunsafe</code> — <translate><!--T:42--> Warn before each change to a setting in a group that is listed in the <tvar|Unsafe>[[#Unsafe|Unsafe]]</> setting.</translate>
* <code>none</code> — <translate>Never warn the user.</translate>
* <code>none</code> — <translate><!--T:43--> Never warn the user.</translate>
  Warn=notsafe
  Warn=notsafe


Line 147: Line 170:
==== OnCompletion ====
==== OnCompletion ====
<translate>
<translate>
<!--T:44-->
Defines what to do with the <tvar|file_extension>.ini</> file once it's imported.
Defines what to do with the <tvar|file_extension>.ini</> file once it's imported.


<!--T:45-->
Accepts values:
Accepts values:
</translate>
</translate>
* <code>delete</code> — <translate>Delete the file from the disk.</translate>
* <code>delete</code> — <translate><!--T:46--> Delete the file from the disk.</translate>
* <code>recycle</code> — <translate>(default) Move the file to the recycle bin (same as delete if you've disabled Windows' recycle bin).</translate>
* <code>recycle</code> — <translate><!--T:47--> (default) Move the file to the recycle bin (same as delete if you've disabled Windows' recycle bin).</translate>
* <code>rename</code> — <translate>Add the string from the <tvar|RenamePrefix>[[#RenamePrefix|RenamePrefix]]</> setting to the beginning of the filename.</translate>
* <code>rename</code> — <translate><!--T:48--> Add the string from the <tvar|RenamePrefix>[[#RenamePrefix|RenamePrefix]]</> setting to the beginning of the filename.</translate>
* <code>leave</code> — <translate>Leave the file as-is. Note that this could cause it to be imported multiple times until it's moved.</translate>
* <code>leave</code> — <translate><!--T:49--> Leave the file as-is. Note that this could cause it to be imported multiple times until it's moved.</translate>
* <code>ask</code> — <translate>Show a dialog to ask the user.</translate>
* <code>ask</code> — <translate><!--T:50--> Show a dialog to ask the user.</translate>
  OnCompletion=recycle
  OnCompletion=recycle


Line 161: Line 186:
==== RenamePrefix ====
==== RenamePrefix ====
<translate>
<translate>
<!--T:51-->
A string to add before the filename if the <tvar|rename_opt><code>rename</code></> option is used for <tvar|OnCompletion>[[#OnCompletion|OnCompletion]] setting</>. This can include a path specifier to move the file, e.g., <tvar|path_specifier><code>..\</code></>
A string to add before the filename if the <tvar|rename_opt><code>rename</code></> option is used for <tvar|OnCompletion>[[#OnCompletion|OnCompletion]] setting</>. This can include a path specifier to move the file, e.g., <tvar|path_specifier><code>..\</code></>
</translate>
</translate>


<translate>Default value:</translate> <code>done_</code>
<translate><!--T:52--> Default value:</translate> <code>done_</code>
  RenamePrefix=done_
  RenamePrefix=done_


Line 170: Line 196:
=== [PluginLoader] ===
=== [PluginLoader] ===
<translate>
<translate>
<!--T:53-->
Settings that determine how plugins are loaded.
Settings that determine how plugins are loaded.
</translate>
</translate>
Line 175: Line 202:
==== AskAboutIgnoredPlugins ====
==== AskAboutIgnoredPlugins ====
<translate>
<translate>
<!--T:54-->
When set to <tvar|AAIP_eneabled><code>1</code></>, will ask if re-enable a disabled plugin.
When set to <tvar|AAIP_eneabled><code>1</code></>, will ask if re-enable a disabled plugin.
</translate>
</translate>


<translate>Default value:</translate> <code>0</code>
<translate><!--T:55--> Default value:</translate> <code>0</code>
  AskAboutIgnoredPlugins=0
  AskAboutIgnoredPlugins=0


Line 184: Line 212:
=== [Language] ===
=== [Language] ===
<translate>
<translate>
<!--T:56-->
Language related settings.
Language related settings.
</translate>
</translate>
Line 189: Line 218:
==== DefaultLanguage ====
==== DefaultLanguage ====
<translate>
<translate>
<!--T:57-->
Stores the name of the default language pack to be loaded at startup. If skipped, loads the first file that matches the <tvar|file_mask><code>langpack_*.txt</code></> mask.
Stores the name of the default language pack to be loaded at startup. If skipped, loads the first file that matches the <tvar|file_mask><code>langpack_*.txt</code></> mask.
</translate>
</translate>


<translate>Example:</translate> <code>DefaultLanguage=langpack_german.txt</code>
<translate><!--T:58--> Example:</translate> <code>DefaultLanguage=langpack_german.txt</code>


<translate>
<translate>
<!--T:59-->
It also accepts value of:
It also accepts value of:
</translate>
</translate>
* <code>default</code> — <translate>Built-in English language.</translate>
* <code>default</code> — <translate><!--T:60--> Built-in English language.</translate>


<translate>
<translate>
<!--T:61-->
Default value: It is empty.
Default value: It is empty.
</translate>
</translate>
Line 207: Line 239:
=== [Interface] ===
=== [Interface] ===
<translate>
<translate>
<!--T:62-->
Interface related settings.
Interface related settings.
</translate>
</translate>
Line 212: Line 245:
==== DpiAware ====
==== DpiAware ====
<translate>
<translate>
<!--T:63-->
{{Strong|Experimental!}} Enables HiDPI ("Retina Display") support when set to <tvar|dpi_enabled><code>1</code></>.
{{Strong|Experimental!}} Enables HiDPI ("Retina Display") support when set to <tvar|dpi_enabled><code>1</code></>.
</translate>
</translate>


<translate>Default value:</translate> <code>0</code>
<translate><!--T:64--> Default value:</translate> <code>0</code>
  DpiAware=0
  DpiAware=0


[[Category: Pomoc]]
[[Category: Pomoc]]

Revision as of 15:02, 8 April 2018

Other languages:

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. If it's a relative path then it's relative to the directory containing Miranda*.exe file. You can use environment variables. 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 or 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


[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 ICQ IRC JABBER MRA MSN SKYPE TWITTER VKontakte

Unsafe=Facebook GG ICQ IRC JABBER MRA MSN SKYPE TWITTER


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