aoe2-telegram-bot 0.3.0

A Telegram Bot that gives a random quote of Age of Empires 2 original edition

aoe2-telegram-bot

Age Of Empires II Telegram Bot: give a random quote of Age of Empires 2 original edition

Contact the bot on telegram

Installation

Install python package from PyPI

python3 -m pip install aoe2-telegram-bot

Or from source

git clone https://github.com/PercevalSA/aoe2-telegram-bot
cd aoe2-telegram-bot
python3 -m pip install .

Set an environment file with your telegram bot token as TGB_TOKEN

mkdir -p $HOME/.config/aoe2-telegram-bot
echo 'TGB_TOKEN=xxxx' >$HOME/.config/aoe2-telegram-bot/env

running

When started for the first time the bot will download sounds from internet and store them in the package folder. When you start the bot manually you will need to export the token as environment variable or set it in the environment file in $HOME/.config/aoe2-telegram-bot/env

export TGB_TOKEN=xxxx

or create config directory and add token

mkdir -p ~/.config/aoe2-telegram-bot
echo 'TGB_TOKEN=your_token_here' > ~/.config/aoe2-telegram-bot/env

Then just run

aoe2-telegram-bot

Configuration Options

You can configure the bot using environment variables:

• TGB_TOKEN - Your Telegram bot token (required)
• LOG_LEVEL - Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL (default: INFO)

Example with custom log level:

export TGB_TOKEN=your_token_here
export LOG_LEVEL=DEBUG
aoe2-telegram-bot

Running as a Service

If you need the bot to run as a service you can use the provided systemd service file generated by the bootstrap command

aoe2-telegram-bot-bootstrap
sudo cp aoe2-telegram-bot.service /etc/systemd/system/aoe2-telegram-bot.service
sudo systemctl daemon-reload
sudo systemctl enable aoe2-telegram-bot
sudo systemctl start aoe2-telegram-bot

Installed sounds

• taunt.zip are french taunt in mp3 format. There are 42 taunts in total.
  • their name are composed of a 2 padded number (like 02 or 15), a space and the name
• civilization.zip are all specific civilization start sounds in mp3 format
  • their name is a single word starting with a capital letter
• sound.zip are all in game sounds (building, generic units...) in wav format
  • their name is full lowercase and can have a number only at the end (e.g. multiples sounds for the same thing)

How to get sounds

to get sound checks your steam files in $HOME/.steam/steam/steamapps/common/AoE2DE/wwise/ and get pck files.

Get the softwares

You need to extract .pck that contains .bnk files that contain wem files that you need to convert to wav or ogg.

• extract pck but is windows only
• extract bnk or this updated one
• convert ww to ogg

If you build wwisexmabank or xmash on mondern Linux add $(CC) $^ -o $@ $(LDFLAGS) on line 10 in Makefile.common