VK puppeting bridge for Matrix, taking use of VK Communities API
Go to file
Inex Code 701e4c90fc Update matrix chat shield 2020-11-21 20:17:00 +00:00
.devcontainer Initial commit 2020-11-02 14:48:22 +00:00
.github/workflows Create codeql-analysis.yml 2020-11-02 18:57:49 +03:00
src Linting, version bump 2020-11-20 15:43:32 +00:00
.gitignore Initial commit 2020-11-02 14:48:22 +00:00
LICENSE Initial commit 2020-11-02 14:48:22 +00:00
README.md Update matrix chat shield 2020-11-21 20:17:00 +00:00
package-lock.json Forwards formatting 2020-11-20 08:45:31 +00:00
package.json Linting, version bump 2020-11-20 15:43:32 +00:00
sample.config.yaml Update readme and default log level 2020-11-13 02:57:21 +00:00
tsconfig.json Initial commit 2020-11-02 14:48:22 +00:00
tslint.json Linting 2020-11-13 03:14:53 +00:00

README.md

Matrix

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
  • 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
  • Edge cases to work around
    • Access token revoked on VK side
    • Bot is kicked out on VK side
    • Probably more, send an issue!

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