> For the complete documentation index, see [llms.txt](https://docs.phanes.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.phanes.bot/phanes/live-tweet-feed.md).

# Live Tweet Feed

Get a live alert in your group every time one of your followed X (Twitter) accounts posts.

### Enabling

1. Follow accounts with `/xfeed add` *(see below)*.

{% hint style="info" %}
`/xfeed` is **admin-only** and works **in groups** only.
{% endhint %}

### Commands

| Command              | What it does                                                    |
| -------------------- | --------------------------------------------------------------- |
| `/xfeed`             | List the accounts this group follows (with each one's settings) |
| `/xfeed add @handle` | Follow an account                                               |
| `/xfeed add a,b,c`   | Follow several at once                                          |
| `/xfeed del @handle` | Unfollow                                                        |
| `/xfeed del a,b,c`   | Unfollow several at once                                        |

* A handle can be given as `@handle`, `handle`, or a full profile link (`x.com/handle`).
* For multiple accounts, separate them with **commas and/or spaces**.
* Re-running `add` on an account you already follow **updates its settings**.
* Each group can follow up to **25 accounts**. A batch that would go over fills the remaining slots and reports which were skipped.

### What gets forwarded

| Tweet type      | Forwarded?                       |
| --------------- | -------------------------------- |
| Original tweets | ✅ Always                         |
| Quote tweets    | ⚙️ Optional — **off by default** |
| Retweets        | ⚙️ Optional — **off by default** |
| Replies         | ❌ Never                          |

By default, a followed account only sends its **original tweets**. Retweets and quote tweets are opt-in, per account.

### Retweet / quote flags

Add flags after the handle(s) to include retweets and/or quotes:

| Flag  | Effect                           |
| ----- | -------------------------------- |
| `+rt` | Include retweets                 |
| `+qt` | Include quote tweets             |
| `-rt` | Exclude retweets *(default)*     |
| `-qt` | Exclude quote tweets *(default)* |

Examples:

```
/xfeed add @elonmusk           → tweets only (default)
/xfeed add @elonmusk +qt       → tweets + quotes
/xfeed add @elonmusk +rt +qt   → tweets + retweets + quotes
/xfeed add a,b,c +rt           → all three: tweets + retweets
```

* In a batch, the flags apply to **every** account in that command.
* To give accounts different settings, run separate commands — or re-run `add` on a single account to change just that one.
* The `/xfeed` list shows each account's current setting, e.g. `@elonmusk · -RT +QT`.

### Finding accounts to add

Only **curated** accounts can be followed. Browse the full list at [**dapp.phanes.bot/x-accounts**](https://dapp.phanes.bot/x-accounts) — search, sort, and filter, then either:

* tap the **copy** icon on a card to copy that account's `/xfeed add` command, or
* tap **Select**, pick several accounts, and copy a single `/xfeed add a,b,c` command.

If you try to add an account that isn't tracked, you'll get an error with a link to the list.

### Requesting an account (Boost)

If you try to add an account that isn't tracked, you'll get an error with a link to the list — plus a **Boost this account** button.

1. Tapping it registers your request for that account.
2. Each person can boost an account **once**.
3. We review the most-requested accounts and add them to the feed.
4. Once an account is added, `/xfeed add @handle` works as normal.

Boosting is how you tell us what to prioritise — the more people who request an account, the sooner it gets added.

{% hint style="success" %}

* Changes take **up to a minute** to take effect.
* Phanes is not affiliated with and does not endorse any of the tracked accounts — their tweets are their own.
  {% endhint %}