An application that forwards wall posts and playlists from VK community to Telegram channel.

🔗 Telegram Channel Example

• Docker
• VK community token with access to community management
• VK account
• Telegram channel (and an additional one if you plan to use playlist forwarding)
• Telegram account
• Telegram bot token
• Telegram application

1. Set environment variables manually in .env file (see .env.example) or by running these commands:

   # Go to the root directory of this repository
   cd "$(git rev-parse --show-toplevel)"
   
   # Build env_helper
   docker build --build-arg UID=$(id -u) --build-arg GID=$(id -g) -t env_helper projects/env_helper
   
   # Run env_helper
   mkdir -p out && docker run --rm -it -v "$(pwd)/out":/tmp/out env_helper
   
   # Copy resulting '.env' file to the root directory
   cp out/.env .env

2. After that, you have two options:

   • Run the application without SSL certificate:

     COMPOSE_PROFILES=http docker compose up -d --build --remove-orphans
     
     # Or, if you also want to handle playlists
     COMPOSE_PROFILES=http,with-pl docker compose up -d --build --remove-orphans

   • Run the application with SSL certificate - read this guide.

docker compose down -v --rmi all --remove-orphans

1. Backup your current .env file.

2. Run uninstall.sh script if vk-to-tgm was installed locally.

3. Copy .env file from the backup and change environment variables:

   1. Rename variables:
      • KATE_TOKEN to VK_TOKEN
      • VK_IGNORE_ADS to VTT_IGNORE_ADS
      • NGINX_HOST to NGINX_SERVER_NAME
   2. Remove deprecated variables:
      • VK_LOGIN
      • VK_PASSWORD
      • VK_OFFICIAL_TOKEN
      • VK_API_LANGUAGE

4. Create out/ directory and copy .env there:

   mkdir -p out && cp .env out/.env

5. Reinstall using Docker

GNU General Public License v3.0 or later.

See LICENSE file.