bml-tg-notify/README.md

# BML-TG-NOTIFY
## Push Notification BML Transcations to Telegram
![bml-notify-screenshot.jpg](bml-notify-screenshot.jpg)

## Is it safe?
- Probably, I will NOT take resposibilty to whatever you do with this script. [See More](LICENSE)
- Your BML Username and Password will be saved in PLAIN TEXT!
Anyone who has access (or gains access) to your server or computer can read .env file and obtain your BML login credentials!

## Limitations
- At the moment this script can only check 1 account from personal profile.
- Script ONLY sends notification for last transaction, so if there more than 1 transacation 
when script checks for new transactions you will get notification for the last one only.
### There's catch!
- BML do NOT allow you to be logged in more than 1 session at a time,
so when this script runs and if you were using mobile app or website you will be logged out!
- You either get fast notification but with less time to use app 
OR take as much as time you want to use app but slow notifications.
Which is why I have added a delay to change how often script logs into account,
This can be delay can be configured later. [See how](#setting-delay---optional)

## Getting started. 
### Requriements
`curl` `jq`
- Install with whatever package manager you use.
- Make SURE they are installed before continuing!
### Clone repo and Configure
```
git clone https://github.com/shihaamabr/bml-tg-notify.git
cd bml-tg-notify
chmod +x bml-tg-notify.sh
cp env.sample .env
```
- Edit the contents of .env to your config (`nano .env`)
- [How to obtain BML_ACCOUNTID](https://raw.githubusercontent.com/shihaamabr/bml-tg-notify/main/how-to-obtain-BML_ACCOUNTID.png)
### Execute the script
```
./bml-tg-notify.sh
```
- Maybe run in a screen to run in background?
## Setting Delay - Optional Configration
In a different terminal seession run `echo XX > delay` where XX is the time in seconds you want to delay script logs into account [See why](#theres-catch)
### Notes
- Default value is 160.
- If the XX value is less than a certain value (I think 15) your IP could get blocked by CloudFlare for DoS attack.
- You do not need to restart script after changing delay.

## Bugs
- [You tell me :)](https://github.com/shihaamabr/bml-tg-notify/issues/new)
more detailed readme 2021-05-13 23:22:04 +05:00			`# BML-TG-NOTIFY`
init commit new repo 2021-05-13 22:40:24 +05:00			`## Push Notification BML Transcations to Telegram`
noice 2021-05-14 00:33:16 +05:00			`![bml-notify-screenshot.jpg](bml-notify-screenshot.jpg)`
init commit new repo 2021-05-13 22:40:24 +05:00
satisfying readme 2 2021-05-14 00:40:16 +05:00			`## Is it safe?`
does this work like this 2021-05-14 16:51:09 +05:00			`- Probably, I will NOT take resposibilty to whatever you do with this script. [See More](LICENSE)`
			`- Your BML Username and Password will be saved in PLAIN TEXT!`
typo 2021-05-14 00:46:40 +05:00			`Anyone who has access (or gains access) to your server or computer can read .env file and obtain your BML login credentials!`
Readme Update 2021-05-13 22:57:53 +05:00
satisfying readme 2 2021-05-14 00:40:16 +05:00			`## Limitations`
			`- At the moment this script can only check 1 account from personal profile.`
readme update 2021-05-14 05:52:26 +05:00			`- Script ONLY sends notification for last transaction, so if there more than 1 transacation`
fix spacing 2021-05-14 14:55:21 +05:00			`when script checks for new transactions you will get notification for the last one only.`
satisfying readme 2 2021-05-14 00:40:16 +05:00			`### There's catch!`
clean readme 2021-05-14 05:36:04 +05:00			`- BML do NOT allow you to be logged in more than 1 session at a time,`
			`so when this script runs and if you were using mobile app or website you will be logged out!`
does this work like this 2021-05-14 16:51:09 +05:00			`- You either get fast notification but with less time to use app`
more detailed readme 2021-05-13 23:22:04 +05:00			`OR take as much as time you want to use app but slow notifications.`
clean readme 2021-05-14 05:36:04 +05:00			`Which is why I have added a delay to change how often script logs into account,`
ok md epic 2021-05-14 16:54:14 +05:00			`This can be delay can be configured later. [See how](#setting-delay---optional)`
Readme Update 2021-05-13 22:57:53 +05:00
clean readme 2021-05-14 05:12:35 +05:00			`## Getting started.`
satisfying readme 2021-05-14 00:37:26 +05:00			`### Requriements`
			`curl` `jq`
			`- Install with whatever package manager you use.`
			`- Make SURE they are installed before continuing!`
update 2021-05-17 00:26:30 +05:00			`### Clone repo and Configure`
init commit new repo 2021-05-13 22:40:24 +05:00			```
			`git clone https://github.com/shihaamabr/bml-tg-notify.git`
			`cd bml-tg-notify`
			`chmod +x bml-tg-notify.sh`
bruh copy env not move 2021-05-13 23:30:32 +05:00			`cp env.sample .env`
init commit new repo 2021-05-13 22:40:24 +05:00			```
clean readme 2021-05-14 05:13:05 +05:00			- Edit the contents of .env to your config (`nano .env`)
clean readme 2021-05-14 05:12:35 +05:00			`- [How to obtain BML_ACCOUNTID](https://raw.githubusercontent.com/shihaamabr/bml-tg-notify/main/how-to-obtain-BML_ACCOUNTID.png)`
typo 2021-05-14 00:46:40 +05:00			`### Execute the script`
init commit new repo 2021-05-13 22:40:24 +05:00			```
			`./bml-tg-notify.sh`
			```
clean readme 2021-05-14 05:12:35 +05:00			`- Maybe run in a screen to run in background?`
update 2021-05-17 00:26:30 +05:00			`## Setting Delay - Optional Configration`
.. 2021-05-15 01:13:44 +05:00			In a different terminal seession run `echo XX > delay` where XX is the time in seconds you want to delay script logs into account [See why](#theres-catch)
readme update 2021-05-14 05:52:26 +05:00			`### Notes`
			`- Default value is 160.`
			`- If the XX value is less than a certain value (I think 15) your IP could get blocked by CloudFlare for DoS attack.`
clean readme 2021-05-14 05:12:35 +05:00			`- You do not need to restart script after changing delay.`
readme update 2021-05-14 05:52:26 +05:00
satisfying readme 2 2021-05-14 00:40:16 +05:00			`## Bugs`
You tell me :) 2021-05-14 04:16:34 +05:00			`- [You tell me :)](https://github.com/shihaamabr/bml-tg-notify/issues/new)`