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

# Overview

> Announce new videos, posts, pins, tracks and streams from seven platforms.

`/social add` follows a creator and posts their new activity in a channel. Follow management needs
**Manage Server**; `view` and `list` are open to everyone.

## Commands

```text theme={null}
/social add platform:YouTube account:@GoogleDevelopers channel:#updates role:@Subscribers
/social view
/social list
/social refresh [creator]
/social remove <creator>
```

Everything works under the prefix too, with per-platform shorthands:

```text theme={null}
,social add YouTube @GoogleDevelopers #updates @Subscribers
,youtube add @GoogleDevelopers #updates
,twitter add @handle #updates
,kick add xqc #updates
,soundcloud latest post gunna
,twitter latest post handle
```

On its own, `,kick` still kicks a member · `,kick add` is the follow.

## Platforms

| Platform | Follow with | Posts | Page |
| - | - | - | - |
| YouTube | `@handle` or channel link | Videos and Shorts | [YouTube](https://docs.criminal.work/features/social/youtube.md) |
| Reddit | `r/name`, `u/name` or profile link | Posts and user activity | [Reddit](https://docs.criminal.work/features/social/reddit.md) |
| X (Twitter) | `@handle` or link | Tweets and quote tweets | [X](https://docs.criminal.work/features/social/x.md) |
| Twitch | Username or link | Live alerts | [Twitch](https://docs.criminal.work/features/social/twitch.md) |
| Kick | Username or link | Live alerts | [Kick](https://docs.criminal.work/features/social/kick.md) |
| SoundCloud | Username or profile link | New tracks | [SoundCloud](https://docs.criminal.work/features/social/soundcloud.md) |
| Pinterest | Username or profile link | New pins | [Pinterest](https://docs.criminal.work/features/social/pinterest.md) |

## Delivery rules

* Only activity posted **after** you follow is announced.
* Each post is announced once, even across restarts.
* After downtime, the newest **three** missed items are posted instead of a flood.
* Accounts are checked every 2–10 minutes per platform; an account followed by many servers is
  fetched once.
* A server can follow up to **30** accounts.
* `/social refresh` checks immediately and can be used once every 30 seconds per follow.

**Role pings are opt-in**

Set `role:@Subscribers` on a follow and only that role is pinged. Leave it off and posts arrive
silently.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.