Skip to content

Latest commit

 

History

History
43 lines (31 loc) · 2.28 KB

README.md

File metadata and controls

43 lines (31 loc) · 2.28 KB

PyPI license MIT

adminbot

A python-implemented telegram bot to admin your server.

Overview

alt tag alt tag alt tag

Features

The package deploys a telegram bot with the following capabilities:

  • Remote python interpreter.
  • Send matplotlib images. Yeah, plot a sine or two a send them to your mobile. You'll be the soul of the party.
  • Run shell commands.
  • Use-related commands (disk use, check cpu-consuming processes).

Installation

Assuming you have python with pip:

  • To install the last 'stable' version from pypi: pip install adminbot. Do not expect much stability in the API though...
  • To install the last development version: pip install https://github.com/dih5/adminbot/archive/master.zip.

If you are a cool guy you'll prefer to use python3 and pip3 instead, unless you are a cool Arch Linux user.

Running

If you are new to telegram bots first check the official introduction and create a bot using the BotFather. Create a file following example.json, using your bot's token. For the bot to answer your commands you must add your user id to the adminlist. Don't worry if you don't know it yet. Run the bot using adminbot example.json . If everything went right you should be able to talk to it in from your telegram client.

If you did not add your user id to the admin list you will see it in the console when the bot receives a message. Add it and restart the bot.

To finish the bot just SIGINT it (Ctrl-C). It takes a few seconds to stop.

Related projects

I also made a Mathematica implementation of this sort of program. If you are interesented you may check it here.