https://github.com/thelovinator1/discord-twitter-webhooks

🤖Stream tweets to Discord
https://github.com/thelovinator1/discord-twitter-webhooks

bot discord discord-twitter-bot discord-twitter-webhooks discord-webhooks hacktoberfest python tweepy tweets twitter twitter-api webhook webhooks

Last synced: about 1 year ago
JSON representation

🤖Stream tweets to Discord

• Host: GitHub
• URL: https://github.com/thelovinator1/discord-twitter-webhooks
• Owner: TheLovinator1
• License: gpl-3.0
• Created: 2018-07-06T23:30:00.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2025-02-28T03:13:55.000Z (over 1 year ago)
• Last Synced: 2025-03-27T20:42:09.845Z (about 1 year ago)
• Topics: bot, discord, discord-twitter-bot, discord-twitter-webhooks, discord-webhooks, hacktoberfest, python, tweepy, tweets, twitter, twitter-api, webhook, webhooks
• Language: Python
• Homepage:
• Size: 1.43 MB
• Stars: 118
• Watchers: 8
• Forks: 29
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Discord-twitter-webhooks



  







Theme is https://github.com/KillYoy/DiscordNight





`discord-twitter-webhooks` is an automated tool that sends tweets from Twitter to Discord using webhooks.

## Features

- Send tweets from Twitter to Discord using webhooks.

- Send the tweet as an embed, link or text.

- Support for translations via [DeepL](https://www.deepl.com/translator).

## Installation

You have two choices, using [Docker](https://hub.docker.com/r/thelovinator/discord-twitter-webhooks)

or [install directly on your computer](#install-directly-on-your-computer).

### Run with Docker

This is the recommended way to install the bot.

Docker Hub: [thelovinator/discord-twitter-webhooks](https://hub.docker.com/r/thelovinator/discord-twitter-webhooks)

- Data is stored in /home/botuser/.local/share/discord_twitter_webhooks in the container.

- The container runs as the bot user with UID 1000 and GID 1000, this means your directory must be owned by UID 1000 and

  GID 1000.

- The server runs on port 8000.

### Install directly on your computer

This is not recommended if you don't have an init system (e.g., systemd)

- Install the latest version of needed software:

    - [Python](https://www.python.org/)

        - You should use the latest version.

        - You want to add Python to your PATH.

        - Windows: Find `App execution aliases` and disable python.exe and python3.exe

    - [Poetry](https://python-poetry.org/docs/master/#installation)

        - Windows: You have to add `%appdata%\Python\Scripts` to your PATH for Poetry to work.

            - Open System Properties

            - Click on Environment Variables...

            - Under User variables find Path and click Edit...

            - Add `%appdata%\Python\Scripts` to the list.

- Download the project from GitHub with Git or download

  the [ZIP](https://github.com/TheLovinator1/discord-twitter-webhooks/archive/refs/heads/master.zip).

    - If you want to update the bot, you can run `git pull` in the project folder or download the ZIP again.

- Open a terminal in the repository folder.

    - Windows 10: Shift + right-click in the folder and select `Open PowerShell window here`

    - Windows 11: Shift + right-click in the folder and Show more options

      and `Open PowerShell window here`

- Install requirements:

    - Type `poetry install` into the terminal.

- Start the bot:

    - Type `poetry run bot` into the PowerShell window.

        - You can stop the bot with Ctrl + c.

- Go to [http://localhost:8000](http://localhost:8000) or the IP of your server.

- You can change the Nitter instance in Settings.

- Add a group under Add.

    - A group is a collection of Twitter accounts and Discord webhooks that will be used to send tweets.

    - Each group has its own settings. (e.g., If retweets should be sent, should be sent as an embed, etc.)