Yandex Disk Sync for Obsidian

Двусторонняя синхронизация Obsidian-хранилища через REST API Яндекс.Диска. Плагин работает на Windows, Linux, macOS, Android и iOS без Node.js API.

Возможности

• двусторонняя синхронизация заметок и вложений;
• отображение прогресса и текущего файла;
• ограниченная параллельная обработка для ускорения синхронизации;
• быстрый повторный запуск за счёт кеша размера, времени изменения и SHA-256;
• защита от перезаписи файла, изменённого во время синхронизации;
• конфликтные копии при одновременном изменении на разных устройствах;
• удаление пользовательских файлов через корзину;
• блокировка с владельцем и heartbeat для нескольких устройств;
• повторы запросов при 429, сетевых ошибках и ошибках сервера;
• запуск после локальных изменений, при старте, возврате в приложение и по интервалу;
• настраиваемые исключения.

Установка через BRAT

1. Установите плагин BRAT в Obsidian.
2. Выполните команду BRAT: Add a beta plugin for testing.
3. Укажите stash1ho/yandex-disk-sync.
4. Включите Yandex Disk Sync в списке сторонних плагинов.

Также можно скачать main.js, manifest.json и styles.css из последнего релиза и положить их в:

<vault>/.obsidian/plugins/yandex-disk-sync/

Настройка

1. Создайте OAuth-токен Яндекс.Диска с минимально необходимым доступом.
2. Вставьте токен в настройках плагина.
3. Для приложения с доступом только к своей папке оставьте app:/vault.
4. Нажмите Проверить подключение.
5. Оставьте параллельность 4. Для слабого телефона можно выбрать 2, для компьютера — 6.

Токен хранится в локальном data.json. Папка .obsidian всегда исключается из синхронизации.

Конфликты и удаления

Если один файл изменён на двух устройствах, локальная версия остаётся под исходным именем, а облачная сохраняется рядом:

Заметка.remote-conflict-a1b2c3d4-2026-09-16T12-00-00-000Z.md

Пользовательские файлы на Яндекс.Диске удаляются в корзину. Служебная папка блокировки удаляется безвозвратно, чтобы не засорять корзину.

Перед первым использованием рекомендуется сделать резервную копию хранилища.

Разработка

npm install
npm run typecheck
npm run build

Готовые файлы: main.js, manifest.json, styles.css.