Add initial project documentation

Signed-off-by: lzzy12 <jhashivam2020@gmail.com>
This commit is contained in:
lzzy12 2019-10-11 19:19:32 +05:30
parent fad3913e26
commit 2e378a9f0b
2 changed files with 73 additions and 3 deletions

View File

@ -1,2 +1,72 @@
This is a telegram bot writen in python for mirroring files on the internet to our beloved Google Drive.\n
Documentation is coming as soon as we finish implementing all the basic features of the bot
# What is this repo about?
This is a telegram bot writen in python for mirroring files on the internet to our beloved Google Drive.
## Inspiration
This project is heavily inspired from @out396 's telegram bot which is written in JS.
## Features supported:
- Mirroring direct download links to google drive
- Download progress
- Upload progress
- Download/upload speeds and ETAs
## Upcoming features (TODOs):
- Mega link mirror support
- Docker support
- More code clean up
# How to deploy?
Deploying is pretty much straight forward and is divided into several steps as follows:
## Installing requirements
- Clone this repo:
```
git clone https://github.com/lzzy12/python-aria-mirror-bot mirror-bot/
```
- Installing requirements
```
cd mirror-bot
pip3 install -r requirements.txt
```
- Install aria2
For Debian based distros
```
sudo apt install aria2c
```
For Arch and it's derivatives:
```
sudo pacman -S aria2
```
## Setting up config file
```
cp bot/config_sample.ini bot/config.ini
```
- Remove the first line saying:
```
_____REMOVE_THIS_LINE_____=True
```
Fill up rest of the fields. Meaning of each fields are discussed below:
- BOT_TOKEN : The telegram bot token that you get from @BotFather
- GDRIVE_FOLDER_ID : This is the folder ID of the Google Drive Folder to which you want to upload all the mirrors.
- DOWNLOAD_DIR : The path to the local folder where the downloads should be downloaded to
- DOWNLOAD_STATUS_UPDATE_INTERVAL : A short interval of time in seconds after which the Mirror progress message is updated. (I recommend to keep it 5 seconds at least)
- OWNER_ID : The Telegram user ID (not username) of the owner of the bot
## Getting Google OAuth API credential file
- Visit the Google Cloud Console
- Go to the OAuth Consent tab, fill it, and save.
- Go to the Credentials tab and click Create Credentials -> OAuth Client ID
- Choose Other and Create.
- Use the download button to download your credentials.
- Move that file to the root of mirror-bot, and rename it to credentials.json
## Deploy
- Start aria client by `./aria.sh` on linux or running `aria.bat` on Windows (Any issue on Windows is not supported and will be closed immediately)
- Start the bot by
```
python3 -m bot
```

View File

@ -5,6 +5,6 @@ _____REMOVE_THIS_LINE_____=True
# ENTER BOT TOKEN( Get it from https://my.telegram.org)
BOT_TOKEN =
GDRIVE_FOLDER_ID =
DOWNLOAD_DIR = ./download
DOWNLOAD_DIR = /home/username/mirror-bot/downloads
DOWNLOAD_STATUS_UPDATE_INTERVAL = 5
OWNER_ID =