GramForge Documentation

GramForge ships as a self-contained executable. No Python installation or additional setup is required.

Installation

1. Download the latest release for your platform (Windows / macOS / Linux).
2. Run the executable. GramForge will start a local server and open the UI automatically in your default browser at http://localhost:8000.
3. Import accounts — click Upload Session in the Account Manager to add your .session files or tdata archives.
4. Run a spam check on all accounts to see their current Telegram status before starting any operations.

Importing sessions

GramForge supports two import formats:

The Account Manager is the central hub for all your Telegram sessions. It shows every imported account with its live status, geo, role, folder, and metadata.

Account statuses

Folders

Accounts are organized into three folders: Work (active), Archive (inactive), and Banned (auto-moved on ban detection). You can reassign any account to a different folder manually from the account table.

Roles

Roles are custom tags (e.g. "Sender", "Parser", "Reserve") that you create in the Roles section. Each account can be assigned one role. Modules support filtering by role so you can quickly select the right set of accounts for each task.

Account actions

Right-click or use the row action menu to: check spam status, open the account in a built-in Telegram Web browser, edit metadata (note, geo, age), move to a folder, or delete the session.

Broadcast lets you send a message (or series of messages) from selected accounts to a list of chats. It supports texts, images, videos, voice messages, and video circles.

Message types

Target modes

• Folders — broadcast to all dialogs inside a Telegram folder of the sending account.
• Groups — broadcast to public groups from an automated list (group automation).
• Spam list — broadcast to a custom list of usernames / group links imported from a file.

Key settings

Warmup simulates organic Telegram activity on your accounts — reactions, comments, joins, message sends — to build up account history and reduce spam-block risk on new sessions.

Actions

Delay configuration

Each action type has its own independent delay range. Enable or disable per-action delays to fine-tune the pacing. Reaction delays are separate from join delays to allow faster channel joining without triggering rate limits.

Cheat provides metric-boosting tools. Unlike Warmup (which runs continuously), Cheat operations run once against a specific target.

Sub-modes

Each sub-mode supports a configurable inter-action delay and can target either a specific URL or the N most recent posts in a channel.

Parsing extracts data from Telegram channels and groups and saves it as a .csv file for use in Inviter, Broadcast, or external tools.

Parse modes

Filtering options

• Date range filter for messages.
• Deduplicate members across multiple parsed sources.
• Skip bots / deleted accounts from member lists.
• Filter by activity (only users who posted recently).

Results are shown in-app as a scrollable table and can be exported to CSV with one click. The CSV is compatible with the Inviter module's file import.

The Inviter module adds users from a list (typically a CSV from Parsing) into a Telegram group or channel.

Invite modes

Key settings

Auto-Reply monitors incoming private messages on selected accounts and sends automatic responses. Useful for managing funnels, bots, or accounts that receive high message volume.

Reply types

Rules

You can configure trigger rules — reply only when the incoming message contains a specific keyword, or reply to any message. Multiple rules can be stacked per account group.

AI Voice Clips

For AI mode, you can also provide a library of voice clips. When the AI determines a voice reply is appropriate, it picks a clip from the library instead of sending text.

The Stories module posts a photo or video story to selected accounts simultaneously.

How to use

1. Select the accounts you want to post from.
2. Upload a photo (JPG/PNG) or video (MP4) in the media upload area. A preview appears immediately.
3. Optionally add a caption.
4. Click Post Stories. GramForge sends the story from each selected account in sequence with a small delay.

Results are logged in the console panel with per-account success/fail status.

Copy Channel mirrors posts from one or more source channels into your own channel automatically, in real-time or on a schedule.

How it works

• Configure a source channel (link or username) and a destination channel (must be owned by one of your accounts).
• The copying account must be an admin of the destination channel with post permissions.
• New posts in the source channel are forwarded (or re-uploaded) to the destination within seconds.
• Optional: strip original channel signature, prepend/append custom text to captions.

History view

The History tab shows a galaxy-style visualisation of all past copy sessions — accounts as nodes, channels as edges — with per-session stats (total posts copied, errors).

Roles allow you to categorize accounts for quick selection across all modules. A role is a simple label (e.g. "Warmer", "Sender", "Parser") that you assign to one or more accounts.

Working with roles

• Create roles in Settings → Roles.
• Assign a role to an account from the Account Manager row actions or in bulk via Bulk Actions.
• In every module, use the Role Picker dropdown to instantly select all accounts with a given role.

Account metadata fields

The Tools section bundles several system-level utilities.

Proxy management

Assign SOCKS5 or HTTP proxies to individual accounts or account groups. GramForge routes all Telegram API traffic for that account through the configured proxy. Proxies are stored per-session and persist across restarts.

Account customization

Bulk-update profile fields across selected accounts: first name, last name, bio, and profile photo. Supports spintax in text fields for per-account variation.

Cleanup

Mass-leave channels and groups from selected accounts. Useful for recycling accounts after a campaign without manually clearing each session's dialogs.

Browser

Open any account in a built-in Telegram Web browser window. The account's session is used directly — no QR scan or phone number needed. Click the browser icon in the Account Manager row to launch.

The Cron module lets you schedule any module task to run at a specific time or on a repeating interval without keeping the UI open.

Creating a scheduled task

1. Configure the task in its module (e.g. Broadcast) as you normally would.
2. Instead of clicking Start, click Schedule to open the Cron dialog.
3. Set the date/time and optionally a repeat interval.
4. Save the cron job. It will appear in the Scheduler tab.

GramForge's background server handles scheduled tasks — the UI does not need to remain open for cron jobs to fire.

GramForge is designed as a local-only application. Here is how your data is protected: