Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 9 days 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 (12 months ago)
- Default Branch: main
- Last Pushed: 2024-10-30T02:04:32.000Z (3 months ago)
- Last Synced: 2024-10-30T02:44:13.303Z (3 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)
As we know, social media embeds on Discord are bad:
- Pixiv embeds don't show the full artwork
- X/Twitter sometimes doesn't even embed
- Instagram doesn't show the image/video
- Reddit doesn't show the full thread
- Tiktok doesn't show the video
- Twitch clip embeds don'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](https://github.com/HazelTheWitch/phixiv)
- Twitter/X with [fxtwitter](https://github.com/FixTweet/FxTwitter)
- Instagram with ~~[instafix](https://github.com/Wikidepia/InstaFix)~~ [InstagramEZ](https://embedez.com/) (Not open sourced but a lot more stable)
- Reddit with [fxreddit](https://github.com/MinnDevelopment/fxreddit)
- Tiktok wtih [vxtiktok](https://github.com/dylanpdx/vxtiktok)
- Furaffinity with [xfuraffinity](https://github.com/FirraWoof/xfuraffinity)
- Twitch clips with [fxtwitch](https://github.com/seriaati/fxtwitch)
- Iwara with [fxiwara](https://github.com/seriaati/fxiwara)
- Bluesky with [VixBluesky](https://github.com/Rapougnac/VixBluesky)
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.
> [!NOTE]
> 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
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
# 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`