Default File Locations

From MercuryWiki

Jump to: navigation, search

Mercury has 2 main locations for storing files:

All these locations can be customized, so your own specific locations may differ a bit. It may however still be useful to know where certain files go by default. The structure of this overview is as follows:

  • Every bulleted item represents a folder
  • Any information about files in that folder (if present) is given in that same bulleted item
  • Sub-folders are represented by sub-bulleted items


Contents

Mercury 2.0 Unstable

the program directory

  • jni: holds native OS files
    • jmf: holds native OS files for the Java Media Framework (may be stored in jni folder, in which case jmf folder doesn't exist)
  • lib: holds java libraries for different features in Mercury
  • resources
    • AppData : holds default files that come with Mercury
      • CustomEmoticons: holds custom emoticon packs
      • Games: holds mercury games (none available anymore)
      • i18n: holds language files for internationalization
      • Images: holds packs with images for use in Mercury, like logo's and icons
      • MusicPlayerInfo: holds XML file with commands to request current song info (for Linux players only, for now)
      • Plugins: holds plugins (none available, for now)
      • Skins: holds SkinLF skin files (none by default, go here for information on adding skins through skin libraries)
      • Sounds: holds the sounds that Mercury can use when events are triggered
      • SplashWindow: holds splash window packs
      • StatusIcons: holds status icon packs
      • Views: holds installed view packages
      • Winks: holds Mercury's wink files
    • config: holds configuration files (in XML) for program operation (not for feature selection)
    • menu: holds the menu structure for most menu's in XML files
      • msn.xml: holds the menu structure for the contact list, conversation window
    • settings: holds the default values for global and account settings in XML files
    • webremote: holds web interface for the (experimental) web-based Mercury access
    • xsl: holds stylesheets for the XML logs
  • startup: holds Linux and Windows startup scripts for both regular and usb-mode startup

the settings directory

holds the XML files for the global settings (including custom view code) and profiles (shown on the System tab when Mercury starts)

  • AppData : similiar to AppData of program directory, this one holds files that the user has installed
  • Cache: holds cached thumbnails from images used in Mercury
  • Debug: holds Info Log and Communication Log. These files may be requested when reporting a bug. On startup, 2 hours old logs are removed ( global setting debug.files.expire.time)
  • MSN
    • Accounts: holds account settings in folders named after the account email
      • <account-email>: holds account information
        • Account.xml: holds all settings from account preferences (including password, display pictures, etc..)
        • cache (may contain more folders than shown here, depending on what your contacts use)
          • CustomEmoticons: holds the custom emoticons used by your contacts (if you don't already have that emoticon)(in contact-specific folders)
          • DisplayPictures: holds display pictures used by your contacts (in contact-specific folders)
          • VoiceClips: holds voiceclips recorded by your contacts (in contact-specific folders)
          • Webcam: holds webcam streams from your contacts (in contact-specific folders)
          • Winks: holds winks used by your contacts (in contact-specific folders)
        • logs
          • events: holds logs on events occuring in the account
          • text: holds the text logs for chats (chat history in txt files) (in separate folders for each month, if enabled)
          • xml: holds the XML logs for chats (chat history in XML files) (in separate folders for each month, if enabled)
        • received_files: holds the files you receive through Mercury (in contact-specific folders, if enabled)

Mercury 1.9 Stable

the program directory

  • jni: holds native OS files
    • jmf: holds native OS files for the Java Media Framework (may be stored in jni folder, in which case jmf folder doesn't exist)
  • lib: holds java libraries for different features in Mercury
  • resources
    • AppData
      • CustomEmoticons: holds custom emoticon packs
      • Games: holds mercury games (none available anymore)
      • Images: holds packs with images for use in Mercury, like logo's and icons
      • Plugins: holds plugins (none available, for now)
      • Skins: holds SkinLF skin files (none by default, go here for information on adding skins through skin libraries)
      • Sounds: holds the sounds that Mercury can use when events are triggered
      • SplashWindow: holds splash window packs
      • StatusIcons: holds status icon packs
      • Views: holds installed view packages
      • Winks: holds Mercury's wink files
    • config: holds configuration files (in XML) for program operation (not for feature selection)
    • lang: holds language files
    • menu: holds the menu structure for most menu's in XML files
    • settings: holds the default values for global and account settings in XML files
    • xsl: holds stylesheets for the XML logs
  • startup: holds Linux and Windows startup scripts for both regular and usb-mode startup

the settings directory

holds the XML files for the global settings (including custom view code) and profiles (shown on the System tab when Mercury starts)

  • AppData: same as AppData in the <program directory>/resources folder, but holds no files (may be obsolete, can anyone verify?)
  • Debug: holds Info Log and Communication Log. These files may be requested when reporting a bug. Previous logs are (usually) removed when starting Mercury.
  • MSN
    • Accounts: holds account settings in folders named after the account email
      • <account-email>: holds account information
        • Account.xml: holds all settings from account preferences (including password, display pictures, etc..)
        • cache (may contain more folders than shown here, depending on what your contacts use)
          • CustomEmoticons: holds the custom emoticons used by your contacts (if you don't already have that emoticon)(in contact-specific folders)
          • DisplayPictures: holds display pictures used by your contacts (in contact-specific folders)
          • VoiceClips: holds voiceclips recorded by your contacts (in contact-specific folders)
          • Webcam: holds webcam streams from your contacts (in contact-specific folders)
          • Winks: holds winks used by your contacts (in contact-specific folders)
        • logs
          • events: holds logs on events occuring in the account
          • text: holds the text logs for chats (chat history in txt files) (in separate folders for each month, if enabled)
          • xml: holds the XML logs for chats (chat history in XML files) (in separate folders for each month, if enabled)
        • received_files: holds the files you receive through Mercury (in contact-specific folders, if enabled)
Personal tools