mx-puppet-vk

This is a Matrix <-> VK bridge based on mx-puppet-bridge and VK-IO.

It is in early development. Right now it logs message data when log level includes "info" level.

Relay mode works too, but we don't recommend it.

Installation

git pull https://github.com/innereq/mx-puppet-vk
npm install
npm run build

Next copy the sample.config.yaml to config.yaml, edit it and then run npm run start -- -r to generate a registration file. Register that one with synapse and start the bridge with npm run start.

Features and roadmap

• Matrix -> VK
  • Text content
  • Image content
  • Audio/Video content
  • Other files
  • Replies
  • Typing notifs - see note
  • Presence - not possible yet
  • Read notifications - not possible yet
  • Message edits
  • Message redacts - works as edit, real redact unavailable without being admin in chat
  • Initiate rooms from the matrix side
• VK -> Matrix
  • Text content
  • Forwards
  • Image content
  • Audio content
  • Video content
  • Stickers
  • Other files
  • Presence - not effective to track
  • Typing notifs
  • User profiles
  • Read notifications - not effective to track
  • Message edits
  • Message redacts - doesn't work
  • Autopopulate rooms with users
• Edge cases to work around
  • Access token revoked on VK side
  • Bot is kicked out on VK side
  • Probably more, send an issue!
• Support for user tokens
  • Auth as a user instead of group

Usage

Video demonstration by Coma Grayce

1. Get VK community token (Just open the "Manage community" tab, go to "API usage" tab and click "Create token")
2. Activate Bots Long Poll API ("Manage community" → "API usage" → "Bots Long Poll API") and choose the latest API version. Make sure that under event types all message-realted events are turned on.
3. Activate an option to message your community. To allow group chats, activate it under bot capabilities.
4. On matrix, contact @_vk_puppet_bot:your.domain and type link <vk token>
5. Now, if someone contacts your community, you will be invited to the corresponding room on Matrix.

Plese note: when community is invited to the group chat as a bot, make sure it has message access. Only chat admins can change bot permissions.

Bridge doesn't handle being kicked from chat yet.

Relay usage

See mx-puppet-bridge docs

Note on presence from matrix side

For presence bridging from Matrix side (including typing) your Synapse server has to be on 1.22.0 or later.

Also, make sure your registration file contains this:

de.sorunome.msc2409.push_ephemeral: true