Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bizordec/vk-to-tgm
An application that forwards wall posts and playlists from VK community to Telegram channel.
https://github.com/bizordec/vk-to-tgm
bot celery python telegram telegram-bot telegram-channel telethon vk vk-api vk-callback-api vkbottle vkontakte
Last synced: 2 months ago
JSON representation
An application that forwards wall posts and playlists from VK community to Telegram channel.
- Host: GitHub
- URL: https://github.com/bizordec/vk-to-tgm
- Owner: Bizordec
- License: gpl-3.0
- Created: 2022-04-27T14:09:44.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-06T17:06:39.000Z (3 months ago)
- Last Synced: 2024-10-09T18:20:57.723Z (2 months ago)
- Topics: bot, celery, python, telegram, telegram-bot, telegram-channel, telethon, vk, vk-api, vk-callback-api, vkbottle, vkontakte
- Language: Python
- Homepage:
- Size: 1.31 MB
- Stars: 43
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# vk-to-tgm
An application that forwards wall posts and playlists from VK community to Telegram channel.
Consists of following services:
- Server that receives VK Callback events
- Telegram bot that forwards wall posts or playlists by user request
- Celery worker that forwards wall posts
- (optional) Celery worker that forwards playlists
- Celery Beat service, that cleans up a SQLite3 database task results
## Requirements:
- Python 3.8+
- RabbitMQ Server
- FFmpeg
- [VK community token with access to community management](https://vk.com/dev/access_token)
- VK account
- Telegram channel (and additional channel if you need playlists)
- Telegram account
- [Telegram bot token](https://core.telegram.org/bots#3-how-do-i-create-a-bot)
- [Telegram application](https://core.telegram.org/api/obtaining_api_id)
## What can it forward
| VK | Telegram | Notes |
|-------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Text | ✅ | Will be splitted into multpile messages if VK text is too big. |
| Photo | ✅ | Will be posted with the largest size available. |
| Video | ✅ | VK videos will be uploaded directly (up to 720p). External videos (YouTube, Vimeo, etc.) will be at the top in the form of links, so that the first one will be shown in the preview. |
| Audio | ✅ | Will be posted in separate message. |
| File | ✅ | Will be posted in separate message. |
| Poll | ✅ | Will be posted in separate message. |
| Market | ✅ | Will be in the form of link. |
| Playlist | ✅ | Additional Telegram channel is required. There will be separate message in the main channel with the link to the message in the playlist channel, where audios will be uploaded. |
| Link | ✅ | Will be shown just as VK link. |
| Article | ✅ | Will be in the form of link. |
| Poster | ✅ | Works the same way as with the photo. |
| Graffiti | ✅ | Works the same way as with the photo. |
| Map | ✅ | Will be posted in separate message. |
| Live stream | ✅ | Will be posted at the top in the form of link. |
**NOTE:** if post was edited in VK, it will NOT be edited in Telegram. As a workaround, you can delete old Telegram messages and reforward edited post through Telegram bot.
## Example
Working example: https://t.me/mashup_vk
## Installation
Run `install.sh` script.
### Docker installation
1. Set environment variables manually in `.env` file or by running
```sh
./vtt-cli.sh set_env
```
2. Install Nginx and run command
```sh
./vtt-cli.sh setup_nginx
```
3. Sign in VK and Telegram
```sh
docker compose run --rm -it sign_in
```
4. Start the app
```sh
docker compose up
# Or, if you also want to handle playlists
docker compose --profile with_pl up
```
If you want to install client SSL certificate, read [here](setup/ssl/README.md).
## Uninstallation
Run `uninstall.sh` script.
### Docker uninstallation
```sh
docker compose down -v --rmi all --remove-orphans
```
## Logs
You can check logs in the `logs/` directory.
## License
GNU General Public License v3.0 or later.
See [LICENSE](LICENSE) file.