Настроить приложение
Ключевые понятия
Настроить приложение — изменить параметры и внешний вид приложения в соответствии с предпочтениями пользователя.
Доступ к настройкам
После установки приложения Obsidian пользователю доступны два способа изменения настроек:
- посредством графического интерфейса приложения;
- непосредственно в файловой системе.
Графический интерфейс
Изменить настройки приложения Obsidian возможно с помощью графического интерфейса.
Вызвать окно настроек
Прежде чем изменять параметры настроек следует вызывать окно настроек приложения Obsidian возможно одним из следующих способов:
- Вызвать в меню приложение Obsidian.
- Нажать сочетание клавиш
<Ctrl + ,>. или - Нажать кнопку «шестерёнка» в нижней строке левой боковой панели.
Вызов приведёт к открытию окна, в котором отображены все доступные настройки приложения.

Настройки Obsidian
Настроить графический интерфейс
С помощью графического интерфейса пользователь может:
- Управлять версией приложения:
- Проверить обновление. В случае необходимости установить автоматическое обновление.
- Управлять учётной записью:
- Зарегистрировать новую учётную запись. Регистрация необходима только для коммерческих сервисов Obsidian Sync и Obsidian Publish. (Settings (Настройки) → General (Общие) → Account (Учётная запись) → Sign up (Зарегистрировать)).
- Авторизовать существующую учётную запись. Только при использовании сервисов Obsidian Sync и Obsidian Publishing. (Settings (Настройки) → General (Общие) → Account (Учётная запись) → Log in (Войти)).
- Приобрести коммерческую лицензию. (Settings (Настройки) → General (Общие) → Account (Учётная запись) → Purchase (Приобрести)).
- Активировать коммерческую лицензию. (Settings (Настройки) → General (Общие) → Account (Учётная запись) → Activate (Активировать)).
- Интегрировать Obsidian с другими приложениями:
- Хранить пароли и ключи API. (Settings (Настройки) → Keychain (Брелок ключей).
- Включить интеграцию приложения с операционной системой. (Settings (Настройки) → Interface (Интерфейс) → Advanced (Дополнительно) → Native menus (Системное контекстное меню).
- Разрешить применение URI для интеграции с другими приложениями. (Settings (Настройки) → Files links (Файлы и ссылки) → Advanced (Дополнительно) → Allow URI callback (Разрешить обратные вызовы URI).
- Включить терминал для управления из командной строки (CLI). (Settings (Настройки) → General (Общие) → Advanced (Дополнительно) → Command line interface (Интерфейс командной строки).
- Включить аппаратное ускорение для повышения производительности приложения. (Settings (Настройки) → General (Общие) → Advanced (Дополнительно) → Hardware acceleration (Аппаратное ускорение).
- Открыть в браузере вебсайт со справочником пользователя. Официальная документация пользователя. (Settings (Настройки) → General (Общие) → Help (Получить помощь).
- Содействовать команде проекта:
- Тестировать ранние сборки приложения. (Settings (Настройки) → General (Общие) → Receive early access versions (Получать ранние сборки).
- Диагностировать сбои. (Settings (Настройки) → General (Общие) → Notify if startup takes longer than expected (Уведомлять о сбое).
Каталоги и файлы настроек
В редких ситуациях практики пользователю надо что-либо изменять в файлах. Однако грамотному пользователю полезно знать расположение и назначение каталогов и файлов настроек.
В операционных системах GNU/Linux приложение Obsidian размещает глобальные настройки в системном каталоге $XDG_CONFIG_HOME/obsidian/ или ~/.config/obsidian/.
Поскольку приложение Obsidian построено на основе программного каркаса Electron, структура этого каталога идентична профилю браузера Google Chrome. Все данные в системном каталоге привязаны к приложению, а не к хранилищу пользователя.
В глобальных настройках ~/.config/obsidian/ расположены следующие файлы и каталоги:
- Preferences — файл в формате JSON. Хранит системные настройки: масштабирование интерфейса, языковые пакеты, настройки проверки орфографии и информацию о последней версии приложения.
- TransportSecurity — технический файл, необходимых для безопасности сетевых соединений (HTTPS). Хранит данные о сайтах, которые требуют строго защищенного протокола (HSTS).
- SingletonSocket — временный файл-замок. При запуске приложение создаёт его для того, чтобы блокировать открытие двух и более копий приложения одновременно. Поскольку это может повредить данные хранилища пользователя. При закрытии приложение автоматически удаляет замок.
- Cache — хранит кэшированные веб-ресурсы и элементы интерфейса. Например, сохраняет пиктограммы, шрифты, скрипты и медиафайлы, которые плагины подгружают из Веба. Сохраняет временные файлы, необходимые для отрисовки графической оболочки приложения. Если произойдёт рассинхронизация между файлами хранилища, восстановить её можно в графическом интерфейсе настроек (Настройки → Файлы и ссылки → Расширенные настройки → Восстановить кэш хранилища).
- Code Cache — хранит скомпилированный JavaScript-код (V8 bytecode) приложения Obsidian и всех установленных сторонних плагинов. Предназначен для быстрого запуска скриптов. Компилятор V8 при первом запуске Obsidian берёт исходный код программы и плагинов на языке JavaScript и компилирует его в машиночитаемый байт-код. Этот подход значительно ускоряет запуск приложения и «тяжёлых» плагинов. В случае сбоя каталог
Code Cacheможно безопасно удалить после закрытия приложения. При следующем запуске Obsidian заново перекомпилирует все необходимые скрипты. - Crashpad — собирает данные для отправки отчёта о критических сбоях приложения. Каталог можно полностью безопасно удалять при закрытом приложении.
- DawnGraphiteCache и DawnWebGPUCache — кэшируют графические шейдеры рендерера Graphite и API WebGPU внутри Chromium/Electron. Работает в тесной связке с привычным
GPUCache. Dawn — кроссплатформенная реализация стандарта WebGPU Google, современный преемник WebGL. Предоставляет приложению прямой и низкоуровневый доступ к возможностям видеокарты. Graphite — оптимизированный рендеринг двумерной графики, компонент библиотеки Skia. Работает поверх графических API, таких как Vulkan в Linux. Если возник сбой видео драйвера, ядра Linux или графической библиотеки Mesa (чёрный экран, зависание), кэш может стать несовместимым. В этом случае при закрытом приложении рекомендую очистить каталогиGPUCache,DawnGraphiteCacheиDawnWebGPUCache. - Dictionaries — хранит словари орфографии. Для проверки русской орфографии рекомендую разместить здесь актуальные (свежие) версии словаря.
- GPUCache — кэш шейдеров видеокарты. Chromium компилирует графические шейдеры в соответствии с архитектурой видеокарты пользователя. Использует для отрисовки интерфейса, анимации, сложными структурами холста, плавного скроллинга. Если интерфейс приложения дал сбой (чёрный, мерцает, искажает шрифты, вылетает при открытии тяжёлых графических плагинов), удалите содержимое этого каталога. Возможно повторное компилирование поможет исправить ошибки отображения.
- IndexedDB — низкоуровневая база данных браузерного типа. Хранит структурированные данные приложения и плагинов, поддерживает состояние подключений Obsidian Sync и Obsidian Publish.
- Local Storage — хранит настройки приложения (sic! и не хранит настройки хранилища пользователя). В файлах формата базы данных SQLite записаны метаданных хранилищ пользователя. Данный список приложение использует в окнах выбора, истории, размеров, идентификации хранилищ пользователя. Если удалить данный каталог, это сбросит Obsidian до состояния первого запуска. Возникнет необходимость занового указывать пути к хранилищам пользователя. Сами хранилища при удалении
Local Storageне пострадают. - Obsidian Sandbox — файлы «песочницы». Учебное хранилище предназначено для освоения пользователем навыков работы с приложением и для экспериментов. Умышленно отделено от хранилища заметок пользователя.
- Session Storage — хранит временные данные веб-сессий. Предназначен для корректной работы интерфейса и некоторых плагинов. Выполняет ту же роль, что и
sessionStorageв обычном браузере. Данный каталог изолирован от основного хранилища. В случае (крайней) необходимости его можно безболезненно удалить после закрытия приложения Obsidian. Например, если интерфейс Obsidian стал «зависать», некорректно отображать встроенные фреймы (iframe), если плагины не могут завершить авторизацию, то очистка каталога Session Storage поможет пересоздать все нужные файлы заново. - Shared Dictionary — хранит общие словари (Shared Dictionary) сжатия сетевого трафика (Compression Dictionary Transport).
- WebStorage — хранит данные веб-приложений и плагинов в стандарте HTML5 Web Storage API. Единый хаб хранения баз данных сайтов и тяжёлых веб-плагинов. Недостаток Obsidian в том, что этот каталог приложение плохо очищает самостоятельно. Со временем этот каталог может раздуться до нескольких гигабайт. При закрытом приложении содержимое этого каталога можно безопасно очистить. Никакие настройки и данные пользователя при этом не пострадают.
- Blob storage — технический кэш мультимедиа. Временно хранит крупные бинарные объекты перед их выводом на экран. Например, большие изображения, видео или аудиофайлы.