Installation and update: Difference between revisions

From Miranda NG
Jump to navigation Jump to search
mNo edit summary
(-"Update Icons" option removal warning)
Line 38: Line 38:


=== Selective update of components ===
=== Selective update of components ===
{{Warning|''Update Icons'' option [[Changelog/0.94.5|has been removed]] from the current version of PluginUpdater.}}<!-- The warning is to be removed when v0.94.5 is released -->
PluginUpdater remembers user's choice of the components in the list of updates. If you have a custom langpack or an icon set (e. g. <tt>Proto_Jabber.dll</tt>) which you don't want to update, uncheck the corresponding items in the list. You need to do this once, those components will remain unchecked during the next updates and thus won't get updated.
PluginUpdater remembers user's choice of the components in the list of updates. If you have a custom langpack or an icon set (e. g. <tt>Proto_Jabber.dll</tt>) which you don't want to update, uncheck the corresponding items in the list. You need to do this once, those components will remain unchecked during the next updates and thus won't get updated.



Revision as of 10:07, 6 October 2013

Template:Languages/Installation and update

First and foremost: make a backup copy of your profile regularly, especially before migrating from Miranda IM.


Installing Miranda NG

Installer (recommended)

Archive

  • Go to the Download page, choose and download the latest stable or current (development) version from the "Core and basic plugins" section.
  • Extract the downloaded archive to any folder on your computer. You may create a new folder on a flash drive as well, since Miranda is a portable application by default.
  • Start Miranda executable file and create a new profile. Alternatively, you may copy your Miranda IM profile into Miranda NG program folder (see Upgrading Miranda IM to Miranda NG).


Adding plugins

Some plugins (e. g. HTTPServer, SecureIM, SmileyAdd) may require other plugins or additional files not included in the plugin archive. Information about additional requirements can be found in our wiki. For details see plugin's page, check its description and System requirements section of the plugin card.
PluginUpdater: Component list

Manual method

Plugins can be installed manually, one by one. Download the plugin of appropriate version and extract the contents of the archive into Miranda NG folder keeping the folder structure.

Automatic method

PluginUpdater allows to download and install several plugins at once.

  • Go to Main Menu → Show full plugin list.
  • Select additional plugins and a langpack to install (see the screenshot). Clicking on "Information" icon will open the plugin's wiki page in your browser.
  • Click Download button.


Updating Miranda NG

PluginUpdater: List of updates

PluginUpdater is responsible for keeping your Miranda up-to-date. It checks for updates for all installed plugins and other components like icon sets and langpack regularly (depending on its settings) and performs updating automatically.

Version choice

By default PluginUpdater is set to check updates for the Stable version. So it is likely to rollback your latest Development version of Miranda to stable one. This is not a bug, if want to use the current version, select Development version option in Options… → Services → Plugin Updater. To be on a safe side always make a backup of your Miranda NG installation folder.

Selective update of components

PluginUpdater remembers user's choice of the components in the list of updates. If you have a custom langpack or an icon set (e. g. Proto_Jabber.dll) which you don't want to update, uncheck the corresponding items in the list. You need to do this once, those components will remain unchecked during the next updates and thus won't get updated.


Upgrading Miranda IM to Miranda NG

Before taking any of these steps, make sure you've created a backup copy of your profile and the program itself. All instructions are to be followed at your own risk, the Miranda NG team are not responsible for any data loss or damage.

Upgrading means substitution of all the core Miranda IM files and plugins with their versions for Miranda NG. Due to major changes in the core, Miranda NG is not compatible with plugins for Miranda IM (see Differences from Miranda IM). If any of your current Miranda IM plugins is not adapted for Miranda NG, check Plugin list to see if there's some plugin for the same or similar functionality.

When migrating to Miranda NG you can use your Miranda IM profile (.dat file). This means your old settings, contacts and history will be kept.

Manual method

  • Install Miranda NG and add the appropriate versions of your favourite plugins (or try to find their equivalents) as described above.
  • Copy your Profiles folder with all its files and subfolders as well as other personalization data (like Skins, Smileys, Icons and Sounds folders with their files) to your new Miranda NG installation.

Automatic method

This method works only for Miranda IM v0.8 and later.

Download IM Updater plugin, unpack the whole archive into your Miranda IM program folder and then run or restart the program. IM Updater will:

  • Replace the core files and the appropriate plugins with their NG equivalents.
  • Rename old Unicode plugins that have the trailing W in their names.
  • Make a backup of any obsolete plugins.

Regardless of the method you use for upgrading you'll probably face some problems with skins. See v0.94.3 release notes for instructions on how to solve them.