https://github.com/shingareom/s2gram

s2gram.sh is a Bash script that facilitates sending text messages or files to a Telegram chat using a Telegram bot.
https://github.com/shingareom/s2gram

bash bugbounty-tool omshingare pentest telegram tool

Last synced: about 1 month ago
JSON representation

s2gram.sh is a Bash script that facilitates sending text messages or files to a Telegram chat using a Telegram bot.

• Host: GitHub
• URL: https://github.com/shingareom/s2gram
• Owner: ShingareOm
• License: mit
• Created: 2024-06-25T14:43:36.000Z (6 months ago)
• Default Branch: master
• Last Pushed: 2024-06-25T17:50:33.000Z (6 months ago)
• Last Synced: 2024-06-26T16:30:50.766Z (6 months ago)
• Topics: bash, bugbounty-tool, omshingare, pentest, telegram, tool
• Language: Shell
• Homepage: https://omshingare.me
• Size: 142 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![GitHub release](https://img.shields.io/badge/release-v1.3.4-brightgreen?style=flat-square)](https://github.com/ShingareOm/s2gram/releases)

[![GitHub stars](https://img.shields.io/github/stars/ShingareOm/s2gram?style=flat-square)](https://github.com/ShingareOm/s2gram/stargazers)

[![GitHub forks](https://img.shields.io/github/forks/ShingareOm/s2gram?style=flat-square)](https://github.com/ShingareOm/s2gram/network)

[![GitHub issues](https://img.shields.io/github/issues/ShingareOm/s2gram?style=flat-square)](https://github.com/ShingareOm/s2gram/issues)

[![GitHub license](https://img.shields.io/github/license/ShingareOm/s2gram?style=flat-square)](https://github.com/ShingareOm/s2gram/blob/main/LICENSE)

# s2gram

**s2gram.sh is a Bash script that facilitates sending text messages or files to a Telegram chat using a Telegram bot.**

![s2gram-banner](banner.png)

## ***Requirements*** 

- curl needs to be installed, If not installed already.

- Telegram chat ID [CHATID](CHATID.md)

- Telegram bot API token [AUTHTOKEN](AUTHTOKEN.md)

## ***Download s2gram***

You can download the latest version of s2gram by cloning the GitHub repository.

```bash

git clone https://github.com/ShingareOm/s2gram.git

```

## ***Installation***

 - cd to **s2gram** directory. ```cd s2gram```

 - add your `TOKEN="YOUR-BOT-TOKEN"` & `CHAT_ID="YOUR-CHAT-ID-OF-TELEGRAM"` in s2gram.sh shell script, See [Requirements](#requirements) 

 - make executable: `sudo chmod +x ./s2gram.sh`

 - add in /bin: `sudo cp s2gram.sh /bin/s2gram` OR `sudo cp s2gram /usr/bin/s2gram` 

 - you will be able to access and run the s2gram with simple `s2gram --help` command.

## ***Features***

- Send Messages

    Send text messages directly to Telegram.

    Send files as documents to Telegram.

- Clipboard Integration

    Fetch and send the current contents of the clipboard.

- Path Information

    Retrieve and send the current working directory path.

- Piping

    You can use this tool using piping as well, to send some data using stdin pipe

- Help and Usage

    Provides a comprehensive help message outlining available options and examples.

## **Advanced Usage**



Author: Om Shingare (Om Shingare)


Usage: ./s2gram.sh [OPTIONS]

Send text or files to Telegram chat using a Telegram bot.

Options:

  -t, --text "message"    Send a text message

  -f, --file file.ext     Send a file

  -c, --clipboard         Send current clipboard contents

      --path              Send current working directory path

  -h, --help              Show this help message

Examples:

  cat 'file.txt' | s2gram.sh

  s2gram.sh -t \"this is my text\"

  s2gram.sh -f file.ext

  s2gram.sh -c

  s2gram.sh --path



## **Legal disclaimer**

    Usage of s2gram for attacking targets without prior mutual consent is illegal.

    It is the end user's responsibility to obey all applicable local,state and federal laws. 

    Developer assume no liability and is not responsible for any misuse or damage caused by this program.