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-02-27T19:37:07.000Z (2 months ago)
- Last Synced: 2025-02-28T04:11:56.668Z (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.56 MB
- Stars: 51
- Watchers: 2
- Forks: 5
- Open Issues: 4
-
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, Pixiv, 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
- 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) |
|----------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------|----------------------------------------------------------------------------------------------|------------------------------------------------------------------|--------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|
| Social medias supported | - Twitter (FxTwitter)
- Nitter (FxTwitter)
- Instagram (InstaFix)
- TikTok (fxTikTok)
- Reddit (FixReddit)
- Threads (FixThreads)
- Bluesky (VixBluesky)
- Pixiv (phixiv)
- IFunny (EmbedEZ)
- Fur Affinity (xfuraffinity)
- YouTube (Koutube)
- Custom Websites (like Mastodon) | - Twitter (FxTwitter)
- Youtube Shorts (Youtube)
- TikTok (vxtiktok)
- Instagram (InstaFix)
- Reddit (vxreddit)
- Pixiv (phixiv) | - Twitter (FxTwitter)
- TikTok (vxtiktok)
- Reddit (FixReddit)
- Instagram (InstaFix) | - Twitter (EmbedEZ)
- TikTok (EmbedEZ)
- Instagram (EmbedEZ)
- Reddit (EmbedEZ)
- IFunny (EmbedEZ) | - Twitter (custom)
- Bluesky (custom)
- Instagram (custom)
- TikTok (custom)
- Pixiv (custom)
- DevianArt (custom)
- Fur Affinity (custom)
- Newgrounds (custom) | - Twitter (FxTwitter)
- TikTok (QuickVids)
- Instagram (InstaFix)
- Reddit (FixReddit/Custom)
- Apple Music (Odesli)
- Spotify (Odesli) | - Twitter (custom) | - Twitter (FxTwitter) | - Twitter (FxTwitter)
- Instagram (InstaFix)
- TikTok (tiktxk)
- Custom Websites | - Twitter (FxTwitter/vxTwitter) | - Twitter (Custom)
- TikTok (Custom)
- Reddit (Custom) | - Twitter (FxTwitter) |
| 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 | ❌ | ❌ | - 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 ([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 |
| Server count |  | 2.3K (07/09/24) | 1.4K (07/09/24) | 2.5K (07/09/24) | 3.8K (07/09/24) | 14k (28/2/24) | 8.3K (07/09/24) | ➖ | ➖ | ➖ | 9.1K (07/09/24) | 11 (07/09/24) |
| ____________________________________________ | _____________________________________________ | __________________________ | ___________________________________ | ___________________________________ | ________________________________________ | _______________________________ | ____________________________________________________ | ________________________________ | ________________________________________________ | ________________________________________ | _________________________________ | _______________________ |
_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.
### Contributing
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*
- [BetterTwitFix • vxtwitter.com](https://github.com/dylanpdx/BetterTwitFix)
- [EmbedEZ • twitterez.com](https://embedez.com)
- Instagram
- [InstaFix • ddinstagram.com](https://github.com/Wikidepia/InstaFix)
- [EmbedEZ • instagramez.com](https://embedez.com) *Used by FixTweetBot*
- 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) *Used by FixTweetBot*
- [vxreddit • vxreddit.com](https://github.com/dylanpdx/vxReddit)
- [EmbedEZ • redditez.com](https://embedez.com)
- 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*
- IFunny
- [EmbedEZ • ifunnyez.co](https://embedez.com) *Used by FixTweetBot*
- YouTube
- [Koutube • koutube.com](https://github.com/iGerman00/koutube) *Used by FixTweetBot*
- Bluesky
- [VixBluesky • bskx.app](https://github.com/Lexedia/VixBluesky) *Used by FixTweetBot*
- Roblox
- [Rxblox2 • fixroblox.com](https://github.com/vys69/Rxblox2)
- Snapchat
- [EmbedEZ • snapchatez.com](https://embedez.com) *Used by FixTweetBot*
- Furaffinity
- [xfuraffinity • xfuraffinity.net](https://github.com/FirraWoof/xfuraffinity) *Used by FixTweetBot*
- [fxraffinity • fxraffinity.net](https://fxraffinity.net/)
- DeviantArt
- [fixDeviantArt • fixdeviantart.com](https://github.com/Tschrock/fixdeviantart)
- [fxDeviantArt • fxdeviantart.com](https://github.com/daisyUniverse/fxdeviantart)
- Mastodon
- [FxMastodon • fx.zillanlabs.tech](https://fx.zillanlabs.tech/)
- [FxMastodon • fxmas.to](https://github.com/Someguy123/fxmastodon)
- [FxMastodon • fx.sizecraft.social](https://fx.sizecraft.social/)
- Misskey
- [FxMastodon • fx.sizecraft.social](https://fx.sizecraft.social/)
_Do you know of another proxy that is not included here? Feel free to open an issue!_
## Credits
### Proxies
Nothing would be possible without the proxies 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)
- [FixReddit](https://github.com/MinnDevelopment/fxreddit)
- [FixThreads](https://github.com/milanmdev/fixthreads)
- [VixBluesky](https://github.com/Lexedia/VixBluesky)
- [phixiv](https://github.com/thelaao/phixiv)
- [EmbedEZ](https://embedez.com)
- [xfuraffinity](https://github.com/FirraWoof/xfuraffinity)
- [Koutube](https://github.com/iGerman00/koutube)
### 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)