Important File Locations

Translations:

Installation Folder

The default location varies by platform, and the name of the directory corresponds to the version of Komodo you are running (“IDE” or “Edit” plus the version number - e.g. “Komodo IDE 8”):

  • Windows
    C:\Program Files\ActiveState Komodo [IDE|Edit] <version>\
  • Linux
    /opt/Komodo-[IDE|Edit]-<version>/
  • OS X
    /Applications/Komodo-[IDE|Edit]-<version>.app

Profile Folder

Komodo stores preferences, macros, templates, keybinding schemes and other settings in a user-specific directory called the user data directory. The name and location of this directory varies depending on the operating system and Komodo version:

  • Windows Vista, Windows 7, Windows 8 or newer
    C:\Users\<username>\AppData\Local\ActiveState\Komodo[IDE|Edit]\<version>
  • Windows XP or older
    C:\Documents and Settings\<username>\Local Settings\Application Data\ActiveState\Komodo[IDE|Edit]\<version>
  • Linux
    /home/<username>/.komodo[ide|edit]/<version>
  • Mac OS X
    /Users/<username>/Library/Application Support/Komodo[IDE|Edit]/<version>

File Structure

**prefs.xml**

Stores all of the user preferences for Komodo. If you
want to reset your Komodo preferences, the easiest way
is to simply remove these two files and Komodo will
rebuild them with the default values on next startup.

**doc-state.xmlc**

This file stores the individual file preferences, set
through the Edit - Current File Preferences... menu. Things
like the current file position, indentation settings,
encoding, bookmarks, folding and eol settings.

**view-state.xmlc**

This file stores view state, such as the MRU (most
recently used) ordering, recently opened files, tab
ordering position, etc…

**toolbox.sqlite**

Stores information about your Komodo toolbox. You can copy
these between profiles, or to another machine.

**pystderr.log**

The Komodo error log, whenever you run into issues and wish
to report them be sure to include this file.

This file is purged every time you start Komodo.

**tools/**

Contains JSON files for each of the tools in your toolbox.

**apicatalogs/**

All API catalogs (codeintel cix files) that are added through
Komodo’s “Code Intelligence” preferences get copied to this
directory.

**project-templates/**

Stores all known project templates, available when
using the Project - New From Template menu.

**templates/**

Stores all known file/language templates, available when
using the `File - New - File from Template…" menu.

**samples/**

This is where Komodo stores the sample files and projects.

**schemes/**

This is where Komodo stores the user’s custom keybindings
and color schemes.

**autosave/**

The Komodo auto-save feature will save information
relating to Komodo’s unsaved files in this directory.
If you open a file that has a matching backup in this
directory, Komodo will offer to restore the backup.

**codeintel/**

Code intelligence information. When Komodo scans any
source code file (PHP, JS, Python, etc…) or API
catalogs, it saves this processed information (containing
the function and variable information, calltips etc…)
to a file in this directory.

If you Komodo code intelligence is not working, it can
often be fixed by shutting down Komodo, removing this
directory and then starting Komodo again, which will
then cause a rescan/recreate of the necessary code files.

**XRE/**

Details relating to the Mozilla base that Komodo is
using (extensions, dialog and window settings, remote
file encrypted password files, etc…).

Overriding The Profile Folder Location

The location of the profile directory can be (temporarily) overridden using the KOMODO_USERDATADIR environment variable. This is useful in case you want to:

  • Run multiple instances of Komodo
  • Run Komodo on eg. a USB stick
  • Test whether an issue you’re having persists on a clean profile

To set this environment variable you need to open your terminal or command prompt and execute

  • Windows: set KOMODO_USERDATADIR=%TEMP%\komodo
  • Mac/Linux: export KOMODO_USERDATADIR=/tmp/komodo

Then still from your terminal / command prompt start Komodo:

  • Windows: START <installation-folder>\ko.exe
  • Mac: open /Applications/Komodo-[IDE|Edit]-<version>.app
  • Linux: /opt/Komodo-[IDE|Edit]-<version>/komodo

Deleting The Profile Folder

If you ever wish to completely reset your Komodo settings you can do so by shutting down Komodo and deleting your profile folder. Komodo will re-generate your profile folder the next time you start it. We recommend that you always make a backup of your profile folder before deleting it.

Log Files

There are two files named “pystderr.log” and “pystdout.log” within your Komodo profile folder. These files are extremely useful for troubleshooting problems with Komodo and are often requested when logging bug reports.

Note: You can use the Help > Trouble Shooting > View log file menu item to quickly examine Komodo’s main log file (“pystderr.log”).

1 Like

It’s a really cool information. I’m translate it in Russian :smile:

Папка инсталяции

Стандартная папка, в которую установится Komodo, зависит от платформы. Имя папки зависит от версии Komodo, которую вы хотите установить. (“IDE” или “Edit” плюс номер версии, например “Komodo IDE 8”):

  • Windows:
    C:\Program Files\ActiveState Komodo [IDE|Edit] <version>\
  • Linux:
    /opt/Komodo-[IDE|Edit]-<version>/
  • OS X:
    /Applications/Komodo-[IDE|Edit]-<version>.app

Папка с профилем

Komodo хранит все настройки в папке профиля. Имя и расположение этой папки зависит от системы и версии Komodo:

  • Windows Vista, Windows 7, Windows 8 или новее:
    C:\Пользователи\<username>\AppData\Local\ActiveState\Komodo[IDE|Edit]\<version>
  • Windows XP:
    C:\Documents and Settings\<username>\Local Settings\Application Data\ActiveState\Komodo[IDE|Edit]\<version>
  • Linux:
    /home/<username>/.komodo[ide|edit]/<version>
  • Mac OS X:
    /Users/<username>/Library/Application Support/Komodo[IDE|Edit]/<version>

Файловая структура

prefs.xml и prefs.xmlc

Содержит все настройки для Komodo. Если вы хотите сбросить настройки, то самым простым методом будет удаление этих двух файлов. Komodo пересоздаст их со стандартными значениями при следующем запуске.

doc-state.xmlc

Этот файл хранит индивидуальные настройки файла, установленные через меню Edit - Current File Preferences.... Содержит текущее местонахождение файла, настройки отступа, кодировку, закладки, дерево кода и настройки EOL.

view-state.xmlc

Этот файл содержит статистику просмотров, как например MRU (most recently used/часто используемые файлы), часто открываемые файлы, порядок вкладок и т.д.

toolbox.sqlite

Содержит информацию о Toolbox. Вы можете копировать этот файл между профилями или на другой ПК.

pystderr.log

Содержит лог ошибок Komodo. Если вы наткнулись на проблему, не забудьте добавить его содержимое в описание проблемы.

Этот файл очищается и создается заново при каждом запуске Komodo.

tools/

Содержит JSON файлы для каждого инструмента в Toolbox.

apicatalogs/

Все API каталоги (файлы codeintel cix), добавляемые с помощью настроек Code Intelligence, копируются сюда.

project-templates/

Содержит все шаблоны, доступные через меню Project - New From Template.

templates/

Содержит все шаблоны файлов/языков, доступные через меню File - New - File from Template...

samples/

Папка, где Komodo хранит образцы файлов и проектов.

schemes/

Папка, где Komodo хранит пользовательские схемы горячих клавиш и темы.

autosave/

Komodo Auto-Save будет сохранять информацию о не сохраненных файлах в эту папку.
Если Вы откроете файл, который имеет схожий файл в этой папке, Komodo предложит восстановить файл из этой папки как актуальный.

codeintel/

Информация Code intelligence. Когда Komodo сканирует любые файлы с кодом (PHP, JS, Python, и т.д.) или API каталоги, он сохраняет обработанную информацию (информация содержит описание функций и переменных, calltip’ы и т.д.) в файл в эту папку.

Если Code Intelligence не работает, то это можно решить с помощью удаления этой папки и перезапуска Komodo, что вызовет сканирование файлов снова.

XRE/

Информация, относящаяся к базе Mozilla, которую использует Komodo (расширения, настройки окон и т.д.)

Перезапись расположения папки профиля

Расположение папки профиля может быть временно переопределено с помощью переменной KOMODO_USERDATADIR. Это полезно в случае, если вы хотите:

  • Запускать несколько редакторов
  • Запускать Komodo с USB-диска
  • Проверить, останется ли у Вас проблема на чистом профиле

Чтобы установить эту переменную, откройте свой терминал и напишите:

  • Windows: set KOMODO_USERDATADIR=%TEMP%\komodo
  • Mac/Linux: export KOMODO_USERDATADIR=/tmp/komodo

Потом запустите через терминал Komodo:

  • Windows: START <installation-folder>\ko.exe
  • Mac: open /Applications/Komodo-[IDE|Edit]-<version>.app
  • Linux: /opt/Komodo-[IDE|Edit]-<version>/komodo

Удаление папки профиля

Если Вы хотите полностью сбросить настройки Komodo, Вы должны закрыть Komodo и удалить свою папку с профилем. Komodo создает ее заново при следующем запуске. Мы рекомендуем Вам сделать копию профиля прежде, чем Вы его удалите.

Файлы логов

В папке профиля есть 2 файла с логами: “pystderr.log” и “pystdout.log”. Эти файлы очень полезны для решения проблем, связанных с Komodo. Они необходимы, когда Вы пишете баг-репорт.

Подсказка: Вы можете использовать Help > Trouble Shooting > View log file для быстрого открытия главного лог-файла Komodo (“pystderr.log”).

1 Like

Thanks @Defman21, added a link in the main post.

@nathanr, can you pin this topic to top of Tutorial category?

Atm it’s still a little bit bugged since the links dont work, waiting for a bugfix for that, once thats fixed I’ll pin it. Though I might move this to the official documentation pages once they are ready.

I’ve updated the first post because some of the info was outdated (to Komodo 9). Now it’s up to date. Also I’ve updated my translation because of the same reason.