Code Monkey home page Code Monkey logo

tguserdetails's Introduction

README.md - Telegram User Information Retrieval Tool

This Python script is designed to retrieve information about a Telegram user, public channel, or group by their username, ID, phone number, or the URL of a message they sent. It utilizes the Telethon library to interact with the Telegram API. This README file provides an overview of the script, how to use it, and its features.

Table of Contents

  1. Requirements
  2. Usage
  3. Functionality
  4. Script Description
  5. License

Requirements

Before using this script, make sure you have the following dependencies installed:

  • Python 3.x
  • Telethon library
  • Other libraries: argparse, colorama

You can install the required packages using pip:

pip install telethon argparse colorama

You will also need to obtain your Telegram API credentials (api_id and api_hash) from Telegram's website. Replace the placeholders in the script with your credentials.

Usage

Run the script from the command line, providing one of the following options:

  • -u or --username: To retrieve information by username.
  • -i or --id: To retrieve information by user or channel ID.
  • -p or --phone: To retrieve information by phone number.
  • -l or --url: To retrieve information from the URL of a message sent in a public channel or group.

Example usages:

python3 script.py -u mytelegramuser
python3 script.py -i 123456789
python3 script.py -p +1234567890
python3 script.py -l https://t.me/mychannel/1234

Follow the prompts for authentication and input if required.

Functionality

This script can retrieve the following information about Telegram users, channels, or groups:

  • User Information:

    • User ID
    • First name
    • Last name (if available)
    • Username (if available)
    • Last seen status (online, offline, recently, last week, last month)
    • Biography (about)
    • Profile picture download (as JPG)
  • Channel Information:

    • Channel ID
    • Title
    • Username (if available)
    • Description
    • Creation date
    • Profile picture download (as JPG)
  • Group Information:

    • Group ID
    • Title
    • Number of administrators
    • Creation date
    • Profile picture download (as JPG)
  • Phone Number Information (Temporary Contact):

    • User ID
    • First name
    • Last name (if available)
    • Username (if available)
    • Last seen status (online, offline, recently, last week, last month)
    • Biography (about)
    • Profile picture download (as JPG)
    • Restores contacts after retrieving information
  • Message URL Information:

    • Retrieves information from the URL of a message in a public channel or group

Script Description

  • The script uses the Telethon library to interact with the Telegram API.
  • It provides a command-line interface (CLI) for users to input their preferences.
  • Users can specify the target user, channel, or group by username, ID, phone number, or URL.
  • User authentication is handled within the script.
  • The script downloads profile pictures and saves them as JPG files.
  • Information retrieved is displayed in a readable format.

License

This script is provided under the MIT License. You can find the full license text in the LICENSE file.


Feel free to use and modify this script according to your needs. If you have any questions or encounter issues, please don't hesitate to ask or report them. Happy Telegram user information retrieval!

tguserdetails's People

Contributors

n4rr34n6 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.