ANBUPush Documentation

Introduction

For beginners to professionals — everything you need to know about managing Telegram uploads

ANBU Push is a powerful, all-in-one application that transforms how you manage and automate your Telegram channels. Whether you're a content creator or community manager, ANBU Push combines automation, monitoring, and management tools into one intuitive interface.

What ANBU Push Does

• Upload and schedule content across multiple channels effortlessly
• Automate repetitive tasks with intelligent rules and smart detection
• Manage multiple bots and channels from one central location
• Monitor uploads in real-time with comprehensive status tracking

Built for Everyone

Whether you're starting with your first Telegram channel or managing dozens for clients, ANBU Push scales with your needs. The interface is simple enough for beginners while providing the advanced features that power users demand.

Key Features at a Glance

• Drag & Drop Interface: Simply drag files to upload them instantly
• Smart Upload Detection: Automatically suggests the best way to handle your files
• Multi-Bot Support: Manage multiple Telegram bots from one interface
• Rule-Based Automation: Create rules for consistent, automated processing
• Background Scheduling: Schedule posts with automatic retry on failures
• Real-Time Monitoring: Track upload progress, history, and analytics

Quick Start Guide

Let's get you posting to your Telegram channel with ANBU Push in minutes

Think of ANBU Push as your smart uploader. It needs two keys to talk to Telegram for you:

• Bot Token (from BotFather): lets ANBU post as your bot into your channel
• API ID + API Hash (from my.telegram.org): lets ANBU handle bigger uploads reliably

Step 1 — Create Your Bot

Why: The bot is the account ANBU uses to post into your channel.

1. In Telegram, open @BotFather
2. Send /newbot and follow the prompts (pick a name and a username ending in "bot")
3. Copy the Bot Token it gives you (looks like 123456789:ABC...) — keep it safe!

Step 2 — Make Your Bot an Admin

1. Open your channel → Channel Info → Administrators → Add Admin
2. Search your bot's username and add it
3. Grant "Post Messages" permission → Save

Tip: For private channels, get the numeric "-100..." ID from @userinfobot.

Step 3 — Get Your API ID and API Hash

1. Go to my.telegram.org → log in → enter the code
2. Click "API development tools" → "Create application"
3. Copy API ID and API Hash

Step 4 — Add Your Bot and Channel in ANBU

Add bot: Bots panel → Configuration tab → fill in Bot Name, API ID, API Hash → Save.

Add channel: Push panel → "Add Channel". Public: @yourchannelname. Private: "-100..." ID.

Step 5 — Upload Your First Files

1. Open the Push panel
2. Drag and drop your files into the workspace
3. Choose "Publish with Rules" or "Manual Upload"
4. Confirm → watch progress in the Upload Queue

Quick Fixes

• "Bot can't post": Ensure the bot is an Admin with "Post Messages" permission
• Large videos failing: Make sure API ID and API Hash are saved for the bot
• Private channel not posting: Confirm bot is Admin; use -100... ID from @userinfobot

Dashboard — Your Command Center

A real-time overview of your ANBU Push system's health and activity

What the Dashboard Shows

• System Health: CPU usage, memory consumption, and overall performance
• Upload Statistics: Current uploads, completed uploads, and failed uploads
• Bot Status: Connection status and activity of all your Telegram bots
• Recent Activity: Latest uploads, errors, and system events

Key Metrics

• Active Uploads: Shows currently processing uploads
• Completed Today: Number of successful uploads today
• Failed Uploads: Uploads that need attention
• Queue Size: Pending uploads waiting to be processed

Tips

• Check the Dashboard first thing to see if there are any issues
• Use the activity log to understand what happened if something seems wrong
• If a bot shows disconnected, head to the Bots panel to fix the connection

Push Panel — Complete User Guide

For beginners to professionals — everything you need to know about uploading to Telegram

What is the Push Panel?

The Push Panel is your central command center for all Telegram uploads.

• Uploads files to your Telegram channels
• Manages multiple bots and channels in one place
• Schedules posts for later publishing
• Duplicates content across multiple channels
• Applies rules automatically to your uploads
• Shows upload progress in real-time

Understanding the Interface

1. Bot Tab (Main Upload Area) — Left: Channel list. Right: Workspace. Bottom: Action buttons.

2. + Add Bot Tab — Quick setup without leaving the upload workflow.

3. Upload Queue Tab — Real-time monitoring and management controls.

Channel Types

• Public Channels: @channelname format
• Private Channels: Numeric ID format (-100123456789)
• Groups: Numeric ID format (-100123456789)

The Workspace — Your File Hub

The heart of the Push Panel — organize, preview, and prepare content before sending.

File Upload Methods

1. Drag & Drop Files — Grab files and drop them into the workspace.

2. Drag & Drop Folders — System scans for supported media files.

3. Browse Button — Choose individual files or folders.

4. Multiple Files — Hold Ctrl to select multiple, then drag.

File Management

• Click once: Select a file
• Double-click: Open the file
• Right-click: Context menu
• Ctrl + A: Select all
• Delete: Remove selected
• Shift+click: Range selection

Thumbnail Resizing

• Small: Best for browsing large collections
• Medium: Balance between detail and quantity
• Large: Detailed preview
• Last 15% of Slider: Converts to list view

Workspace Expansion

• Collapse Main Sidebar: Click the hamburger menu
• Collapse Channel Sidebar: Click the channel title
• Both Collapsed: Maximum workspace area

File Types Supported

• Images: JPG, JPEG, PNG, GIF, WebP, BMP, TIFF
• Videos: MP4, AVI, MOV, MKV, WebM, FLV, WMV
• Audio: MP3, WAV, OGG, FLAC, AAC
• Documents: PDF, DOC, DOCX, TXT, RTF
• Archives: ZIP, RAR, 7Z, TAR, GZ

Action Buttons

Manage Channels — Takes you to the Bots Panel channel management.

Apply Rules — Choose a rule to apply to selected files.

Publish — Upload selected files immediately.

Schedule — Set files to upload at a specific date and time.

Duplicate — Copy files to other channels for cross-posting.

Smart Upload Detection

• "Publish with Rules": If matching rules exist, suggests using them
• "Manual Upload": If no rules match, lets you choose settings

Upload Queue Management

• Start / Pause / Resume / Stop / Retry / Cancel

Multi-Bot Support

• Switch between bots: Use the bot tabs at the top
• Different channels per bot: Each bot has its own channels
• Separate queues: Each bot has its own upload queue

Link Workspaces

When "Link" is checked, any file you drop into ONE workspace is automatically copied to ALL other open bot workspaces. Perfect for publishing the same files to multiple bots at once.

Keyboard Shortcuts

• Ctrl + A: Select all | Escape: Clear selections
• Delete: Remove selected | Double-click: Open file
• Arrow keys: Navigate | Enter: Open selected

Media Viewer

• Space: Play/pause | Left/Right: Prev/next file
• F: Fullscreen | +/-: Zoom
• S: Slideshow | Escape: Close

Right-Click Context Menu

• Delete, Show File Size, Show Total File Size
• Publish Now, Publish Video Only, Publish Images Only

System Tray & Background Operation

• Minimize to Tray: App continues running in background
• Tray Menu: Pause/resume uploads, restore window, quit
• Persistent Scheduling: Survives computer restarts
• Automatic Retry: Exponential backoff on failures
• Recovery on Startup: Recovers missed uploads

Rules Panel — Complete User Guide

Your automation control center for intelligent posting rules.

What the Rules Panel Does

• Rule Creation: Build custom rules for different content types
• Smart Scheduling: Natural language (e.g., "3 times a week at 8pm")
• File Type Filtering: Categorize and process different file types
• Source Folder Management: Monitor folders for new content
• Monitored Uploads (MU): Auto-detect and process files

Creating Your First Rule

1. Enter Rule Name
2. Select Source Folder (click "Browse")
3. Set File Filters (choose file types)
4. Configure Schedule (natural language or calendar)
5. Select Bot & Channel
6. Save Rule

Natural Language Scheduling

• Daily: "daily at 9am", "every day at 2pm"
• Weekly: "3 times a week at 8pm", "every Monday at 10am"
• Custom: "every 5 days at 2pm", "twice a week at 6pm"

Monitored Uploads (MU)

• Files added to monitored folders are automatically detected
• Matched against rules based on file type and folder
• Queued for upload according to rule schedules
• Work independently from drag & drop uploads

Universal Upload Folder Management

• Creates "Anbu Uploaded" folders with date stamps
• Moves uploaded files to prevent re-uploading
• Tracks multi-channel uploads, moves after ALL complete
• Excludes uploaded folders from future scans
• Toggle in Settings → General → Upload Settings

Status Panel — Complete User Guide

Everything you need to know about monitoring uploads

What the Status Panel Does

• Shows active uploads with live progress
• Lists failed uploads with retry controls
• Keeps a searchable history of all uploads
• Provides analytics for performance insights

Current Uploads

File name, status (Queued/Uploading/Processing), progress bar, channel/bot info.

Failed Uploads

Retry (re-queue), Cancel (remove), or View Details.

Upload History

Search by file name. Filter by date range, bot, or channel.

Analytics

• Total uploads (today / this week)
• Success rate vs failures
• Average upload time
• Per-bot and per-channel breakdowns

Filters & Search

• Bot → Channel → Status filtering
• Text search by file name
• Date range for history

Bots Panel — Complete User Guide

Everything you need to add, test, and manage bots

What the Bots Panel Does

• Bot Creation & Management: Add, edit, delete multiple bots
• Credential Storage: Securely store Telegram API credentials
• Connection Testing: Verify credentials before publishing
• Import/Export: Share configurations between installations
• Auto-Start: Bots start automatically when ANBU launches

Adding a New Bot

1. Configuration Tab → "Add New Bot"
2. Fill in Bot Name, API ID, API Hash
3. Optionally add description, enable Auto-Start
4. Test the connection
5. "Save Bot"

Channel Management

1. Select a bot
2. Enter Channel Details: Name, ID (-100xxxx or @username)
3. Enable Auto-Publish if desired
4. "Save Channel"

Auto-Publish Feature

• Enabled: Matched files skip "Pending" and upload immediately
• Disabled: Files wait for manual confirmation

Import/Export

• Export: Config tab → "Export Bot" → Save JSON
• Import: "Import Bot" → Select JSON → Review → Import

Security Best Practices

• Never share API IDs and Hashes publicly
• Test connections after credential changes
• Export configurations regularly as backups

Settings Panel — Complete User Guide

Configure ANBU: preferences, themes, security

General Settings

Language: English, Spanish, French, German, Chinese. Updates immediately.

Notifications: Upload, error, and system notifications.

Auto-Start: Start with Windows, Minimize to Tray, Background Operation.

Upload Settings:

• Concurrent Uploads: How many files upload simultaneously
• Retry Attempts: How many retries for failed uploads
• Upload Timeout: Max time per upload
• Allow Duplicates: Re-upload identical files when enabled

Themes

Visual customization. Applied immediately without restart.

Security

• Data Encryption: Encrypt stored credentials
• Session Timeout: 5–480 minutes of inactivity
• Auto-Lock: Lock after inactivity
• Key Rotation: Regular encryption key updates

About

Version number, build date, platform details, installation path.

AI Integration — Your Intelligent Assistant

Transform ANBU Push from a tool into a teammate.

The Concept

Say "Check if my uploads are done" or "Why did that video fail?" instead of clicking through menus. AI Integration connects ANBU Push to AI assistants (Claude, ChatGPT, Gemini) through a secure local protocol called MCP.

Real-World Examples

Set and forget: "Monitor my 50 files and alert me if any fail."

Troubleshoot: "Why did my last upload fail?" → AI checks logs and explains.

Manage: "List all bots and show which are inactive."

Capabilities

CAN: Read upload status, check bot connections, analyze errors, list channels/rules.

CANNOT: Delete files, see media content, change passwords or API keys.

Setup

1. Settings → AI Control (Beta)
2. Enable "MCP Server on port 9417"
3. "Copy MCP Config" → paste into your AI's config file
4. Restart your AI app

Connection is entirely local. No data sent to external servers.

BotFather and API Setup Guide

Step-by-step instructions for Telegram bot creation

Part 1: Creating Your Bot

1. Open Telegram → search "BotFather" (verified blue checkmark)
2. Click "Start" → send /newbot
3. Name your bot → choose username ending in "bot"
4. Copy the Bot Token — never share publicly!

Part 2: Getting API ID and Hash

1. Go to my.telegram.org
2. Log in → enter verification code
3. "API development tools" → "Create application"
4. Copy API ID and API Hash

Part 3: Adding Bot to a Channel

1. Channel settings → Administrators → Add Admin
2. Search your bot → grant Post/Edit/Delete permissions
3. Private channels: forward a message to @userinfobot for the -100... ID

Useful BotFather Commands

• /mybots — List bots | /token — Get token
• /revoke — Revoke token | /setdescription — Set description

Frequently Asked Questions

Getting Started

Q: I don't see any channels. What do I do?
A: Click "Configure" to add your first channel. Your bot must be an admin first.

Q: My bot can't post. Why?
A: Ensure it's an admin with "Post Messages" permission.

Q: Where do I get API ID and Hash?
A: my.telegram.org → "API development tools".

Uploading

Q: Multiple files at once?
A: Yes — hold Ctrl or drag multiple files.

Q: Upload entire folders?
A: Yes — drag folders in, system scans for media.

Q: Max file size?
A: 2GB (Telegram limit). Compress larger files.

Scheduling

Q: Schedule for different days?
A: Click Schedule → pick date → set time.

Q: Cancel a scheduled upload?
A: Upload Queue → find item → Cancel.

Q: Computer off during uploads?
A: Active uploads retry on restart. Scheduled uploads persist.

Rules

Q: Natural language schedules?
A: Yes — "daily at 6pm", "every Monday at 9am", "every 3 days at 8pm".

Rate Limits

Q: Why do uploads slow down?
A: Telegram limits ~20 msg/min per channel. ANBU auto-pauses and resumes.

Q: Per bot or per channel?
A: Per bot. One bot across 5 channels shares one limit.

Q: Speed up uploads?
A: Multiple bots. 3 bots = ~60 msg/min instead of ~20.

Q: Speed presets?
A: Aggressive (1s) — fast. Normal (3s) — recommended. Conservative (10s) — safest.

System

Q: Supported file types?
A: Images (JPG, PNG, GIF, WebP, BMP, TIFF), Videos (MP4, AVI, MOV, MKV, WebM, FLV, WMV), Audio (MP3, WAV, OGG, FLAC, AAC), Documents (PDF, DOC, TXT), Archives (ZIP, RAR, 7Z).

Q: System tray?
A: Minimizes to background. Right-click tray icon for controls.

Support & Feedback

Before Contacting Support

1. Check the FAQ
2. Review the documentation above
3. Check internet connection and bot credentials
4. Restart the application
5. Test with a small file

Contact

Community: ANBU Village

Support: anbu-dev@anbu-dev.com

Telegram: t.me/anbupush

When Reporting Issues

• Clear description of the problem
• Steps to reproduce
• Error messages received
• ANBU version (Settings → About)
• Windows version

Best Practices

• Start small: Test with one file first
• Check permissions: Bot must be admin
• Monitor the queue: Watch for issues
• Use rules: For regular content
• Keep ANBU running: For scheduled uploads