Embed Fixer

Bot invitation link

As we know, social media embeds on Discord are bad:

• Pixiv embeds don't show the full artwork
• X/Twitter sometimes doesn't embed
• Instagram doesn't show the image/video
• Reddit doesn't show the images
• Tiktok doesn't show the video
• Twitch clip doesn't play the clips
• And so on...

Worry no more, this Discord bot fixes all of those issues.

Features

Embed Fixing

Fixings are currently available for:

• Pixiv with phixiv
• Twitter/X with fxtwitter
• Instagram with fxinstagram (made by me, closed source because the implementation is sketchy)
• Reddit with fxreddit or vxreddit
• Tiktok wtih fxtiktok
• Furaffinity with xfuraffinity
• Twitch clips with fxtwitch
• Iwara with fxiwara
• Bluesky with VixBluesky
• Facebook reels with fxfacebook
• Bilibili videos with fxBilibili
• Tumblr with fxtumblr
• Threads with fixthreads

If your message contains link(s) that are of any of the social medias above, it gets deleted and resent using a webhook with your name and avatar containing the fix. There is also a ❌ reaction made to the message, so that the author of the message can click on and delete the message. The emoji used can be changed with the /settings command.

Tip

Embed fixing can be disabled for a specific link by adding $ at the beginning of the link. For example, $https://twitter.com/... will not be fixed.

About Pixiv Embed Fixing

If the link is sent in a non-NSFW channel AND is from Pixiv AND the artwork contains the "#R-18" tag, the Embed Fixer will NOT fix the embed as this will show the NSFW image.

Webhook Replying

When you reply to a webhook, it replies to the webhook, not the original author. The bot fixes this by tagging the original author with the same name of the webhook.

Media Extracting

The following platforms are supported:

• Twitter/X
• Pixiv
• Iwara
• Kemono
• Bluesky
• Tiktok

When you send a link that is from one of the platforms above in channel(s) with this feature on, the bot resends all of the images/videos in the link in a nice gallery-like layout.

Note

If the link is sent in a NSFW channel then the extracted media will be spoilered automatically.

Very Customizable

All settings are unique to each server

Below are settings you can change with the /settings command:

• Disable embed fixes: Disable specific embed fixes
• Language: Change language of the bot
• Media extraction channels: Channels to enable the media extraction feature mentioned above
• Disable embed fix channels: Channels to disable embed fixing
• Disable webhook reply: Disable the webhook reply feature mentioned above
• Disable auto spoiler in NSFW channels: For channels with the media extraction feature on, disable automatic spoilering extracted media in NSFW channels
• Show post content: For channels with media extraction enabled, channels with this feature on will also show the content and author of the post along with the media.
• Use vxreddit: Use vxreddit to fix Reddit embeds instead of fxreddit.
• Change delete message emoji: Change the reaction emoji used to delete the webhook messages, defaults to ❌. You can set custom emojis too, like <:emoji:123456789012345678>

Questions, Issues, Feedback, Contributions

Whether you want a new fix to be added, to request a new feature, to report a bug, or to contribute to translations. You can do so by creating an issue or a pull request.
If GitHub is not your type, you can find me on Discord, my username is @seria_ati.

Self Hosting

1. Create a Discord application
2. On the Bot page, generate a token and save it for later
3. Enable Message Content Intent
4. Run the application with your bot token as the DISCORD_TOKEN environment variable
5. Invite your bot with the invite link in the logs

Syncing Commands

The command prefix is the bot's mention by default. For example, if your bot's name is Embed Fixer, the prefix would be @Embed Fixer.
Run @Embed Fixer sync to sync the commands.

Database Migrations

Changes to the database schema can be found in /migrations/embed_fixer.
To apply the changes, run aerich upgrade (only supports PostgreSQL; for other databases like SQLite, you need to migrate manually).

Docker

docker run -v /my/mnt/logs:/app/logs -v /my/mnt/data:/data -e DISCORD_TOKEN=YourDiscordBotToken.Example.SomeExampleBase64Junk ghcr.io/seriaati/embed-fixer:latest

Volumes

• /app/logs: the logfiles produced by the program
• /data: the default location for the embed_fixer.db SQLite database file

Environment Variables

• DISCORD_TOKEN: your Discord bot token
• DB_URI: defaults to sqlite:///data/embed_fixer.db, available to customize the database location

Local

1. Install uv

2. Clone the repository

3. Create a .env file:

   DISCORD_TOKEN=YourDiscordBotToken.Example.SomeExampleBase64Junk
   ENV=dev

4. uv run run.py