Clash of Clans war moniting for telegram channels.
Project description
Clash of Clans war moniting for telegram channels.
NOTE: Clash of Clans API data is always 10 minutes behind the game events. This is not a bug in this program.
clashogram monitors your clan’s warlog and posts the following messages to a Telegram channel:
Preparation started (with clans and players information)
War started
New attacks (with details)
War over
Requirements
To run the program you need to have python 3.3 or higher. You will also need pip to install python dependencies. Moreover, using a virtualenv makes installation much easier, otherwise you have to install everything system-wide. On Linux you would need to run commands with sudo, on windows with administrator account.
Installation
>From pypi:
pip install clashogram
>From Github:
git clone https://github.com/mehdisadeghi/clashogram.git cd clashogram install -r requirements.txt python setup.py install
Usage
In order to use the program do the following:
Open a Clash of Clans developer account at https://developer.clashofclans.com/.
Find your external IP address using a website like this.
Go to your CoC developer page and create an API token for the IP number you just found.
Create a Telegram bot using BotFather and copy its token.
Create a new Telegram group and add the bot you just created as an administrator to that group.
Now you can run the following command:
pip install clashogram clashogram.py --coc-token <COC_API_TOKEN> --clan-tag <CLAN_TAG> --bot-token <TELEGRAM_BOT_TOKEN> --channel-name <TELEGRAM_CHANNEL_NAME>
In order to have messages in a different locale do the following and then run the program:
export LANGUAGE=<LANGUAGE_CODE> e.g. export LANGUAGE=fa
Or do it in one step:
LANGUAGE=fa clashogram.py --coc-token <COC_API_TOKEN> --clan-tag <CLAN_TAG> --bot-token <TELEGRAM_BOT_TOKEN> --channel-name <TELEGRAM_CHANNEL_NAME>
Run as a service
The simplest way to use Clashogram is leave it running in background using either byobu or GNU Screen. Another solution is to install a systemd unit:
[Unit] Description=Clashogram Daemon After=network.target [Service] WorkingDirectory=/path/to/clashogram/ EnvironmentFile=/path/to/env/file ExecStart=/path/to/python /path/to/clashogram.py Restart=on-failure User=someuser [Install] WantedBy=multi-user.target
Search internet for more information on installing systemd units on your OS.
Contribution (PRs welcome!)
The Telegram notification is isolated from the rest of the program. You can replace it w
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for Clashogram-0.1.12-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e2f3e53542562c203065b96669dd24f5a763149d3f7dbff1c16b537572815f60 |
|
MD5 | 3d89e6797f5c8e8c9e771b22586696d7 |
|
BLAKE2b-256 | 20fea256a79ce36a3483f79f0484dc3d37ffc196bd7369aeb346105537933322 |