VK Inbox

VK Inbox imports private messages sent to a VK community into a note selected by the user.

The plugin does not require a personal server. VK stores incoming messages until the plugin checks for them manually or on a configured interval.

Features

• Groups messages by day: the first entry shows its date and time, while later entries from the same day are separated by horizontal rules.
• Prevents duplicate entries.
• Downloads voice messages into a selected attachment folder.
• Embeds voice messages for playback directly inside a note.
• Provides free local transcription through whisper.cpp on desktop.
• Offers searchable note and attachment-folder selectors.
• Supports manual and automatic synchronization.
• Supports text and audio imports on mobile devices.

Limitations

• Automatic synchronization runs only while the app is open.
• Local Whisper transcription is available only on desktop.
• Voice messages imported on iPhone are marked for delayed transcription. Transcription runs during the next desktop synchronization.
• The first synchronization establishes a starting point and skips older message history.
• A ChatGPT subscription and an OpenAI API key are not used or required.

Basic setup

1. Create a dedicated VK community and enable community messages.
2. In Management → API usage → Access tokens, create a token with access only to community messages.
3. Send a test message to the community from your VK account.
4. Open the VK Inbox settings, paste the token, and select Check.
5. Select the destination note and the attachment folder.
6. Select Update messages or configure an automatic synchronization interval.

The plugin automatically detects the community ID and the author ID of the latest incoming message. Never publish your VK access token.

Local Whisper transcription

On Windows, download VK-Inbox-Whisper-Installer-Windows.zip from the GitHub release, extract it, and run install-whisper.cmd. The installer downloads the official whisper.cpp executable and the multilingual small model, verifies their checksums, and installs them for the current user without administrator permissions.

Audio is processed locally and is not sent to an external transcription service. On macOS and Linux, whisper.cpp and a model must currently be installed manually.

Mobile and WebDAV

The plugin can be used with Remotely Save or another vault synchronization method. Synchronize the vault before importing messages and again afterwards. Notes and audio attachments are ordinary vault files.

Do not synchronize the plugin's data.json between devices. It contains the VK access token and desktop-specific Whisper paths.

Privacy and security

• The plugin connects to the VK API only to read the configured conversation and download its voice attachments.
• The VK token is stored locally in the plugin's data.json.
• The token is not included in the source code or release files.
• The plugin contains no analytics or telemetry.
• Searchable selectors enumerate note and folder paths inside the vault so the user can choose the destination. Vault contents are not uploaded for this purpose.

---

Русский

VK Inbox переносит личные сообщения, отправленные сообществу ВКонтакте, в выбранную заметку Obsidian.

Плагин не требует собственного сервера. ВКонтакте хранит сообщения, пока Obsidian не выполнит ручное или автоматическое обновление.

Возможности

• импорт новых текстовых сообщений;
• группировка сообщений по дням: дата и время указываются у первой записи дня, а следующие записи разделяются горизонтальной чертой;
• защита от повторного импорта;
• загрузка голосовых сообщений в хранилище;
• встроенный проигрыватель аудио в заметке;
• бесплатная локальная расшифровка через whisper.cpp на компьютере;
• поисковый выбор целевой заметки и папки вложений;
• ручное и автоматическое обновление;
• работа с Obsidian Mobile для импорта текста и аудио.

Ограничения

• автоматическое обновление работает только пока Obsidian открыт;
• локальный Whisper работает только в настольном Obsidian;
• на iPhone голосовое сообщение сохраняется с отложенной расшифровкой, которая выполняется при следующем обновлении на компьютере;
• первое обновление устанавливает начальную границу и пропускает старую историю сообщений;
• подписка ChatGPT не используется и не требуется.

Установка вручную

Скопируйте файлы релиза в папку:

<Ваше хранилище>/.obsidian/plugins/vk-inbox/

Необходимые файлы:

main.js
manifest.json

После копирования откройте Настройки → Сторонние плагины, обновите список и включите VK Inbox.

Подготовка ВКонтакте

1. Создайте отдельное сообщество.
2. Включите сообщения сообщества.
3. Откройте Управление → Работа с API → Ключи доступа.
4. Создайте ключ только с разрешением на работу с сообщениями.
5. Напишите со своей страницы тестовое сообщение сообществу.
6. Вставьте ключ в настройки VK Inbox и нажмите Проверить.

Плагин автоматически определит ID сообщества и ID автора последнего входящего сообщения.

Никогда не публикуйте ключ ВКонтакте в GitHub.

Формат записи

Первая запись дня:

### 21.07.2026, 14:35

Текст сообщения.

Следующая запись этого же дня:

---

Следующее сообщение.

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

Голосовое сообщение использует тот же принцип группировки:

### 21.07.2026, 14:41

![[Входящие/Вложения/vk-123-456.mp3]]

**Расшифровка:** Текст голосового сообщения.

Локальная транскрипция

Автоматическая установка на Windows

1. Скачайте из GitHub Release архив VK-Inbox-Whisper-Installer-Windows.zip.
2. Распакуйте архив.
3. Дважды щёлкните install-whisper.cmd.
4. Дождитесь сообщения Installation completed successfully.

Установщик не требует прав администратора, загружает официальный whisper.cpp и многоязычную модель small, проверяет их контрольные суммы и сохраняет в профиль текущего пользователя:

%LOCALAPPDATA%\VK Inbox\Whisper\Release\whisper-cli.exe
%LOCALAPPDATA%\VK Inbox\Whisper\models\ggml-small.bin

Эти пути уже заданы в плагине по умолчанию. После установки включите локальную расшифровку и нажмите Проверить.

На macOS и Linux whisper.cpp и модель пока нужно устанавливать вручную, после чего указать абсолютные пути в настройках.

Аудио обрабатывается локально и не отправляется во внешние сервисы.

iPhone и WebDAV

Плагин можно использовать вместе с Remotely Save:

1. Выполните синхронизацию WebDAV перед импортом сообщений.
2. Запустите обновление VK Inbox.
3. Повторно выполните синхронизацию WebDAV.

Заметка и MP3 синхронизируются как обычные файлы хранилища. Папку .obsidian и файл настроек плагина синхронизировать не рекомендуется: они содержат ключ доступа и локальные пути Whisper.

Безопасность

• ключ ВКонтакте хранится локально в data.json плагина;
• ключ не включается в исходный код и файлы релиза;
• выдавайте ключу только доступ к сообщениям сообщества;
• используйте отдельное сообщество для личного входящего ящика;
• исходный код не содержит аналитики и телеметрии.

Разработка

npm.cmd install
npm.cmd run build
npm.cmd run lint

Готовый файл плагина создаётся как main.js в корне проекта.