> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mira.party/llms.txt
> Use this file to discover all available pages before exploring further.

# Social feeds

> Get notified in Discord when someone posts, streams or goes live on another platform.

Every platform uses the same command shape, so learning one teaches you all of them.

```javascript theme={null}
!<platform> add <channel> <username>
```

Requires **Manage Channels**.

<CodeGroup>
  ```javascript TikTok posts theme={null}
  !tiktok add #feed someone
  ```

  ```javascript Twitch streams theme={null}
  !twitch add #live someone
  ```

  ```javascript Instagram stories theme={null}
  !instagram add #feed someone
  ```

  ```javascript A subreddit theme={null}
  !reddit add #feed askreddit
  ```
</CodeGroup>

## Platforms

| Platform    | Command      | Aliases           | Delivers                                  |
| ----------- | ------------ | ----------------- | ----------------------------------------- |
| TikTok      | `tiktok`     | `tt`              | Posts, stories, lives, reposts            |
| Instagram   | `instagram`  | `insta`, `ig`     | Stories, posts, lives, broadcast channels |
| Twitter / X | `twitter`    | `twt`, `tw`, `x`  | Tweets, retweets, replies, quotes, topics |
| YouTube     | `youtube`    | `yt`              | New videos                                |
| Twitch      | `twitch`     | `ttv`             | Going live                                |
| Kick        | `kick`       | —                 | Going live                                |
| Reddit      | `reddit`     | `subreddit`, `r/` | New submissions                           |
| Snapchat    | `snapchat`   | `snap`            | Stories                                   |
| SoundCloud  | `soundcloud` | `sc`              | New releases                              |
| Tumblr      | `tumblr`     | `tmblr`, `blog`   | New posts                                 |
| Pinterest   | `pinterest`  | `pint`, `pin`     | New or previous pins                      |

## The shared commands

Every platform supports these:

<CodeGroup>
  ```javascript Add a feed theme={null}
  !tiktok add #feed someone
  ```

  ```javascript Remove one theme={null}
  !tiktok remove #feed someone
  ```

  ```javascript See what's monitored theme={null}
  !tiktok list
  ```

  ```javascript Ping a role theme={null}
  !tiktok role #feed someone @TikTok
  ```

  ```javascript Move everything to another channel theme={null}
  !tiktok migrate #old #new
  ```

  ```javascript Clear a channel's feeds theme={null}
  !tiktok clear #feed
  ```

  ```javascript Clear every feed theme={null}
  !tiktok clear
  ```
</CodeGroup>

Aliases: `watch`, `feed` for `add`; `delete`, `del`, `rm` for `remove`; `ls` for `list`; `mention`, `ping` for `role`; `transfer`, `move` for `migrate`.

### Custom webhooks

Most platforms let notifications go through your own webhook, so they appear under a name and avatar you choose rather than the bot's:

```javascript theme={null}
!tiktok webhook #feed someone
!tiktok webhook remove #feed someone
```

Available on TikTok, Instagram, Twitter, YouTube, Twitch, Kick, SoundCloud and Tumblr. Alias: `hook`.

<Tip>
  Set the webhook's name and avatar to match the creator and the feed reads as if they're posting into your server directly. Create one with `!webhook create #feed name`, then point the feed at it.
</Tip>

## Per-platform extras

<AccordionGroup>
  <Accordion title="TikTok" icon="music">
    ```javascript theme={null}
    !tiktok lives #feed someone on
    !tiktok reposts #feed someone on
    ```

    Live notifications, repost notifications, and early comment relaying. `!tiktok add` also takes options for these up front.

    Lookups: `!tiktok someone`, `!tiktok story someone`, `!tiktok hashtag fyp`.
  </Accordion>

  <Accordion title="Instagram" icon="instagram">
    ```javascript theme={null}
    !instagram lives #feed someone on
    !instagram broadcasts #feed someone on
    ```

    `lives` covers live notifications and automatic recording; `broadcasts` covers Instagram's broadcast channels.

    Lookups: `!instagram someone`, `!instagram story someone`, `!instagram highlights someone`, `!instagram recent someone`.

    Recording a live manually: `!instagram record someone`, then `!instagram record stop`.
  </Accordion>

  <Accordion title="Twitter / X" icon="twitter">
    ```javascript theme={null}
    !twitter retweets #feed someone on
    !twitter replies #feed someone on
    !twitter quotes #feed someone on
    ```

    Each content type is opt-in — by default you get original tweets only.

    **Topic feeds** follow a search query rather than an account:

    ```javascript theme={null}
    !twitter timeline add #feed "some topic"
    !twitter timeline preview "some topic"
    !twitter timeline role @News "some topic"
    !twitter timeline list
    ```

    Branding: `!twitter branding #feed x` switches between Twitter and X styling, per feed or server-wide.
  </Accordion>

  <Accordion title="Twitch and Kick" icon="twitch">
    Both notify when a streamer goes live, with the title, game and viewer count.

    ```javascript theme={null}
    !twitch add #live someone
    !twitch role #live someone @Live
    !kick add #live someone
    ```

    For a channel *name* that reflects live status, see [social counters](/setup/counters#social-counters).
  </Accordion>

  <Accordion title="SoundCloud" icon="soundcloud">
    Beyond feeds, useful lookups:

    ```javascript theme={null}
    !soundcloud some track
    !soundcloud file some track
    !soundcloud cover some track
    !soundcloud original some track
    ```

    `file` downloads the track, `cover` grabs the artwork, `original` gets the uploaded filename.
  </Accordion>

  <Accordion title="Reddit" icon="reddit">
    ```javascript theme={null}
    !reddit add #feed askreddit
    !reddit role #feed askreddit @Reddit
    ```

    Feeds follow **subreddits**, not users. `!reddit askreddit` looks one up.
  </Accordion>
</AccordionGroup>

## Managing everything at once

```javascript theme={null}
!feeds
```

Every social feed in the server, across all platforms. Requires **Manage Server**. Aliases: `socialfeeds`, `sf`.

The three presentation toggles apply to all feeds:

```javascript theme={null}
!feeds merge on
!feeds minimal on
!feeds relative on
```

| Setting    | Effect                                   |
| ---------- | ---------------------------------------- |
| `merge`    | Combine a post's audio into its photos   |
| `minimal`  | Compact notifications with less metadata |
| `relative` | "2 hours ago" instead of a date          |

## Things worth knowing

* Private accounts can't be monitored. If an account goes private, its feed stops silently.
* A deleted post won't be un-posted from Discord, so you can archive content with ease.

## Related

* [Reposter](/social/reposter) — re-upload links people paste
* [Lookups](/social/lookups) — one-off profile lookups
* [Pinterest](/social/pinterest) — pin feeds and avatar feeds
* [Counters](/setup/counters#social-counters) — follower counts as channel names