MAX Sync

Sync messages from MAX messenger into your Obsidian vault.

The plugin fetches new messages from a companion sync server, appends them to a target note (with an optional template), and downloads media attachments into your vault.

Desktop only (Obsidian 1.5.0+).

Requirements

• Obsidian desktop
• A running MAX Sync backend and bot that issues your personal user token
• A user token from the bot (/token)

Installation

From Community Plugins (after publication)

1. Open Settings → Community plugins
2. Turn off Safe mode
3. Browse and install MAX Sync
4. Enable the plugin

Manual install

1. Download main.js and manifest.json from the latest GitHub Release of this repository
2. Create the folder <vault>/.obsidian/plugins/max-sync/
3. Copy the files into that folder
4. Enable MAX Sync under Community plugins

Setup

1. In MAX, send /token to the bot and copy the token
2. Open Settings → MAX Sync
3. Paste the token into Max user token
4. Click Check to verify the server and token
5. Optionally set:
   • Template file (default: MAX/template.md)
   • Target file (default: MAX/Inbox.md)
   • Attachments folder (default: Attachments)

Usage

Run the command Fetch new messages (Command palette).

New messages are appended to the target file. Attachments are saved under the attachments folder.

Template variables

If you use a template file, these placeholders are supported:

Variable	Description
{{date}}	Message date
{{time}}	Message time
{{created}}	Creation timestamp
{{sender}}	Sender display name
{{sender_id}}	Sender ID
{{message_id}}	Message ID
{{type}}	Message type
{{text}}	Message text
{{attachment}}	Attachment link/line
{{transcription}}	Transcribed audio text (if any)
{{tags}}	Tags

Development

npm install
npm run dev    # watch build
npm run build  # production build → main.js

License

MIT — see LICENSE.