Social Media Tracker - kabiiQ/FBK GitHub Wiki

📭 Social Media Posts Tracker

⚙️ Currently supported websites:

  • Twitter (limited)

  • Bluesky

❗️ TWITTER UPDATE - READ FIRST

Due to changes made by Twitter (X) which make it ever-increasingly difficult to access the website, a very limited number of Twitter feeds (mostly high-visibility VTuber and some manually requested feeds) are currently enabled for tracking.

At this time, it does not seem likely that general feed tracking will be practical to enable again any time soon. If you have feeds tracked from before, they are recorded and would automatically begin working again if this functionality is ever restored.

A list of feeds which are currently able to be tracked is generated at http://content.kabii.moe:8080/twitterfeeds.

The feeds listed above are able to be tracked by any servers using the bot in Discord channels by using /track. Other Twitter feeds are not trackable at this time.

User Commands

🔒 By default, channel moderators (Manage Messages permission) can track social feeds. Tracking can be enabled for all users by running /feature restricted Disabled. You may want to disable the other tracker types (anime, streams) using the /feature command for this use-case.

The /track command can be used to track a social feed.

Command Description
/track Track a social media feed in the current channel. Include the @ to make sure Twitter is used instead of another site. /track @irys_en
Alternatively, select Twitter as the site option in Discord.

For Bluesky feeds, either use the full profile URL (bsky.app/profile/name.bsky.social) or @name.bsky.social.

Social Media Feed Notification Configuration

Configuration for the social media tracker is accessible through the /posts command. This command works the same as other Configuration Commands. For example, /posts config will provide an interactive embed for configuration.

🔒 Modifying the posts tracker only affects the current channel and thus requires the Manage Channel permission.

🙈 Posts may be blocked if Discord detects the image as NSFW and the Discord channel is not marked as NSFW.

These settings are all of type toggle and allow you to adjust the content included in the notification message when a social feed is updated.

Property Name Description Default Value
posts If enabled, an update will be posted when tracked social media feeds make a normal post. Enabled
quotes If enabled, an update will be posted when tracked feeds feeds quote other users. Enabled
replies If enabled, an update will be posted when tracked feeds post a reply to another user.
Twitter replies are no longer supported in 2024 and will not be posted regardless of this setting.
Disabled
reposts If enabled, an update will be posted when tracked feeds repost/retweet other users. Disabled
mediaOnly if enabled, ONLY posts containing media will send a notification. Text-only posts/tweets will be dropped completely. This applies to all posts automatically posted in the current channel, including reposts. Disabled
translate If enabled, a translation will be automatically requested for notifications posted by the bot. See details on translator access below for restrictions. Disabled
customurl If set, Tweets will be posted using this URL instead of x.com. Additionally, FBK will not generate a custom embed message for any Tweets, instead allowing the website you have set to make the embed. For example, you may set this field to vxtwitter.com or fixupx.com if you want to use their embeds instead. Note that you will be responsible for keeping up with the status of the site you choose, and it will not fall back onto FBK's embeds if that site does not embed properly. Additionally, features such as Tweet translations will not be available as you are overriding the embed where FBK would post these.

Alternative usage for more advanced path setup: ex. to use a fixupx URL with their translation feature, set to: fixupx.com/&tweet/en

🔔 Pinging a Role for social media activity with /setmention

To have a role mentioned when an account makes a new post, you can use /setmention.

See the Livestream tracker section on /setmention for more details and available variables.

The twittercolor option is unique to Twitter/Bluesky feeds and will change the color of the notification embed to a custom hex color code.

Changing which Tweets will ping with /postpings config

If a role ping is configured, the default behavior will ping for all normal posts, including quotes and replies, and will not ping for reposts. This can be changed using /postpings config.

The currently configured role/text can be checked using the /getmention command.

Translator Selection

The translator selected for posts when the translate feature flag is enabled is not simple, and uses the following priority:

  1. DeepL
    • Limited language support, only used if language is detected as one DeepL supports.
    • Available until monthly quota expires (shared by all users).
    • DeepL API Free key can be provided by your server in the /apikeys command to ensure DeepL is used.
  2. Google
    • Only if feed is whitelisted for Google Translator access
  3. Microsoft
    • Available until monthly quota expires (shared by all users)
  4. Argos
    • Local translation used as a last-resort with no monthly limitations (so at least SOME translation is always available).
    • Worst translations, especially with Japanese, and even worse with slang.
    • RETWEETS go straight to this translator by default to preserve other translator's quota for all users.
      • Providing your own DeepL API key is the only way to bypass this limitation, otherwise it overrides normal translator priority.
      • Retweet translation can be alternatively disabled completely by enabling /languagecfg noretweets.

Twitter Spaces

This feature is no longer available for any users after changes made by Twitter.

Quick Setup

⚠️ **GitHub.com Fallback** ⚠️