https://github.com/Kyrela/FixTweetBot
FixTweetBot is a Discord bot that fixes social media embeds, using online services (such as FxTwitter)
https://github.com/Kyrela/FixTweetBot
bluesky bot discord discord-bot embed fix fxtwitter ifunny instagram link mastodon pixiv reddit snapchat social-media social-network threads tiktok twitter video
Last synced: 2 months ago
JSON representation
FixTweetBot is a Discord bot that fixes social media embeds, using online services (such as FxTwitter)
- Host: GitHub
- URL: https://github.com/Kyrela/FixTweetBot
- Owner: Kyrela
- License: other
- Created: 2023-10-19T20:23:38.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-26T19:40:02.000Z (2 months ago)
- Last Synced: 2025-04-03T18:52:56.800Z (2 months ago)
- Topics: bluesky, bot, discord, discord-bot, embed, fix, fxtwitter, ifunny, instagram, link, mastodon, pixiv, reddit, snapchat, social-media, social-network, threads, tiktok, twitter, video
- Language: Python
- Homepage: https://discord.com/application-directory/1164651057243238400
- Size: 5.69 MB
- Stars: 54
- Watchers: 2
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
FixTweetBot
[](https://top.gg/bot/1164651057243238400)
[](https://top.gg/bot/1164651057243238400)
[](https://crowdin.com/project/fixtweetbot)
[](https://github.com/Kyrela/FixTweetBot/releases/latest)
[](https://github.com/sponsors/Kyrela)
[](https://discord.com/oauth2/authorize?client_id=1164651057243238400)
[](https://discord.gg/3ej9JrkF3U)
[](https://discord.com/application-directory/1164651057243238400)
[](https://top.gg/bot/1164651057243238400)
FixTweetBot is a Discord bot that fixes social media embeds,
using online services (such as [FxTwitter](https://github.com/FixTweet/FxTwitter))
In concrete terms, this bot automatically repost social media links as a 'fixed' version
that contains a better embed (that allows to play videos directly in Discord, for example).
## Features & Highlights
- Supports Twitter, Nitter, Instagram, TikTok, Reddit, Threads, Bluesky, Snapchat, Facebook, Pixiv, Twitch, Spotify,
DeviantArt, Mastodon, Tumblr, BiliBili, IFunny, Fur Affinity, YouTube, and any custom websites of your choice
- Tweets translation
- Disable by website, channel, member or role
- Highly customizable behavior and appearance
- Multiple languages supported
- Modern interface for settings
- Can respond to bots and webhooks
- Respect markdown
- Respect privacy
- Source-available
More infos on the '[comparison table](#comparison-with-other-bots)'.
## Usage
Simply send a message containing a compatible social media link, and the bot will remove the embed if any and
automatically repost it as a 'fixed' link.
You also can ignore a link by putting it between `<` and `>`, like this: ``.
You can manage the bot's settings with the `/settings` command.
Lastly, you can use the `/about` command any time to get more information about the bot and to get help.
## Add the bot to your server
You can add the bot to your server by clicking on the following
link: [Invite link](https://discord.com/oauth2/authorize?client_id=1164651057243238400)
or view it from the [Discord App Directory](https://discord.com/application-directory/1164651057243238400)
Please also consider upvoting the bot on [Tog.gg](https://top.gg/bot/1164651057243238400)!
The bot is also available on
[Discord Bots](https://discord.bots.gg/bots/1164651057243238400) and
[Discord Bot List](https://discord.ly/fixtweet).
## Comparison with other bots
| | FixTweetBot | [LinkFix](https://github.com/podaboutlist/linkfix-for-discord) | [Dystopia](https://top.gg/bot/1038138572613619793) | [EmbedEz](https://embedez.com) | [Nano Embedding](https://discord.com/application-directory/978552836105326592) | [Keto](https://github.com/stekc/Keto-Bot) | [ComebackTwitterEmbed](https://top.gg/fr/bot/1161267455335862282) | [TweetFixer](https://top.gg/fr/bot/1177042905622396928) | [VxT](https://top.gg/fr/bot/1015497909925580830) | [VXC/FixTwitter](https://top.gg/fr/bot/1162350583198515210) | [Twitter Video Embeds](https://discord.com/application-directory/842601826674540574) | [Auto FxTwitter](https://discord.com/application-directory/1275895582220877855) |
|----------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|
| Supported websites | 
+ Any Custom Websites | | | | 
| 
| | | + Any Custom Websites | | | |
| Ignore message by | - Channel
- Role
- Member | ❌ | ❌ | ❌ | ❌ | ❌ | - Channel
- Role
- Member
- Keywords | ❌ | - Role
- Member | ❌ | ❌ | ❌ |
| Modifications on the base message | - Nothing
- Remove the embed
- Delete the message | ❌ | - Delete the message | ❌ | - Remove the embed | - Remove the embed | - Nothing
- Delete the message (if it contains only the link) | - Delete the message | - Delete the message
- Nothing | - Delete the message | - Delete (only if using webhook, else nothing) | - Remove the embed |
| Message method | - Reply (without mention)
- Message | - Replying (without mention) | - Message | - Message | - Reply | - Reply | - Reply
- Message | - Message | - Message (as bot or using webhook) | - Message | - Reply
- Message (using webhook) | - Reply |
| Message content | Fixed links in hypertext (view render can be customized) | Fixed links | Author + full message content with fixed links in hypertext | Fixed link | Embed, with a second embed containing the video if any. | Fixed link | Embed with separated video, photos in the embed **or** as attachments | Author's mention + message content with fixed links | Message content with fixed links | Author's mention + message content with fixed links in hypertext | Embeds with video as an attachment **or** only medias | Fixed links |
| Respect markdown | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✔️ | ❌ |
| Possibility for op to delete the bot's post | ❌ | ❌ | ✔️ | ❌ | ✔️ | ❌ | ✔️ | ❌ | ✔️ (for everyone, vote-based) | ✔️ | ✔️ | ❌ |
| Other features and notes | - Custom websites
- Posts translation (Twitter)
- Embed customization (Twi, Bsky, TikTok)
- 'Disable/Enable all' on filters
- 'Disable/Enable by default' on filters
- Troubleshoot system
- Respond to bots/webhooks (disabled by default)
- Open links in app on click | ❌ | ❌ | - Website interface
- Download system | - False positive on already-fixed links | ❌ | - Posts translation (Twitter)
- Download videos (Twitter)
- Tweet save
- Customization
- React to other bots | ❌ | - Custom websites
- Quote tweet settings
- Posts translation (Twitter) | ❌ | - Download videos | ❌ |
| Permissions asked | Minimum | Unused ones | Unused ones **and** missing ones | Unused ones **and** missing ones | Unused ones **and** missing ones | Minimum | Not enough | Not enough | Extremely abusive, for privacy and security | Administrator (real risk) | Not enough | Not enough |
| Languages | en, fr, ja, pr-BR ([contribute to add more!](https://crowdin.com/project/fixtweetbot)) | ➖ | en | en | en | en | jp | en | en | jp | en | en |
| Open-sourced | ➖ Source-available | ✔️ | ❌ | ❌ | ❌ | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Business model | Freemium | Free | Free | Freemium | Free, donations accepted | Free | Free | Free | Free | Free | Free | Free |
| ____________________________________________ | _____________________________________________ | __________________________ | ___________________________________ | ___________________________________ | ________________________________________ | _______________________________ | ____________________________________________________ | ________________________________ | ________________________________________________ | ________________________________________ | _________________________________ | _______________________ |
_Do you know of another similar bot that is not included here? Feel free to open an issue!_
## Get help
If you need help, you can join the [support server](https://discord.gg/3ej9JrkF3U) or open an issue.
## Self-hosting
Simply install Python >= 3.10, clone the repository, and run `pip install -r requirements.txt`.
Be sure to have a database set up using MySQL.
Then, create a `override.config.yml` file containing the following:
```yaml
token:
dev_guild: # optional, for dev commands
database:
host:
driver:
database:
user:
password:
port:
```
You can also override any other config value from `config.yml` in this file.
You might also want to modify other configuration options. More information about how to do it
on [discore](https://github.com/Kyrela/discore).
Now, initialize the database by running `masonite-orm migrate -C database/config.py -d database/migrations`.
Finally, run `python main.py`.
## Help & Contributing
If you want to help, first of all, thank you! There are many ways to contribute:
### Money
You can buy the [premium version of the bot](
https://discord.com/application-directory/1164651057243238400/store/1260699263755751456), that will give you access to
more features and will help me to keep the bot running.
You can also simply [donate or sponsor me using GitHub Sponsors](https://github.com/sponsors/Kyrela), you'll get cool
little rewards, and you can even have your name displayed on the readme, and it will help me to keep the bot running.
### Enhance the bot
You can help to [translate the bot into your language on Crowdin](https://crowdin.com/project/fixtweetbot).
If you're a developer, you can help by fixing bugs, adding new features, or improving the code quality by opening a
[Pull Request](https://github.com/Kyrela/FixTweetBot/pulls).
### Vote
You can [leave a star on the GitHub repository](https://github.com/Kyrela/FixTweetBot).
You can also [review the bot on Top.gg](https://top.gg/bot/1164651057243238400#reviews) and [vote for it](
https://top.gg/bot/1164651057243238400/vote).
Finally, you can also [upvote the bot on Discord Bot List](https://discordbotlist.com/bots/fixtweet/upvote).
## Links
- [Source code](https://github.com/Kyrela/FixTweetBot) (please leave a star!)
- [Discord App Directory page](https://discord.com/application-directory/1164651057243238400)
- [Top.gg page](https://top.gg/bot/1164651057243238400) (please leave an upvote!)
- [Support server](https://discord.gg/3ej9JrkF3U)
- [Translations on Crowdin](https://crowdin.com/project/fixtweetbot)
- [Invite link](https://discord.com/oauth2/authorize?client_id=1164651057243238400)
- [Discord Bots page](https://discord.bots.gg/bots/1164651057243238400)
- [Discord Bot List page](https://discord.ly/fixtweet)
## Awesome fixers
Here's, for the record, a non-exhaustive list of the fixers/proxies spotted in the wild:
- Twitter
- [FxTwitter • fxtwitter.com](https://github.com/FixTweet/FxTwitter) *Used by FixTweetBot*
- Other official public instances/redirects: `fixupx.com`, `twittpr.com`
- Other unofficial public instances/redirects: `girlcockx.com`, `hitlerx.com`, `peepeepoopoodumdumtwitterx.org`, `skibidix.com`, `yiffx.com`, `imthehottest18yearoldononlyfansx.com` (http only)
- [BetterTwitFix • vxtwitter.com](https://github.com/dylanpdx/BetterTwitFix)
- Other official public instances/redirects: `fixvx.com`
- Other unofficial public instances/redirects: `stupidpenisx.com`
- [EmbedEZ • twitterez.com](https://embedez.com)
- Instagram
- [InstaFix • ddinstagram.com](https://github.com/Wikidepia/InstaFix)
- [kkinstagram • kkinstagram.com](https://kkinstagram.com)
- [EmbedEZ • instagramez.com](https://embedez.com) *Used by FixTweetBot*
- [fxinstagram • fxig.seria.moe](https://fxig.seria.moe)
- TikTok
- [fxTikTok • tnktok.com](https://github.com/okdargy/fxtiktok) *Used by FixTweetBot*
- [vxtiktok • vxtiktok.com](https://github.com/dylanpdx/vxtiktok)
- [tiktxk • tiktxk.com](https://github.com/Britmoji/tiktxk)
- [FxTikTok • tfxktok.com](https://tfxktok.com/)
- [EmbedEZ • tiktokez.com](https://embedez.com)
- Reddit
- [FixReddit • rxddit.com](https://github.com/MinnDevelopment/fxreddit)
- [vxreddit • vxreddit.com](https://github.com/dylanpdx/vxReddit) *Used by FixTweetBot*
- [s/e/xy Reddit • rxyddit.com](https://github.com/NurMarvin/sexy-reddit)
- [EmbedEZ • redditez.com](https://embedez.com)
- Facebook
- [EmbedEZ • facebookez.com](https://embedez.com) *Used by FixTweetBot*
- [fxfacebook • fxfb.seria.moe](https://github.com/seriaati/fxfacebook)
- Bilibili
- [EmbedEZ • bilibliez.com](https://embedez.com)
- [fxBilibili • fxbilibili.seria.moe](https://github.com/seriaati/fxBilibili) *Used by FixTweetBot*
- Threads
- [FixThreads • fixthreads.net](https://github.com/milanmdev/fixthreads) *Used by FixTweetBot*
- [vxThreads • vxthreads.net](https://github.com/everettsouthwick/vxThreads)
- Pixiv
- [phixiv • phixiv.net](https://github.com/thelaao/phixiv) *Used by FixTweetBot*
- Other official public instances/redirects: `ppxiv.net`
- IFunny
- [EmbedEZ • ifunnyez.co](https://embedez.com) *Used by FixTweetBot*
- YouTube
- [Koutube • koutube.com](https://github.com/iGerman00/koutube) *Used by FixTweetBot for playlists*
- [youtube-discord-embed • yt.cdn.13373333.one](https://github.com/ray-1337/youtube-discord-embed/) *Used by FixTweetBot*
- Twitch
- [fxtwitch • fxtwitch.seria.moe](https://github.com/seriaati/fxtwitch) *Used by FixTweetBot*
- Bluesky
- [VixBluesky • bskx.app](https://github.com/Lexedia/VixBluesky) *Used by FixTweetBot*
- Other official public instances/redirects: `bskyx.app` (deprecated)
- Other unofficial public instances/redirects: `girlcockbsky.app` (nsfw content)
- [FixBluesky • bsyy.app](https://github.com/ThornbushHQ/FixBluesky)
- [xbsky • xbsky.app](https://github.com/colduw/xbsky)
- [FxBluesky • fxbsky.app](https://bsky.app/profile/fxbsky.app)
- [bskye • bskye.app](https://github.com/FerroEduardo/bskye)
- [cbsky.app • cbsky.app](https://github.com/goeo-/cbsky.app)
- [bsky-viewer • bsky-viewer.branchpanic.workers.dev](https://github.com/branchpanic/bsky-viewer)
- Roblox
- [Rxblox2 • fixroblox.com](https://github.com/vys69/Rxblox2)
- Snapchat
- [EmbedEZ • snapchatez.com](https://embedez.com) *Used by FixTweetBot*
- Spotify
- [fxspotify • fxspotify.com](https://github.com/dotconnexion/fxspotify) *Used by FixTweetBot*
- [FixSpotify • fixspotify.com](https://github.com/gurrrrrrett3/fixspotify)
- Furaffinity
- [xfuraffinity • xfuraffinity.net](https://github.com/FirraWoof/xfuraffinity) *Used by FixTweetBot*
- [fxraffinity • fxraffinity.net](https://github.com/kheina-com/fxraffinity)
- Other official public instances/redirects: `fxfuraffinity.net`
- [fxraffinity • fxraffinity.net](https://fxraffinity.net/)
- DeviantArt
- [fixDeviantArt • fixdeviantart.com](https://github.com/Tschrock/fixdeviantart) *Used by FixTweetBot*
- [fxDeviantArt • fxdeviantart.com](https://github.com/daisyUniverse/fxdeviantart)
- Iwara (nsfw content)
- [fxiwara • fxiwara.seria.moe](https://github.com/seriaati/fxiwara)
- Mastodon
- [FxMastodon • fx.zillanlabs.tech](https://fx.zillanlabs.tech/) *Used by FixTweetBot*
- [FxMastodon • fxmas.to](https://github.com/Someguy123/fxmastodon)
- [FxMastodon • fx.sizecraft.social](https://fx.sizecraft.social/)
- Tumblr
- [fxtumblr • tpmblr.com](https://github.com/knuxify/fxtumblr) *Used by FixTweetBot*
- [TxTumblr • txtumblr.com](https://github.com/MarkSuckerberg/txtumblr)
- Misskey
- [FxMastodon • fx.sizecraft.social](https://fx.sizecraft.social/)
_Do you know of another fixer that is not included here? Feel free to open an issue!_
## Credits
### Fixers
Nothing would be possible without the fixers that allow the bot to access the internet. Don't hesitate to support them!
> [!NOTE]
We're not affiliated with any of these services.
- [FxTwitter](https://github.com/FixTweet/FxTwitter)
- [fxTikTok](https://github.com/okdargy/fxTikTok)
- [vxreddit](https://github.com/dylanpdx/vxReddit)
- [fxBilibili](https://github.com/seriaati/fxBilibili)
- [FixThreads](https://github.com/milanmdev/fixthreads)
- [VixBluesky](https://github.com/Lexedia/VixBluesky)
- [phixiv](https://github.com/thelaao/phixiv)
- [fixDeviantArt](https://github.com/Tschrock/fixdeviantart)
- [FxMastodon](https://fx.zillanlabs.tech/)
- [fxtumblr](https://github.com/knuxify/fxtumblr)
- [EmbedEZ](https://embedez.com)
- [xfuraffinity](https://github.com/FirraWoof/xfuraffinity)
- [youtube-discord-embed](https://github.com/ray-1337/youtube-discord-embed/)
- [Koutube](https://github.com/iGerman00/koutube)
- [fxtwitch](https://github.com/seriaati/fxtwitch)
- [fxspotify](https://github.com/dotconnexion/fxspotify)
### Dependencies
The bot is built on top of the following libraries:
- [discore](https://github.com/Kyrela/discore)
- [python-i18n](https://github.com/danhper/python-i18n)
- [psutil](https://github.com/giampaolo/psutil)
- [requests](https://github.com/psf/requests)
- [masonite-orm](https://github.com/MasoniteFramework/orm)
- [PyMySQL](https://github.com/PyMySQL/PyMySQL)
- [discord-markdown-ast-parser](https://github.com/Vioshim/discord-markdown-ast-parser)
- [Top.gg python-sdk](https://github.com/null8626/python-sdk/tree/patch-1)