Sign in

Installation

How to install gGram on Android

gGram is installed as a file from ggram.xyz: it is not on Google Play or other stores. That is why Android asks more questions than usual. Below are all the steps in order, plus what is different on Xiaomi, realme and Samsung.

Download the app

Steps

  1. Download the file from ggram.xyz/download

    Open ggram.xyz/download on the phone that will run gGram and tap Download the app. Download only from ggram.xyz: do not install a file sent in a chat or from another site.

  2. Allow installs from the browser

    Open the downloaded ggram.apk. Android will say installs from this source are not allowed and offer to open settings: turn on Allow from this source for the browser (or for Files, if you open it from there) and go back.

  3. Get past the Play Protect warning

    Play Protect may show a window saying the app is unsafe or unverified. Tap Install anyway. If there is no such button, tap More details, then Install without scanning. Why this happens is explained below.

  4. Android 13 and newer: allow restricted settings

    Open Settings → Apps → gGram. Tap ⋮ in the top right corner and choose Allow restricted settings. Without it the gGram switch in Accessibility is grey. If the menu item is missing, first try to turn gGram on in Accessibility: Android shows a Restricted setting warning, and after that the item appears.

  5. Turn on Accessibility and the gGram keyboard

    Open gGram: the app walks you to the right screens step by step. Turn on the gGram service in Accessibility (it may be under Downloaded apps or Installed services) and the gGram keyboard in keyboard settings. Keep your own keyboard as the main one: the gGram keyboard is a fallback input method.

  6. Let gGram update itself

    In the gGram app open the Device screen, the App update card, and tap Allow installing updates: Android opens a setting, turn on Allow from this source for gGram and go back. You do this once. After that new versions install on their own on Android 12-15, with no windows; on Xiaomi, POCO and Redmi the Update window shows for a second and gGram taps it itself. If you skip this step, at the first update the phone shows a window saying it blocks installs from this source: tap Settings and turn on the same switch.

Next

The app asks for the rest itself: notification access and unrestricted battery. Keep this phone without a PIN, password or pattern screen lock: otherwise tasks wait until the phone is unlocked. Then sign in to the official Telegram on this phone and connect the phone to the dashboard with a QR code or a 6-digit code. Details are on the app page and in the docs.

App pageDocs: phones

Updating by hand on Xiaomi, POCO and Redmi

Once, if your gGram version is below 0.8.11

gGram versions before 0.8.11 cannot update themselves on Xiaomi, POCO and Redmi: MIUI and HyperOS do not let an app install an update without a window. The App update card then says Android did not install the update. You need to install the new version by hand once. Your data, the dashboard connection and the accounts are kept.

  1. Check the version: in gGram open the Device screen, the App update card. If it shows 0.8.11 or newer, there is nothing to do.
  2. Tap Stop in gGram so the phone does not take a new task.
  3. On this phone open ggram.xyz/download and tap Download the app.
  4. Open the downloaded ggram.apk and tap Update. Do not uninstall the old app or clear its data: the new version installs over it.
  5. If MIUI does not let you open the file, allow installs for the browser or File Manager: see the Xiaomi, POCO, Redmi block below. If a Play Protect window appears, see step 3 above.
  6. Open gGram and check the same card: the version must match the one on ggram.xyz/download. Make sure the gGram service in Accessibility is still on.
  7. In the dashboard press Resume.

After that updates install on their own: Android shows the Update window for a second and gGram taps it itself. For this the App update card must be in Auto mode and the gGram service in Accessibility must be on.

Download the new version

If you have Xiaomi, realme or Samsung

Manufacturers add their own restrictions on top of Android. Item names depend on the firmware version and may differ slightly.

Xiaomi, POCO, Redmi

MIUI and HyperOS

  • Installing: if MIUI says installs from unknown sources are blocked, open Settings → Privacy protection (or Apps) → Special permissions → External sources (on some versions it is called Install unknown apps) and allow it for the browser or File Manager.
  • If you install the file from a computer over a cable: in Settings → Additional settings → Developer options turn on Install via USB. MIUI may ask you to sign in to a Xiaomi account and insert a SIM card.
  • The MIUI scanner may offer to check the app before installing. This is a Xiaomi check, not Play Protect: you can wait for the result or skip it.
  • Autostart: Settings → Apps → Manage apps → the Autostart tile at the top of the screen → turn on gGram. On some versions the Autostart switch is also on the gGram app page. Without it MIUI may not let gGram start again after a reboot or memory cleanup.
  • Battery: in the same place, under Battery saver or Battery, choose No restrictions.
  • MIUI and HyperOS have restricted settings too: the item is in the ⋮ menu on the App info screen, as in step 4.

realme, OPPO

ColorOS and realme UI

  • Installing: allow installing unknown apps for the browser or Files. Usually this is Settings → Security or Privacy → Install unknown apps.
  • ColorOS may show its own check window before installing and ask you to wait a few seconds or confirm the install. Confirm it if the file came from ggram.xyz.
  • Background and autostart: Settings → Apps → gGram → Battery usage: allow background activity and auto launch.
  • You can lock gGram in the recent apps list so the system does not close it during cleanup.

Samsung

One UI

  • Installing: Settings → Apps → ⋮ → Special access → Install unknown apps, and allow it for the browser or My Files.
  • If Auto Blocker is on (Settings → Security and privacy), it blocks installs from outside the stores. Turn it off for the install, then you can turn it back on.
  • Accessibility: gGram is under Accessibility → Installed apps.
  • Battery: Settings → Apps → gGram → Battery → Unrestricted. In Device care → Battery → Background usage limits, check that gGram is not in the sleeping apps list.

Why Play Protect complains

gGram uses an Accessibility service, its own keyboard and notification access at the same time. The service is needed to open a chat in Telegram, type the text and tap Send. The keyboard is a fallback input method. From Telegram notifications gGram learns that a lead has replied.

Malware uses the same set of permissions, so Play Protect is suspicious of any app that has it and does not come from Google Play. The warning is about the set of permissions, not about a virus found in the file.

The warning may come back after a gGram update or during a regular phone scan. Whether to remove the app is your call. If you removed it, you can install it again from ggram.xyz/download.

Stuck on a step? Write to support@ggram.xyz: your phone model, Android version and the step where you stopped.