Ghost Mode

<p align="center">
  <img src="images/icon.svg" width="128" height="128" alt="Ghost Mode icon">
</p>

<h1 align="center">Ghost Mode</h1>

**TL;DR:** AyuGram's ghost mode as an [exteraGram](https://exteragram.app) plugin: read,
browse and type without anyone seeing it. You can set every option globally, per account
and per chat.

## Description

Ghost Mode stops the app from sending the signals that give you away: read receipts, story
views, typing statuses and your online status. It also adds AyuGram's companion options:
read on interact, scheduled sending and silent sending. Nothing is sent and nothing changes
until you turn something on.

Every option works on three levels, and the most specific one with a value wins:

1. **Chat**: open a chat or profile, tap ⋮ → *Ghost mode*.
2. **Account**: plugin settings → *Accounts* → pick an account.
3. **Global**: the switches on the plugin's main settings page.

So you can stay a ghost everywhere except in one chat, or only on a second account. A forum
(a group with topics) is one chat: its settings cover every topic, and there's nothing per
topic.

## Features

**Ghost essentials** (the *Ghost mode* switch turns all five on or off)

- **Don't read messages.** Read receipts aren't sent. Chats still look read on your side.
- **Don't read stories.** Story views aren't sent.
- **Don't send online.** Your online status is sent as offline. *Account level only.*
- **Don't send typing.** Typing, recording and uploading statuses aren't sent.
- **Go offline automatically.** Every online status is followed straight away by an
  offline one. *Account level only.*

**Options**

- **Read on interact** (on by default). Sending a message to a chat where messages aren't
  read marks that chat as read, as AyuGram does.
- **Use scheduled messages.** Messages and forwards are scheduled 12 seconds ahead (media
  gets more time to upload). Telegram's servers then deliver them, so sending doesn't put you
  online. Secret chats, bots and Saved Messages are never scheduled.
- **Send without sound.** Messages and forwards are sent silently.

**In the app**

- Chat and profile ⋮ menu → **Ghost mode**: this chat's options. Each one shows its value
  and whether it comes from the chat, the account or the global settings. Tapping an option
  cycles *Default → On → Off*. The menu also has a ghost toggle for the chat, *Read all
  messages now* and a reset.
- Message menu → **Read until here**: sends a read receipt up to that message.
- Side menu → **Ghost mode**: the options of the account in use. It has the same list and
  *Global → On → Off* cycling as its settings page, plus a ghost toggle and a reset.
- Plugin settings → **Accounts**: each account's options (*Global / On / Off*) and its list
  of chat exceptions.

## Documentation

- [How Ghost Mode works](docs/how-it-works.md): what is intercepted, how settings resolve,
  runtime notes
- [Development](docs/development.md): getting started, repo layout, building and verifying, icon export
- [How exteraGram plugins work](docs/how-plugins-work.md): the plugin format and lifecycle
- [Device setup and ADB automation](docs/device-and-adb.md): deploy, watch, logs, debugger
- [Versioning and releases](docs/versioning-and-releases.md): git hooks, auto-bump, CI publishing
- [SDK notes](docs/sdk-notes.md): condensed exteraGram SDK API surface

## Credits

Ghost mode's behaviour follows [AyuGram](https://github.com/AyuGram/AyuGram4A) by Radolyn.