Skip to content

Latest commit

 

History

History
103 lines (70 loc) · 2.59 KB

README.md

File metadata and controls

103 lines (70 loc) · 2.59 KB
Raw

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.

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 by running:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Installing

Install the global dependencies by running:

sudo apt install ffmpeg poppler-utils

on Linux or

brew install ffmpeg poppler

on macOS.

Then clone the project and install the dependencies by running:

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:

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