Skip to content

Latest commit

 

History

History
246 lines (186 loc) · 34.8 KB

README.md

File metadata and controls

246 lines (186 loc) · 34.8 KB
Raw

FixTweetBot

Top.gg Upvotes Top.gg Servers last commit Crowdin GitHub Release GitHub Sponsors

Invite link Support server Discord App Directory Tog.gg

FixTweetBot is a Discord bot that fixes social media embeds, using online services (such as 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).

showcase

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'.

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.

usage screenshot

You also can ignore a link by putting it between < and >, like this: <https://twitter.com/...>.

You can manage the bot's settings with the /settings command.

settings screenshot

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 or view it from the Discord App Directory

Please also consider upvoting the bot on Tog.gg!

The bot is also available on Discord Bots and Discord Bot List.

Comparison with other bots

FixTweetBot LinkFix Dystopia EmbedEz Nano Embedding Keto ComebackTwitterEmbed TweetFixer VxT VXC/FixTwitter Twitter Video Embeds Auto FxTwitter
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!) ➖ 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 Top.gg Servers 2.3K (07/09/24) 1.4K (07/09/24) 2.5K (07/09/24) 3.8K (07/09/24) top.gg - Servers 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 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:

token: <your_personal_token>
dev_guild: <your_personnal_guild_id> # optional, for dev commands

database:
  host: <your_database_host>
  driver: <your_database_driver>
  database: <your_database_name>
  user: <your_database_user>
  password: <your_database_password>
  port: <your_database_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.

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, 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, 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.

If you're a developer, you can help by fixing bugs, adding new features, or improving the code quality by opening a Pull Request.

Vote

You can leave a star on the GitHub repository.

You can also review the bot on Top.gg and vote for it.

Finally, you can also upvote the bot on Discord Bot List.

Links

Awesome fixers

Here's, for the record, a non-exhaustive list of the fixers/proxies spotted in the wild:

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.

Dependencies

The bot is built on top of the following libraries: