Skip to content
This repository has been archived by the owner on Jan 26, 2024. It is now read-only.

Latest commit

 

History

History
127 lines (83 loc) · 6.59 KB

README.md

File metadata and controls

127 lines (83 loc) · 6.59 KB
Raw

Discord External Video Embeds

NOW WORKS WITH TEXT AND IMAGE TWITTER POSTS

I'm a Discord bot that fixes your broken Twitter, TikTok and Reddit videos. You can find a list of public instances here: https://adryd.co/twitter-embeds.

twitterembeds-aug25.mp4

Description

Twitter Embeds fixes video embeds from Twitter, TikTok and Reddit on Discord with a goal of convinience, seamlessness, and feature-completeness. It parses and obeys Discord's own markdown rules, and allows users to delete their own messages

Special Thanks

  • Brecert: Twitter Client Implementation.
  • Youtube DL: Reference for Instagram, Reddit, Tiktok and Twitter Clients.
  • general-programming: Allowing me to use proxy.knotty.dev as a fallback for oversized reddit videos.
  • BLOCKLETTER Discord: Initially pushing me to make this
  • Cynthia: Implementing seperate upload limits for boosted servers. Various other small features/improvements.

Usage

You can use the bot by adding it to your Discord server, or sending it a direct message. It has 3 different modes that can be changed by a server administrator (Manage Server permission).

  • The video reply mode will reply with a file or direct link to a video.

  • Re-embed will remove the embeds on the original message and reply with a new set of embeds, along with video attachments.

  • Re-compose uses a webhook to recompose the original message with a new set of embeds.

Additional Features

  • The bot obeys spoilers, and all of Discord's markdown rules that may prevent a link from embeding (Including quirks)
  • Users can delete their own re-composed messages or bot replies to their messages bt reacting with an "X" emoji.
  • The bot integrates with HiddenPhox and replies to HiddenPhox's quote-retweet unrolling

Quirks

  • If re-embed or re-compose fail, the bot falls back to video reply mode.
  • re-embed and re-compose attach a file sepperately since Discord doesn't allow bots to add videos to embeds.
  • By following Discord's markdown rules exactly, it also has some of the same quirks; such as spoilers needing to be spaced out.

Hosting Your Own Instance

I'd encourage you host your own instances as it reduces load on my server

The bot requires the following permissions/intents when being added bot, application.commands Manage Webhooks, Send Messages, Send Messages in Threads, Manage Messages, Embed Links, Attach Files

A quick installation script is available. As root run:

wget https://raw.githubusercontent.com/adryd325/discord-twitter-video-embeds/main/debian-11-quick-setup.sh
# review the contents and make sure this won't break existing node programs
nano ./debian-11-quick-setup.sh
chmod +x /debian-11-quick-setup.sh
./debian-11-quick-setup.sh

Windows Installation

Quick install for Windows is available. Download windows-installer.bat and run it as administrator.

FAQ

What's the bot icon?
The bot icon is an abstract interpretation of a user replying to another user with a video or image.

Ari's Instance

The information in this section only applies to ari's instance. This section is made to be easy to understand as nobody likes reading legaleese.

Features

  • TikTok embeds are disabled in the official instace because I get rate-limited from TikTok for requesting too frequently. If you'd like TikTok embeds, you should self-host your own instance

Terms of Service

  • Do not intentionally break or crash the instance
  • If you find a critical bug with the bot you are to report it using the contact info below
  • Usage of the bot must obey the laws in the United States (where Discord and Twitter are owned), Canada (where the bot is hosted) and the country of the end user.

Data Privacy

The following types of user data are stored

  • Message metadata is stored to allow the original owner of a message to delete the replies or re-composed message
    • Message ID: The message ID of the reply or re-composed message
    • Original message ID: The message ID of original message
    • User ID: The ID of the user who owns the reply or re-composed message
    • Channel ID: The channel ID of the channel the messages are in
    • Guild ID: The server ID of the server the messages are in, so server owners can request deletion of all data from their server
  • Webhooks are stored to allow creation of re-composed messages
    • Channel ID: The ID of the channel the webhook is active in
    • Wehbook ID: The ID of the webhook
    • Webhook Token: The credential which allows sending from the webhook
    • Guild ID: The server ID the webhooks are in, so server owners can request deletion of all data from their server
  • Mode preference is saved so the bot can remember what type of embeds a server prefers
    • Mode: The mode the server prefers embeds be sent in
    • Flags: Additional server options
    • Guild ID: The ID of the server
  • Servers the bot joins, and leaves are logged to a private server with the following information (member count, guild id, name)

Obviously post information is fetched from their respected providers (Twitter, TikTok, Reddit), and information is sent through Discord.
You're free to request deletion of data associated with your user or a server you own using the contact info below.

Contact Info

If for any reason you need to contact me, I'm available through the following channels

  • Discord: adryd#6880; State why you added me after sending a friend request
  • Email: [email protected]; Please include Twitter Embeds in the subject line
  • Github: You can create an issue on this repository if you've found a bug not already mentioned in TODO.txt

Alternatives

If you're unable to add the bot to your server, or you're looking for something different, the following may be of use to you