https://github.com/seriaati/embed-fixer
Discord bot that fixes social media embeds
https://github.com/seriaati/embed-fixer
discord-bot embed fix-discord-embed fix-embed instagram pixiv reddit tiktok twitter
Last synced: 4 months ago
JSON representation
Discord bot that fixes social media embeds
- Host: GitHub
- URL: https://github.com/seriaati/embed-fixer
- Owner: seriaati
- License: gpl-3.0
- Created: 2024-02-07T09:51:57.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-30T02:04:32.000Z (12 months ago)
- Last Synced: 2024-10-30T02:44:13.303Z (12 months ago)
- Topics: discord-bot, embed, fix-discord-embed, fix-embed, instagram, pixiv, reddit, tiktok, twitter
- Language: Python
- Homepage:
- Size: 449 KB
- Stars: 27
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/astral-sh/ruff)
# Embed Fixer
[**Bot invitation link**](https://discord.com/oauth2/authorize?client_id=770144963735453696)
Available as both a user and server app.
When installed as a user app, you can right click a message to fix its embed or extract its media.
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:
- X/Twitter: [FxEmbed](https://github.com/FxEmbed/FxEmbed)/[BetterTwitFix](https://github.com/dylanpdx/BetterTwitFix)
- Pixiv: [Phixiv](https://github.com/thelaao/phixiv)
- TikTok: [fxTikTok](https://github.com/okdargy/fxTikTok)/[vxtiktok](https://github.com/dylanpdx/vxtiktok)
- Reddit: [FixReddit](https://github.com/MinnDevelopment/fxreddit)/[vxReddit](https://github.com/dylanpdx/vxReddit)
- Instagram: [InstaFix](https://github.com/Wikidepia/InstaFix)/[EmbedEZ](https://github.com/seriaati/embedez)/KKInstagram
- FurAffinity: [xfuraffinity](https://github.com/FirraWoof/xfuraffinity)
- Twitch clips: [fxtwitch](https://github.com/seriaati/fxtwitch)
- Iwara: [fxiwara](https://github.com/seriaati/fxiwara)
- Bluesky: [VixBluesky](https://github.com/Lexedia/VixBluesky)/[FxEmbed](https://github.com/FxEmbed/FxEmbed)
- Kemono: Media extraction only, no embed fixing
- Facebook: [EmbedEZ](https://github.com/seriaati/embedez)/[fxfacebook](https://github.com/seriaati/fxfacebook)
- Bilibili: [fxbilibili](https://github.com/seriaati/fxbilibili)/[EmbedEZ](https://github.com/seriaati/embedez)/[BiliFix](https://vxbilibili.com)
- Tumblr: [fxtumblr](https://github.com/knuxify/fxtumblr)
- Threads: [FixThreads](https://github.com/milanmdev/fixthreads)/[vxThreads](https://github.com/everettsouthwick/vxThreads)
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]
> You can disable embed fixing 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
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.
If the link is sent in a NSFW channel, then the extracted media will be spoilered automatically (changeable).
Also, if you wrap the URL with spoiler tags, like ||||, the extracted image(s) 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 for websites: Disable embed fixes for specific websites.
- 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.
- 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>`
- Choose embed fix service: Choose the embed fix service to use for different websites.
- Bot visibility: Change whether Embed Fixer can fix other bots' embeds or just ones sent by users.
- Funnel to target channel: If set, the bot will send all fixed embeds and extracted medias to a specific channel instead of the original channel.
# 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](https://discord.com/invite/b22kMKuwbS), my username is @seria_ati.
# Self Hosting
1. Create a [Discord application](https://discord.com/developers/applications)
1. On the **Bot** page, generate a token and save it for later
1. Enable **Message Content Intent**
1. Run the application with your bot token as the `DISCORD_TOKEN` environment variable
1. 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
```sh
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](https://docs.astral.sh/uv/getting-started/installation/)
1. Clone the repository
1. Create a `.env` file:
```env
DISCORD_TOKEN=YourDiscordBotToken.Example.SomeExampleBase64Junk
ENV=dev
```
1. `uv run run.py`