Skip to content

weebzone/ForwardX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ForwardX Banner

Platform Made with Kotlin Made with Java License Made with ❀️

Auto-forward your Telegram messages β€” 24/7, on autopilot.

ForwardX is an Android app that automatically copies messages from one Telegram chat to another, using your own account. Its Free, Automatic, Filterable and Always ON

Download ForwardX

Latest stable APK β€’ Free β€’ No Ads

🧭 Quick Navigation


πŸ“Έ Screenshots

Login Home PowerOn Rules
Rule editor Logs Settings Stats

πŸ“² 1. Install: which APK do I download?

The app ships as a few different APK files β€” one per phone type. Pick just one:

APK file Pick this if…
app-arm64-v8a-release.apk βœ… You have a normal, modern phone (2017 or newer). Best choice for 95% of people β€” smallest download.
app-armeabi-v7a-release.apk You have an older / low-end 32-bit phone.
app-x86_64-release.apk You're running an Android emulator on a PC.
app-universal-release.apk Not sure which one you need? This works on every device (just a bit bigger).

πŸ€” Why so many files? Each phone chip needs slightly different internal code. Shipping the exact one your phone needs keeps the download small. When in doubt, grab universal β€” it always works.

To install: download the APK β†’ open it β†’ allow "Install from unknown sources" if Android asks β†’ tap Install. βœ…


πŸ”‘ 2. First-time setup

Step 2.1 β€” Allow two quick permissions

  • πŸ”” Notifications β€” required so Android lets the background service keep running.
  • πŸ”‹ Ignore battery optimization β€” stops Android from killing the app to "save battery." This is essential for reliable, non-stop forwarding.

Step 2.2 β€” Grab your Telegram API keys

ForwardX logs in as you, so Telegram needs your own personal API keys first.

  1. On a browser, visit my.telegram.org and log in with your phone number.
  2. Open "API development tools."
  3. Fill in the short form (App title: ForwardX, short name: forwardx, platform: Android β€” anything works here).
  4. You'll get an api_id (a number) and an api_hash (a long string of letters and numbers). Keep both handy.

Step 2.3 β€” Open the app and sign in

  1. Launch ForwardX β†’ paste your API ID and API Hash β†’ Continue.
  2. Enter your phone number with country code (e.g. +919876543210) β†’ Send code.
  3. Telegram sends a login code to your Telegram app β†’ type it in β†’ Verify.
  4. Have Two-Step Verification on? Enter your password β†’ Unlock.

πŸ”’ Your privacy: your credentials stay only on your phone. Nothing is ever uploaded anywhere.


🧩 3. The basics

Just three words to know:

  • πŸ“₯ Source β€” the chat you copy messages from (a channel, group, or even a private chat).
  • πŸ“€ Destination β€” the chat you send messages to. One rule can send to several destinations at once.
  • πŸ“œ Rule β€” the recipe connecting them: "from this source, forward messages matching these filters, to these destinations."

The main power switch: on the Home screen there's a big toggle.

  • ON β†’ forwarding is live (a small notification shows the app is running).
  • OFF β†’ nothing gets forwarded.

πŸ’‘ Tip: you can build rules while forwarding is off, then flip the switch on once you're ready.


πŸ› οΈ 4. Making your first rule

Let's forward everything from a channel called "Movies HD" into your own "My Backup" channel:

  1. Go to the Rules tab β†’ tap βž•.
  2. Rule name: give it something memorable, like Movies backup.
  3. From: tap it, pick Movies HD.
  4. To: tap it, pick My Backup (you can add more destinations here too).
  5. Leave everything else as-is for now.
  6. Tap Save rule.
  7. Go to Home and flip the main toggle ON.

πŸŽ‰ That's it! New posts in Movies HD now land in My Backup automatically.

⚠️ A rule only saves once it has a name, a source, and at least one destination.

Want to change it later? Rules tab β†’ tap the rule. Want to try it safely first? Use the Test πŸ§ͺ button on the rule β€” nothing gets sent.


πŸ“‹ 5. Every rule field explained

Fields are grouped into sections inside the rule editor. You really only need the first three (Name, From, To) β€” everything below is optional fine-tuning.

5.1 β€” Route (From / To)

  • From: the source chat (required).
  • To: one or more destinations (at least one required).

πŸ“ Example: From = Anime Uploads, To = My Anime and Backup Drive Channel β†’ every match goes to both.

5.2 β€” Priority & Exclusive stop

  • Priority (0–100): when several rules watch the same source, higher numbers get checked first.
  • Exclusive stop: if this rule matches, stop β€” don't let lower-priority rules also grab the message.

πŸ’‘ A file can match multiple rules. Priority + Exclusive stop lets you send each message to exactly one place. See the category routing example.

5.3 β€” Copy mode

  • Off (default) β€” a normal Telegram forward (shows "Forwarded from…").
  • On β€” re-sends as a fresh copy, no "Forwarded from" tag.

⚠️ Caption edits (Section 5.9) only work when Copy mode is ON, since cleaning a caption means re-sending the message.

5.4 β€” Message types (media filter)

Choose exactly what this rule should forward: ALL Β· TEXT ONLY Β· MEDIA ONLY Β· PHOTOS Β· VIDEOS Β· DOCUMENTS Β· AUDIO Β· VOICE

πŸ“ Example: set to VIDEOS to skip text chatter and photos, and forward only video posts.

5.5 β€” Content category (auto-detected)

Automatically detects each file's type and forwards only the categories you pick β€” full details in Section 6. Leave everything off to allow any type.

  • Must match ALL selected:
    • ON β†’ the file must match every selected category (e.g. Movie + Split = only split movies).
    • OFF β†’ the file can match any one of them (e.g. Movie or Split).

5.6 β€” Sender filter

Forward messages only from certain senders:

  • Any (default)
  • Specific users β€” only listed user IDs
  • Admins β€” only chat admins
  • Anonymous admins β€” messages posted "as the channel"
  • Verified β€” only blue-tick verified accounts

πŸ“ Example: in a busy group, set to Admins so only staff posts get forwarded.

5.7 β€” Keyword filters (matched against caption/text)

  • Only if contains β€” forward only when the caption has one of these (comma = "any of").
    • πŸ“ 1080p, 2160p, 4k β†’ forwards posts mentioning any of those.
  • Skip if contains β€” block the message if it contains any of these.
    • πŸ“ sample, trailer, hdcam β†’ skips samples, trailers, hdcam.
  • Regex toggle β€” treat the box as one regular expression (| for alternatives).
    • πŸ“ S\d{2}E\d{2} β†’ only posts with an S01E02-style tag.
  • Case sensitive / Whole word only β€” fine-tunes non-regex matching.

5.8 β€” File filters (matched against the filename)

  • Min MB / Max MB β€” only forward files in a size range (e.g. Min 100 skips tiny junk/sample files).
  • Filename contains (comma = any) β€” e.g. 1080p, x265.
  • Ends with (comma = any) β€” e.g. .mkv, .mp4 β†’ only those extensions.
  • Regex (| = multiple) β€” e.g. S\d{2}E\d{2}\.mkv$.

ℹ️ All filled-in file filters must pass together (AND). Empty ones are simply ignored.

5.9 β€” Caption edits (needs Copy mode ON)

Clean up messy captions before sending:

  • ⭐ Clean filename caption β€” the smart one. Strips links, @usernames, #hashtags, emojis, and decorative symbols, then trims everything after the file extension (keeping a .001 split suffix if present).
    • Before:
      🎬 Tuck Jagadish (2021) 1080p WEB-DL.mkv
      ━━━━━━━━━━━
      πŸ“₯ via @SomeBot   πŸ”— https://t.me/somechannel
      #Bollywood #Movies
      
    • After: Tuck Jagadish (2021) 1080p WEB-DL.mkv
  • Remove links / @usernames / #hashtags / emojis β€” individual strippers, if you don't want the full trim above.
  • Prepend / header β€” text added at the top, e.g. 🎬 New upload:.
  • Append / footer β€” text added at the bottom, e.g. Join @MyChannel.
  • Find & replace β€” custom text swaps, with optional regex / case-sensitivity per row.

5.10 β€” Schedule

Only forward within a chosen time window and set of days.

πŸ“ Example: 22:00 β†’ 06:00, Mon–Fri β†’ forwards only overnight on weekdays. (Overnight windows crossing midnight are supported.)

5.11 β€” Delivery & sync

  • Delay before forwarding (0–120s) β€” wait before sending each match (adds to the global delay in Settings).
  • Max retries on failure (0–10) β€” how many times to retry a failed send.
  • Sync edits β€” if the original message is edited, update the forwarded copy too.
  • Sync deletes β€” if the original is deleted, delete the forwarded copy too.

🎬 6. Auto content categories

ForwardX reads each file's caption first, then its filename, and auto-tags it β€” no manual keyword typing needed.

6.1 β€” Movie 🎬

A single film β€” detected by a release year or a standalone video/document with no episode markers.

Tuck Jagadish (2021) 1080p WEB-DL.mkv
Inception.2010.BluRay.x264.mkv
Interstellar 2014 2160p HDR.mkv

6.2 β€” TV Show πŸ“Ί

Episodic content with an S01E05, 1x05, or "Season + Episode" marker.

Loki S01E05 1080p.mkv
The Office 1x05.mkv
Breaking Bad Season 2 Episode 3.mkv

6.3 β€” Combined πŸ“¦

A multi-episode pack β€” episode ranges, or "complete / batch" whole-season packs.

Loki S01 E01-E06.mkv
One Piece Complete Season 1.mkv
Attack on Titan S04 Batch.zip
EP01 to EP12 720p

6.4 β€” Split βœ‚οΈ

A multi-part upload β€” split file parts.

BigMovie.2021.1080p.mkv.001
Season.Pack.7z.002
film.part1.rar
Movie.cd2.avi

πŸ”€ A file can be several categories at once. Example: Loki S01 E01-E06.mkv.001 is TV Show + Combined + Split, all together.

6.5 β€” Routing each category to its own channel

Since one file can match multiple categories, combine Priority + Exclusive stop so each file lands in exactly one place. Recommended setup (highest priority first), all with Exclusive stop ON and Must match ALL ON:

Priority Rule (categories) Destination
60 Combined + Split + TV Show Combined-Split-Series channel
50 Combined + TV Show Combined-Series channel
40 Split + TV Show Split-Series channel
30 TV Show Series channel
20 Split + Movie Split-Movies channel
10 Movie Movies channel

This exact setup is available as a ready-to-import recipe β€” see Section 10.

πŸ“ Worked example: a post Loki S01 E01-E06.mkv is detected as TV Show + Combined β†’ matches the priority-50 rule first (Exclusive stop) β†’ goes only to the Combined-Series channel.


βͺ 7. Backfill

Normally ForwardX only forwards new messages. Backfill sends the messages that already exist in a channel's history β€” perfect for when you set up a rule after the content was posted.

Open it: Rules tab β†’ Backfill (top right).

7.1 β€” How it works

It scans the source once and runs every historical message through all the rules for that source β€” so it obeys the exact same filters and category routing as live forwarding.

7.2 β€” Options

  • Source channel β€” pick which source to import (only sources with at least one enabled rule are listed). A 🏷️ badge means that source routes by category.
  • Range β€” how much history to import:
    • All messages β€” the entire history.
    • Last N messages β€” the newest N (slider, 50–5000).
    • New messages only β€” just the messages posted since your last completed backfill of this source. It's fast because it skips re-scanning the whole history β€” perfect for a quick "top up" after you've already imported once.
    • Message range β€” a precise slice using message links/numbers:
      • From message (optional) β€” start here (blank = oldest).
      • To message (optional) β€” stop here (blank = latest).
      • Get a message link: in Telegram, long-press a message β†’ Copy Link (or just note its number).
      • πŸ“ From .../1200, To blank β†’ message 1200 onward. From blank, To .../5000 β†’ everything up to 5000. Both filled β†’ just that slice.
  • Order β€” Oldest first (recommended, keeps original order) or Newest first.
  • Preview matches β€” a dry run showing how many messages would forward vs. be skipped, before anything is sent.
  • Start backfill β€” begins the run, with a live progress bar, Forwarded / Skipped / Failed counts, and an ETA. A notification keeps it going even if you leave the screen.

7.3 β€” Pause, Stop & Resume

  • Pause / Resume β€” temporarily halt and continue.
  • Stop β€” ends the run but saves your place.
  • Resume later β€” reopen Backfill for the same source β†’ a "Resume available" banner appears β†’ tap Resume to continue exactly where you left off (or Start over to restart). Already-forwarded messages are auto-skipped, so nothing is ever sent twice.

🐒 Backfilling a huge channel sends a lot of messages, paced by the anti-flood setting (Section 8) to keep your account safe β€” big imports simply take a while.

7.4 β€” Catch up on messages missed while offline

Live forwarding only works while ForwardX is actually running. So if your phone was switched off, the app was closed, or you lost internet, any messages posted during that gap were never forwarded β€” they slip through the cracks. ForwardX can fill that gap for you in two ways:

  • 🟒 Automatically β€” turn on Auto catch-up on startup in Settings. Every time the app reopens and reconnects, it checks how far behind it is and quietly forwards just the messages you missed, then carries on live. (It only runs when the main power switch is ON.)
  • πŸ‘† Manually β€” when auto catch-up is off, a "Catch up on missed messages" card appears on the Home screen whenever there's a gap. One tap forwards the missed messages. (The card hides itself while a catch-up or backfill is already running, so it never gets in the way.)

Behind the scenes this is simply a "New messages only" backfill (Section 7.2), so it's quick β€” and thanks to duplicate protection, it never re-sends anything you already have.

πŸ”” You'll know when it's done: whenever a backfill or catch-up finishes, ForwardX posts a notification with the result (e.g. "1,240 forwarded Β· 88 skipped Β· 3 failed") β€” so you don't have to sit and watch a long import.


βš™οΈ 8. The Settings page

Setting What it does
πŸ” Start on boot Automatically resumes forwarding after your phone restarts β€” you don't have to open the app. (Just opening the app also resumes forwarding on its own.)
πŸ“₯ Auto catch-up on startup When the app starts and reconnects, automatically forwards anything posted in your sources while it was offline, then continues live (see Section 7.4). Off by default. Runs only when the main power switch is ON.
πŸ›‘οΈ Duplicate protection Never forwards the same message twice (survives restarts). Scope: Per rule (default) or Per destination (skip if it already reached that destination via any rule β€” great when several sources feed one channel).
🐒 Min send interval Minimum gap between two sends. Higher = safer from Telegram rate limits. Start around 1200 ms, raise for big backfills.
⏱️ Global delay Extra pause added before every send, on top of each rule's own delay.
🎨 Theme System / Light / Dark.
πŸ’Ύ Export / Import rules Back up all rules to a JSON file, or load rules from a file β€” this is how you use the recipes.
πŸšͺ Log out Disconnects your Telegram session and returns to the login screen.
ℹ️ About Credits and links to other projects.

Other screens: πŸ“„ Logs shows every forward/skip/failure with the reason. πŸ“Š Stats shows per-rule totals.

🧠 Why anti-flood matter: Telegram limits how fast an account can send. Too fast triggers a temporary "FLOOD_WAIT," or worst case, a ban. ForwardX funnels all sends through one paced queue to stay under the limit β€” that's why sends are spaced out on purpose.


πŸ”„ 9. Always-on: every situation explained

Confused about what forwards, when, and why? It all comes down to 3 switches and 2 ways a message gets delivered.

The 3 switches

Switch Where What it does
πŸ”˜ Power button Home The master ON/OFF. Nothing forwards unless this is ON.
πŸ” Start on boot Settings After the phone restarts, turns the power back on by itself.
πŸ“₯ Auto catch-up Settings After being offline, automatically forwards the messages that were missed.

The 2 ways a message reaches the destination

  • ⚑ Live β€” forwarded the instant it's posted β€” but only while ForwardX's background worker is alive.
  • βͺ Catch-up β€” forwards messages missed while the worker wasn't alive (automatically, or by tapping the Home card).

πŸ† The one golden rule: messages forward only while the background worker is alive. Everything else is just about (a) keeping it alive and (b) filling the gaps from when it wasn't. The worker keeps running even when you swipe the app away β€” it only dies when the phone turns off or Android kills it to save battery.

Every situation β€” you post a file in the source

When the Power button is ON:

Situation Worker alive? The file… When you reopen the app
App open, you're using it βœ… forwarded instantly (live) nothing to do
You swipe the app away βœ… (it survives) forwarded instantly (live) nothing to do
Android killed it in the background ❌ missed during the dead time forwarding resumes β†’ Auto catch-up ON: sent automatically Β· OFF: tap the catch-up card
Phone powered off / restarted ❌ missed while off see "After a restart" below

When the Power button is OFF: nothing is forwarded at all, in any situation β€” and catch-up won't run either (it needs Power ON).

After a phone restart

Start on boot What happens
ON Forwarding turns itself back on automatically β€” no need to open the app.
OFF Forwarding stays off until you open the app (opening it turns forwarding back on).

Then, once forwarding is back on:

Auto catch-up The files missed while the phone was off…
ON get forwarded automatically.
OFF wait for you β€” the catch-up card appears on Home; tap it to send them.

⚠️ Start on boot only does something if the power was ON before the phone turned off. If you'd already turned forwarding off, it stays off after a reboot.

βœ… The simple recommendation

For truly hands-free, never-miss-anything forwarding, turn on all three:

Power ON + Start on boot ON + Auto catch-up ON

That way, after any reboot or background-kill, ForwardX restarts itself, forwards anything it missed, and keeps going β€” you never have to touch it. And if you ever open the app and see no catch-up card, that means nothing was missed. 🎯


🍱 10. Ready-made rule recipes

Import these to get started fast: Settings β†’ Import rules β†’ paste the JSON (or load the file). After importing, open each rule and set its From/To β€” recipes ship with placeholders since only you know your channel IDs.

Recipe What it does
simple-mirror.json Forwards everything from one chat to another.
movies-clean-captions.json Forwards only movies, in copy mode, with fully cleaned captions.
keyword-and-schedule.json Only 1080p/4k videos over 100 MB, skips samples/ads, overnight only.
media-routing-rules.json The full 6-category routing set (Movies, Split Movies, TV, Split TV, Combined TV, Combined Split TV) with priority + exclusive-stop.

Category values for JSON: "MOVIE", "TV_SHOW", "COMBINED", "SPLIT" Media types: "ALL", "TEXT_ONLY", "MEDIA_ONLY", "PHOTOS", "VIDEOS", "DOCUMENTS", "AUDIO", "VOICE" File sizes are in bytes (100 MB = 104857600). Schedule times are minutes from midnight (1320 = 22:00). scheduleDaysMask is a bitmask (127 = every day).


πŸ†˜ 11. Tips, safety & troubleshooting

  • βœ… Keep forwarding reliable: grant the battery-optimization exemption, enable Start on boot, and turn on Auto catch-up on startup so anything missed during downtime is forwarded automatically.
  • 🚫 Avoid bans: don't set the send interval too low. For big backfills, raise Min send interval first.
  • ♾️ "Connecting…" won't go away? Make sure you're logged in and online β€” a fresh login walks through phone β†’ code β†’ (password).
  • πŸ” Nothing is forwarding? Check: the Home toggle is ON, the rule is enabled, the source matches where messages actually arrive, and filters aren't too strict. Use Test or Preview β€” the Logs screen shows the exact reason.
  • βœ‚οΈ Caption not cleaned? Caption edits only apply in Copy mode.
  • πŸ”’ Protected ("no-save") channels: messages Telegram blocks from saving can't be forwarded or copied, and are skipped automatically.
  • πŸ—‚οΈ Your data: everything (session, rules, credentials) stays on your device β€” nothing is uploaded anywhere.

Made with ❀️ by Karan (Weebzone)

About

ForwardX is an Android app that automatically copies messages from one Telegram chat to another, using your own account. Its Free, Automatic, Filterable and Always ON

Topics

Resources

License

Stars

15 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors