Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/revolter/FileConvertBot
Telegram Bot that converts some file types to native photo, audio or video Telegram messages.
https://github.com/revolter/FileConvertBot
bot python python3 telegram telegram-bot
Last synced: 4 months ago
JSON representation
Telegram Bot that converts some file types to native photo, audio or video Telegram messages.
- Host: GitHub
- URL: https://github.com/revolter/FileConvertBot
- Owner: revolter
- License: gpl-3.0
- Created: 2018-10-16T06:44:45.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-02-08T00:52:09.000Z (over 1 year ago)
- Last Synced: 2024-01-15T18:30:35.858Z (5 months ago)
- Topics: bot, python, python3, telegram, telegram-bot
- Language: Python
- Homepage: https://t.me/FileConvertBot
- Size: 383 KB
- Stars: 45
- Watchers: 2
- Forks: 31
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-stars - revolter/FileConvertBot - Telegram Bot that converts some file types to native photo, audio or video Telegram messages. (Python)
README
# 
File Convert Bot
## Introduction
Telegram Bot that converts _(for now)_ AAC, OPUS, MP3 and WebM files to voice
messages, HEVC and MP4 (MPEG4, VP6 and VP8) files to video messages or video
notes (rounded ones), video messages to video notes (rounded ones), videos from
some websites to video messages, PDF files to photo messages _(currently only
the first page)_, image files to stickers. It also converts voice messages to
MP3 files and stickers to photo messages. It works in groups too!
The bot currently runs as [@FileConvertBot](https://t.me/FileConvertBot).
**All the processing is done in-memory, so no file is ever saved on the disk,
not even temporary!**
## Getting Started
These instructions will get you a copy of the project up and running on your
local machine for development and testing purposes.
### Prerequisites
You need to install [Homebrew](https://brew.sh) by running:
```sh
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
### Installing
Install the global dependencies by running:
```sh
sudo apt install ffmpeg poppler-utils
```
on Linux or
```sh
brew install ffmpeg poppler
```
on macOS.
Then clone the project and install the dependencies by running:
```sh
cd /desired/location/path
git clone https://github.com/revolter/FileConvertBot.git
cd FileConvertBot
curl https://pyenv.run | bash
export PATH="$HOME/.pyenv/bin:$PATH"
sudo apt update
sudo apt install make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
pyenv install 3.9.0
pyenv global 3.9.0
curl -sSL https://install.python-poetry.org | python -
poetry shell
poetry install
cd src
cp config_sample.cfg config.cfg
```
Then, edit the file named `config.cfg` inside the `src` folder with the correct
values and run it using `./main.py --debug`.
Use `exit` to close the virtual environment.
## Deploy
You can easily deploy this to a cloud machine using
[Fabric](http://fabfile.org):
```
cd /project/location/path
poetry shell
cp fabfile_sample.cfg fabfile.cfg
```
Then, edit the file named `fabfile.cfg` inside the root folder with the correct
values and run Fabric using:
```
fab setup
fab deploy
```
You can also deploy a single file using `fab deploy --filename=main.py` or `fab
deploy --filename=pyproject.toml`.
## Dependencies
Currently, you have to manually install `poppler` in order for `PDF` to `PNG`
conversion to work:
- macOS: `brew install poppler`
- Ubuntu: `sudo apt-get install poppler-utils`