Social Media Tracker - kabiiQ/FBK GitHub Wiki
-
Twitter (limited)
-
Bluesky
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.
🔒 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. |
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
|
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.
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.
The translator selected for posts when the translate
feature flag is enabled is not simple, and uses the following priority:
- 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.
- Google
- Only if feed is whitelisted for Google Translator access
- Microsoft
- Available until monthly quota expires (shared by all users)
-
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
.
This feature is no longer available for any users after changes made by Twitter.