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 # What is this repo about?
Documentation is coming as soon as we finish implementing all the basic features of the bot 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) # ENTER BOT TOKEN( Get it from https://my.telegram.org)
BOT_TOKEN = BOT_TOKEN =
GDRIVE_FOLDER_ID = GDRIVE_FOLDER_ID =
DOWNLOAD_DIR = ./download DOWNLOAD_DIR = /home/username/mirror-bot/downloads
DOWNLOAD_STATUS_UPDATE_INTERVAL = 5 DOWNLOAD_STATUS_UPDATE_INTERVAL = 5
OWNER_ID = OWNER_ID =