https://github.com/tgbot-collection/teletweet
🦉 A telegram Twitter bot that will allow you send tweets!
https://github.com/tgbot-collection/teletweet
bot-tweet-message telegram-twitter-bot telegrambot tweets twitter-bot video-tweet
Last synced: about 2 months ago
JSON representation
🦉 A telegram Twitter bot that will allow you send tweets!
- Host: GitHub
- URL: https://github.com/tgbot-collection/teletweet
- Owner: tgbot-collection
- License: gpl-2.0
- Created: 2020-10-20T08:33:32.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-01-15T20:07:10.000Z (over 1 year ago)
- Last Synced: 2024-05-01T19:57:13.447Z (over 1 year ago)
- Topics: bot-tweet-message, telegram-twitter-bot, telegrambot, tweets, twitter-bot, video-tweet
- Language: Python
- Homepage:
- Size: 11.3 MB
- Stars: 54
- Watchers: 5
- Forks: 17
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TwitterBot
🦉 A telegram Twitter bot that will allow you to send tweets!
Supports Twitter API v2! 🎉🎉🎉🎉🎉🎉
# This bot runs perfectly on DartNode!
Find out more on [DartNode](https://dartnode.com/?via=benny)
# Features
All the following features rely on authorized users.
* send text tweet
* send tweet with one photo(photo and document are supported.)
* reply bot tweet message to add more tweets to this thread
* reply `/delete` to delete tweet
* ~~send any video tweet to download the video~~ If you have Basic or Access subscription, you can download video tweet.
* send pictures as media group, it will result in multiple photos in your tweet(max photo restrictions is 4)
# Commands
```
start - Start using it today
sign_in - Go to sign in with Twitter
sign_off - sign off from Twitter
help - What is this bot
ping - Status about this bot
delete - Delete tweet
```
# Usage
## Screenshots
The most simple way to tweet!
## Sign in
Chat with [this bot](https://t.me/tele_tweetbot), and go to oauth by its instruction:
Copy and paste the auth code to this bot. And you're good to go!
## Tweet
### New thread tweet
Send any text message, photo/photo as file with caption will send tweet with photos.
### Reply to this thread
Reply to bot's tweet message,
and you'll consult in a series of thread.
## Delete tweet
Reply command `/delete` to bot's message and it will delete this tweet for you.
## Download tweet video
**ONLY WORKS IF YOU HAVE BASIC OR PRO SUBSCRIOTION**
You could just send any video tweet, such as this one
https://twitter.com/BennyThinks/status/1306081739660427264?s=20
The bot will first determine if this is a video tweet, if the answer is yes,
it will ask what do you want to do with it:
Depending on your choice, this bot will download this video or retweet.
## multiple photo mode
**Group feature requires a newer version of Telegram**
Just send a group of photos, add some captions if you want to, and hit send.
**Warning: if you send more than four photos in a group, this bot will only send first four photos in a tweet**
# General deployment
This bot use oauth, so you need to apply an app, setup callback url.
## Setup Twitter Developer
1. Apply a Twitter Developer account https://developer.twitter.com/en/portal/dashboard
2. Create a project
3. Create an app and attach it to your project. Remember API key and API secret key!
4. User authentication settings, Click Edit and enable OAuth
5. App permissions Read/Write, Web App, Automated App or Bot, Callback `http://127.0.0.1:8888/callback`
## Setup Telegram APP ID
Get it from https://core.telegram.org/
## Run Web server
```shell script
vim twauth.py
# change this three lines to your own
# CONSUMER_KEY ---> API key
# CONSUMER_SECRET ---> API secret key
APP_CONSUMER_KEY = os.environ.get("CONSUMER_KEY") or '1'
APP_CONSUMER_SECRET = os.environ.get("CONSUMER_SECRET") or '2'
callback_url = os.environ.get("CALLBACK_URL") or "http://127.0.0.1:8888/callback"
# run it
python3 twauth.py
```
Open `http://127.0.0.1:8888` in your browser and follow the instructions.
## Run Bot
```shell script
git clone https://github.com/tgbot-collection/TeleTweet/
cd TeleTweet
pip3 install -r requirements.txt
vim teletweet/config.py
# setup bot token, consumer key, consumer secret, app id, app secret
python3 teletweet/bot.py
```
If you want the bot to be only available to you, please setup `ALLOW_USER` with your own Telegram User ID.
Use `,` to separate.
Send `/sign_in` to bot,paste your auth code, and you're good to go!
# Docker
You can run/develop using docker. You can refer to `docker-compose.yml`
```shell
echo "{}"> env/auth.json
vim env/teletweet.env
# set up below config
BOT_TOKEN = os.getenv("TOKEN", "fghjk789")
APP_ID = os.getenv("APP_ID", "456fgh78")
APP_HASH = os.getenv("APP_HASH", "456gfhj78")
CONSUMER_KEY = os.getenv("CONSUMER_KEY", "456fghj78")
CONSUMER_SECRET = os.getenv("CONSUMER_SECRET", "45678fghj")
docker-compose up -d
```
# Plans
- [x] support multi-user, based on oauth
- [x] help
- [x] about
- [x] start
- [x] multi photo
# Credits
* [twauth-web](https://github.com/twitterdev/twauth-web)
# License
GPL 2.0__