Post to Telegram channels and groups directly from your terminal — fast, secure, and developer friendly.

PostOrbit — Telegram Terminal Poster

Terminal → Telegram Post in Seconds
Developed by Amit Das

Overview

PostOrbit is a lightweight Python CLI tool designed for developers, bot owners, and automation users who want to post messages, images, GIFs, or documents to Telegram channels and groups directly from the terminal.

It supports inline buttons, media uploads, HTML formatting, and admin preview confirmation for safe publishing.

No complex frameworks required — simple, fast, and reliable.

⚡ Core Features

Post to Telegram channels and groups
Send text, photo, GIF, or document
Inline button support (JSON config)
HTML caption formatting
Admin preview before posting
Confirmation prompt for safety
Supports username, URL, or chat ID
Lightweight and fast
No database required

📦 Requirements

Python 3.7+
requests library

Install dependency:

pip install requests

🛠 Setup

1. Clone repository

git clone https://github.com/AmitDas4321/PostOrbit.git
cd PostOrbit

2. Edit config.py

BOT_TOKEN = "YOUR_BOT_TOKEN"
ADMIN_ID = YOUR_TELEGRAM_CHAT_USER_ID

3. Edit message.txt

Example:

📢 <b>Official Announcement</b>

PostOrbit is now live.

Click the button below to view the repository.

Thank you 💙

4. Edit message.json

Example:

{
  "photo_enable": true,

  "photo": "5348285704398963795.png",
  "parse_mode": "HTML",

  "has_spoiler": false,
  "protect_content": false,

  "buttons_enable": true,
  "button_count": 2,

  "buttons": [
    { "text": "View Repository 💻", "style": "success", "url": "https://github.com/AmitDas4321/PostOrbit" },
    { "text": "Join Channel 📢", "style": "primary", "url": "https://t.me/BlueOrbitDevs" }
  ]
}

🎨 Button Color (style) Usage

PostOrbit supports optional button colors using the style field.

Available styles:

Style	Color	Example
`primary`	🔵 Blue	Main action
`success`	🟢 Green	Confirm / Positive action
`danger`	🔴 Red	Warning / Delete

Example with colors:

{
  "buttons": [
    { "text": "View Repository 💻", "style": "success", "url": "https://github.com/AmitDas4321/PostOrbit" },
    { "text": "Join Channel 📢", "style": "primary", "url": "https://t.me/BlueOrbitDevs" }
  ]
}

Disable color (default button)

If you don't want colored buttons, set the style value to an empty string:

{ "text": "View Repository 💻", "style": "", "url": "https://github.com/AmitDas4321/PostOrbit" },
{ "text": "Join Channel 📢", "style": "", "url": "https://t.me/BlueOrbitDevs" }

which will show the default Telegram button.

Notes

style is optional
If not specified, Telegram shows default button
Invalid style values will be ignored

▶️ Usage

Run the script:

python main.py

Enter target:

@your_channel_username

Preview will be sent to admin.
Type:

To confirm posting.

🎯 Supported Targets

You can use:

@channelusername
t.me/channelusername
https://t.me/channelusername
-100xxxxxxxxxx

🧩 Use Cases

Channel Automation

Post updates instantly from terminal.

Developer Workflows

Integrate posting into scripts or pipelines.

Content Management

Quickly publish announcements or media.

Bot Systems

Use as backend publishing utility.

🔒 Security

No data storage
No external tracking
Uses official Telegram Bot API
Runs locally on your machine

⚠️ Important

Bot must be admin in channel with permission:

✅ Post Messages

📬 Support

📜 License

Made with ❤️ by Amit Das
☕ Support development: PayPal.me/AmitDas4321

AmitDas4321/PostOrbit