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:

Y

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

MIT License © 2026 Amit Das

---

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