Skip to main content

Controller for bot to control your PC through telegram messages

Project description

Project Description

GPLv3 License Version

dspc_bot_ctrl

dspc_bot_ctrl is a utility controller for a Telegram bot that can control your desktop actions.

It provides a set of commands that, when triggered can act on those commands accordingly. These commands are sent by the user through the telegram bot they will create (through @BotFather) for remotely controlling the desktop.

Why should I use this?

Want to remote control your desktop for achieving tasks and monitoring processes but don't want to incur higher processing overhead by using general software applications for remote control and desktop sharing? This utility can help you with that. Since this runs on cmd and uses the win32 dlls through win32 utilities for python, the processing overhead with respect to other scripts and actions you want to overlook remotely is low.

Features

Remote controls

  • Can shut down workstation.
  • Can take a screenshot of the system or start a stream of screenshots.
  • Can run CMD commands.
  • Can switch active windows.
  • Can type keys or hotkeys or shortcut combinations.
  • Can display all running processes.
  • Can display all active window titles.

General

  • Easily controlled by commands.
  • Only a workstation and a mobile device containing the Telegram android app needed.
  • No processing, streaming and bandwidth overhead.

Requirements

Requires Python -v > 3.6.0

Installation

$ pip install dspc_bot_ctrl

Initial Preparations

Since the controller relies on Telegram and its messaging ecosystem to communicate and get commands from user, the Telegram Android app must be installed in your android device.

In order to create a bot for yourself that responds to your message, create your bot using @BotFather. Contact BotFather throught the Telegram Android App and type in /newbot. Follow the instructions and note the HTTP API token it provides and it is used to initialize the bot in first run.

Using dspc_bot_ctrl

Importing Bot Class

from dspc_bot_ctrl.dspc_bot import DSPCBOT

Initializing and Deploying The Bot

DSPCBOT().init()

If you are running the controller for the first time, it would ask for the HTTP API token that you have noted down when you created the bot. Once you feed in the token, it would be saved and subsequent runs would not need the token. If you want to revoke the saved token for a new bot, type in 'revoke' in the password field.

For every run, the controller would ask you for a password. Once the password is inputed, the controller would look out for a identification message from you. Find the bot by the name you have provided for the bot through BotFather and send message 'identify_me <password>' to the bot through the Telegram Client. Once the controller receives the identification message with the correct password, It will start polling for messages and you can use the bot as you please.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dspc_bot_ctrl-1.0.0.tar.gz (8.0 kB view details)

Uploaded Source

Built Distribution

dspc_bot_ctrl-1.0.0-py3-none-any.whl (22.3 kB view details)

Uploaded Python 3

File details

Details for the file dspc_bot_ctrl-1.0.0.tar.gz.

File metadata

  • Download URL: dspc_bot_ctrl-1.0.0.tar.gz
  • Upload date:
  • Size: 8.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.0

File hashes

Hashes for dspc_bot_ctrl-1.0.0.tar.gz
Algorithm Hash digest
SHA256 aa93248eb3602fda76a4bff34644c0704be73634ca8ce50e4f6ab215390879c4
MD5 a6ab3ac622daa5ce8b54df96ffa97a3b
BLAKE2b-256 3ef7d4c0d746fd4bfec73a6c039f9c93598573796aad5020e9f675f523af948e

See more details on using hashes here.

File details

Details for the file dspc_bot_ctrl-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: dspc_bot_ctrl-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 22.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.0

File hashes

Hashes for dspc_bot_ctrl-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 37b7434e0acce7a1ce01f525f1c36b9563d1bc816a70b9d120565ad214a7b0c1
MD5 e614b03df4c9979a4fe2613448c34cde
BLAKE2b-256 9da891a02b30c6e2e12f4d6525622947a5577a16ee0e92d680aa5a1b4acb0de3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page