https://github.com/stunnel/tgsend
Send messages and files over Telegram from the command line.
https://github.com/stunnel/tgsend
command-line golang telegram telegram-bot
Last synced: over 1 year ago
JSON representation
Send messages and files over Telegram from the command line.
- Host: GitHub
- URL: https://github.com/stunnel/tgsend
- Owner: stunnel
- License: mit
- Created: 2021-05-14T02:57:08.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2022-06-05T15:23:33.000Z (about 4 years ago)
- Last Synced: 2024-06-20T08:20:43.730Z (about 2 years ago)
- Topics: command-line, golang, telegram, telegram-bot
- Language: Go
- Homepage:
- Size: 1.58 MB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tgsend in golang
[](https://opensource.org/licenses/MIT)
telegram-send in golang
tgsend is a command-line tool to send messages and files over Telegram to your account, group or channel.
**Table of Contents**
- [tgsend in golang](#tgsend-in-golang)
- [Usage](#usage)
- [Command parameter](#command-parameter)
- [Message type priority](#message-type-priority)
- [Start](#start)
- [Example](#example)
- [Build](#build)
## Usage
### Command parameter
```shell
tgsend -h
-token string
Set the bot token.
-chatid int
Send message to this User ID or Channel ID or Group ID.
-message string
The message to sent.
-pre
Send preformatted fixed-width (monospace) text.
-format string
How to format the message(s). Choose from ['text', 'markdown', 'html'] (default 'text')
-preview
disable link previews in the message(s)
-filename path
The file to sent.
-filetype string
Set the file type, Choose from ['photo', 'video', 'document', 'audio', 'sticker', 'animation'] (default 'document')
-caption string
Set the photo/video/document/audio/animation caption
-location
Send location
-latitude float
Set latitude, value valid [-90, 90]
-longitude float
Set longitude, value valid [-180, 180]
-timeout int
Set the read timeout for network operations(in seconds). (default 30)
-debug
Show debug message.
-version
Print version information.
```
#### Message type priority
**message > location > file**
It means that if you provide a `message`, parameters such as `location`, `filetype` and `caption` will not be used.
### Start
1. Create a bot.
Chat with BotFather , send /newbot command to create a new bot, and get the token, for example `110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw`
2. Chat with your bot, use your Telegram account.
3. Get your telegram account's ID. Send any message to , This bot will return the raw message from Telegram(json format). `["message"]["from"]["id"]` is your account's ID. eg `12345678`.
4. Afterward, now you can send a message via `tgsend`.
`tgsend -token 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw -chatid 12345678 -message "Hello World."`
There is a maximum message length of 4096 characters and 50 MiB of file limit by Telegram, larger messages will be automatically split up into smaller ones and sent separately, larger files will fail to send.
### Example
Send a message:
Set environment variables
```shell
TG_TOKEN=110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw
TG_CHAT_ID=12345678
```
```shell
tgsend -token "${TG_TOKEN}" -chatid "${TG_CHAT_ID}" \
-message "Hello World."
```
Send from stdin:
```shell
echo "now: $(date)" | tgsend -chatid "${TG_CHAT_ID}" \
-token "${TG_TOKEN}" \
-message -
```
To send a message using Markdown or HTML formatting:
```shell
tgsend -token "${TG_TOKEN}" -chatid "${TG_CHAT_ID}" \
-format markdown -message "*bold text* _italic text_"
tgsend -token "${TG_TOKEN}" -chatid "${TG_CHAT_ID}" \
-format html -message 'bold, bold
italic, italic
inline URL
inline mention of a user
inline fixed-width code
pre-formatted fixed-width code block
'
```
send a message using Markdown with multi lines:
```shell
tgsend -token "${TG_TOKEN}" -chatid "${TG_CHAT_ID}" \
-format markdown -message '*bold text*
_italic text_
[inline URL](https://www.example.com/)
[inline mention of a user](tg://user?id=123456789)
`inline fixed-width code`
```block_language
pre-formatted fixed-width code block
```'
```
For more information on supported formatting, see the [Formatting options](https://core.telegram.org/bots/api#formatting-options).
The `--pre` flag formats messages as fixed-width text:
```shell
tgsend -token "${TG_TOKEN}" -chatid "${TG_CHAT_ID}" \
-pre -message "monospace"
```
To send a message without link previews:
```shell
tgsend -token "${TG_TOKEN}" -chatid "${TG_CHAT_ID}" \
-preview -message "https://github.com/"
```
Send a file (maximum file size of 50 MB):
```shell
tgsend -token "${TG_TOKEN}" -chatid "${TG_CHAT_ID}" \
-filetype document -filename document.pdf
```
To send an image with an optional caption (maximum file size of 10 MB):
```shell
tgsend -token "${TG_TOKEN}" -chatid "${TG_CHAT_ID}" \
-filetype photo -filename photo.jpg -caption "The Moon at night"
```
To send a location via latitude and longitude:
```shell
tgsend -token "${TG_TOKEN}" -chatid "${TG_CHAT_ID}" \
-location -latitude 35.5398033 -longitude -79.7488965
```
## Build
build directly from source:
```shell
go build -o tgsend tgsend.go
```
make releases:
```shell
make release
```
Then you can find the compressed binaries in the `release` directory.