Skip to content

Latest commit

 

History

History
346 lines (226 loc) · 6.76 KB

readme.md

File metadata and controls

346 lines (226 loc) · 6.76 KB

TGPy modules I use

These are some TGPy modules from my collection, made by my friends or myself. Feel free to read sources and adjust some code parts to your needs.

Installation

I include installation code for each module. Just run it with TGPy — that is, send the code anywhere in Telegram. The code downloads the> source from this repo and adds it to your modules.

Dependencies

Some modules have pip dependencies. You can install them the way you prefer:

  • Just run pip install on the machine where TGPy is running.
  • Set up a way to run shell commands from Python (like the example from the docs) and run something like shell('pip install ...').
  • Use pipdep module to automatically install imported pip packages.

Contents

🌐 Side tools

Genius by @purplesyringa

Source

Searches song lyrics on genius.com.

Dependencies:

pip install html2text requests

Install:

from urllib.request import urlopen

url = 'https://raw.githubusercontent.com/tm-a-t/tgpy-modules/main/modules/genius.py'
modules.add('genius', urlopen(url).read())
restart()

Example:

.genius believer

sed by @purplesyringa

Source

Uses sed tool on messages. When you reply to a message from others, this just outputs a result of processing. When you reply to your message, your message gets edited instead.

Install:

from urllib.request import urlopen

url = 'https://raw.githubusercontent.com/tm-a-t/tgpy-modules/main/modules/sed.py'
modules.add('sed', urlopen(url).read())
restart()

Example: (in reply to a message)

s/yes/no/g

🛠 TGPy utils

Dunder fix by @vanutp

Source

Telegram app for Android has a flaw in formatting: there is no way to prevent text surrounded by double underscores turning into italic text. This annoys because you often want to use __dunder__ methods in Python.

The module tries to restore the code by replacing the italic parts of the message with __dunder__ parts.

Install:

from urllib.request import urlopen

url = 'https://raw.githubusercontent.com/tm-a-t/tgpy-modules/main/modules/dunder-fix.py'
modules.add('dunder-fix', urlopen(url).read())
restart()

aiohttp

Source

One line. Starts http, a client session object that can be used to make requests.

Dependencies:

pip install aiohttp

Install:

modules.add('http', 'import aiohttp \nhttp = aiohttp.ClientSession()')
restart()

Example of usage:

async with http.get('https://python.org') as response:
    print("Status:", response.status)

    html = await response.text()
    print("Body:", html[:15], "...")

Uptime by @irdkwmnsb

Source

A simple function that shows how long TGPy has been active.

Install:

from urllib.request import urlopen

url = 'https://raw.githubusercontent.com/tm-a-t/tgpy-modules/main/modules/uptime.py'
modules.add('uptime', urlopen(url).read())
restart()

Example:

uptime()

TGPy> 2 days, 0:15:15.700456

Bot controller

Source

Use Telethon to control a bot like your account.

Install:

from urllib.request import urlopen
import tgpy.api

tgpy.api.config.set('bot_token', 'YOUR_BOT_TOKEN_HERE')

url = 'https://raw.githubusercontent.com/tm-a-t/tgpy-modules/main/modules/bot-controller.py'
modules.add('bot-controller', urlopen(url).read())
restart()

Examples of usage:

# Sends a message to the same group
# if the bot is in the group

await bot.send_message(msg.chat_id, 'hello world')
return
# Sends a message with a button to personal messages to someone
# (works only if user started a dialog with the bot)

from telethon import Button

button = Button.url('Google', 'https://google.com')
await bot.send_message('User Full Name', 'Hey', buttons=button)
return
# starts replying to all messages with their text

from telethon import events


@bot.on(events.NewMessage())
async def on_new_message(event):
    text = event.text
    await event.reply(text)

pipdep by @purplesyringa

Source

Automatically installs all pip packages imported in your saved modules.

Install:

from urllib.request import urlopen

url = 'https://raw.githubusercontent.com/tm-a-t/tgpy-modules/main/modules/pipdep.py'
modules.add('pipdep', urlopen(url).read())
restart()

👾 Fun stuff

Name character

Source

Just a function I often use to find out the unicode name of a letter, symbol, or emoji.

Install:

modules.add('name', 'from unicodedata import name')
restart()

Example of usage:

name('👺')

TGPy> JAPANESE GOBLIN

Pin message

Source

This module is used in TGPy Flood chat to allow all members to pin messages (not only admins.)

When someone sends /pin to the chat, the person with this module automatically pins their message.

If there are multiple people who has this module installed, only one gets to pin the message. So it becomes a random race :)

from urllib.request import urlopen

url = 'https://raw.githubusercontent.com/tm-a-t/tgpy-modules/main/modules/tgpy-pin.py'
modules.add('tgpy-pin', urlopen(url).read())
restart()

Animate message

Source

Send a message and edit it many times to create a typing animation.

Install:

from urllib.request import urlopen

url = 'https://raw.githubusercontent.com/tm-a-t/tgpy-modules/main/modules/anim.py'
modules.add('anim', urlopen(url).read())
restart()

Example:

anim('Magic typing effect ✨')

Shout

Source

When used in reply to a message, shows its text "shouted".

from urllib.request import urlopen

url = 'https://raw.githubusercontent.com/tm-a-t/tgpy-modules/main/modules/shout.py'
modules.add('shout', urlopen(url).read())
restart()

Example:

# in reply to "python"
shout()

TGPy> PYTHOOOOOON