Skip to content
@Telethonian

Telethonian

Telethonian is a community-driven platform for sharing Telethon-based scripts and plugins, enhancing Telegram bot development. By @ankit-chaubey.

Telethonian πŸš€

A community-driven organization dedicated to building, sharing, and enhancing pre-made scripts and plugins for the Telethon library.


GitHub last commit GitHub issues GitHub stars

🌟 Purpose

Telethonian is designed to support developers working with the Telethon library by offering a centralized platform for sharing, collaborating, and learning from a range of pre-built scripts and plugins. Our mission is to make Telethon development faster, easier, and more accessible for everyone.


πŸ”‘ Key Goals

  1. Provide Quality Scripts: A collection of pre-made scripts for various Telethon functions, from simple automation tasks to advanced integrations.
  2. Encourage Community Contributions: We welcome everyone! Share any script or plugin that could benefit others.
  3. Support Customization: Find and customize scripts to suit your needs. You can build upon existing scripts or adapt them to your project.
  4. Foster Collaboration: Create a space for developers to work together, improve scripts, troubleshoot issues, and share knowledge.

πŸ“˜ What is Telethon?

Telethon is an asynchronous Python 3 library for interacting with the Telegram API. It allows developers to create Telegram clients and bots, manage messages, and access Telegram's advanced features with ease. Telethonian supports developers using Telethon by providing an array of tools and resources.


πŸš€ How to Use Telethonian

1. Browse Pre-Made Scripts Explore our repositories for scripts that automate tasks, manage groups, or customize bot functionalities. Use tags to search by function or category.
2. Contribute Your Own Scripts If you have a script or plugin that can help others, please contribute! Fork the repository, add your script in the relevant folder, and submit a pull request.
3. Collaborate and Improve Found an area for improvement? Fork, improve, and submit a pull request, or raise an issue if you encounter any bugs. Contributions of all skill levels are welcome!

🀝 How to Contribute

We encourage users to contribute in any of the following ways:

  • Add New Scripts or Plugins
    Submit scripts that others can easily integrate into their projects. Every contribution helps grow our library and assist other developers.

  • Improve Existing Scripts
    Find a way to optimize or enhance an existing script? Submit improvements for review.

  • Submit Issues
    Encountered an issue with a script? Open an issue on the repository, and we’ll work to resolve it together.


πŸ› οΈ Installation

To get started with Telethon and the scripts shared in this organization, follow these steps:

  1. Install the Telethon library:

    pip install telethon
  2. Clone the Repository

Clone any of the Telethonian repositories to get started with pre-made scripts:

git clone https://github.com/ankit-chaubey/telethonian.git
cd telethonian
  1. Usage

Each repository contains scripts that can be run directly or customized for your needs. Follow the documentation inside each script to set it up and configure it for your bot.


πŸ“ Example Modules

Auto-Responder Bots Automatically respond to messages based on custom conditions.

Group Management Tools Manage Telegram groups, including automatic message deletion, user moderation, and bans.

Data Collection Scripts Collect user data, analyze messages, and create reports.


🀝 How to Contribute

We encourage contributions to make this project better. Here's how you can contribute:

  1. Add a New Script/Plugin If you have a useful script, feel free to submit it! Just fork this repository, add your script, and open a pull request.

  2. Improve Existing Scripts Improving functionality, fixing bugs, or adding new features is always appreciated. Find an issue or a script that could use improvement and submit your changes.

  3. Submit Issues If you face any issues with the current scripts, create a new issue in the relevant repository, and we will work together to fix it.

If you're interested in adding a new repository, such as a group management bot or any other project that follows Telegram and Telethon's rules, you're welcome to contribute! We encourage all developers to share their scripts and plugins.

πŸ“¬ Contact Me

Feel free to reach out if you have any questions, suggestions, or contributions!


πŸ“ Repository Structure

We follow a simple structure to ensure ease of use:

β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ main.py            
script file
β”‚   β”œβ”€β”€ config.py          # Optional
config file
β”‚   └── utils/             # Helper
functions
β”œβ”€β”€ README.md              # This file
with setup instructions
└── LICENSE                # Licensing
information

πŸ§‘β€πŸ’» Technologies Used

Telethon – Asynchronous Python 3 library for Telegram API.

Python 3.x – The main programming language.

Asyncio – For asynchronous operations in Telethon.

GitHub Actions – For Continuous Integration and deployment.


πŸ’‘ Telethonian Features

Automated Moderation Scripts to handle common group moderation tasks, like banning spammers and clearing inactive members.

Custom Commands Easily extendable modules to add custom commands to your bot, like keyword-based responses.

Bot Monitoring Tools Set up monitoring features to track your bot’s performance, such as uptime, activity logs, and more.


πŸ› οΈ Example of a Simple Script

Here's an example of how easy it is to use Telethonian's scripts:

from telethon import TelegramClient

# Create a new TelegramClient
client = TelegramClient('session_name', api_id, api_hash)

# Function to send a message
async def send_message():
    await client.send_message('me', 'Hello, Telethonian!')

# Run the client
client.start()
client.loop.run_until_complete(send_message())

πŸ”„ License

Telethonian is licensed under the MIT License. See the LICENSE file for more details.


πŸ† Credits

Created by Ankit Chaubey, Telethonian is a project that aims to simplify Telegram bot development. While this project began with my efforts, it will grow with the help and contributions of the community. In the future, we expect Telethonian to expand with more features, scripts, and improvements, making it an even more powerful tool for all developers.

Feel free to contribute, share your ideas, and help this project grow!

🚨 Important Note

Telethonian is an independent project and is not affiliated with the official Telethon repository. While Telethonian uses the Telethon library to build its functionalities, it is a community-driven project designed to extend and enhance the capabilities of Telethon.

This repository contains pre-made scripts and plugins created by various developers for public use, simplifying bot development and other Telegram-related tasks. It is not officially maintained or supported by the Telethon team.


Telethonian: Simplifying Telegram bot development, one script at a time. ✨

Pinned Loading

  1. .github .github Public

Repositories

Showing 3 of 3 repositories
  • .github Public
    Telethonian/.github’s past year of commit activity
    0 0 0 0 Updated Nov 13, 2024
  • Telethonian Public

    Telethonian: a collaborative repository for sharing and enhancing Telethon-based scripts and plugins, streamlining Telegram bot development for the community.

    Telethonian/Telethonian’s past year of commit activity
    Python 0 MIT 3 0 0 Updated Nov 13, 2024
  • Telethon Public Forked from LonamiWebs/Telethon

    Pure Python 3 MTProto API Telegram client library, for bots too!

    Telethonian/Telethon’s past year of commit activity
    Python 0 MIT 1,485 0 0 Updated Nov 6, 2024

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…