Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/franciscod/telegram-twitter-forwarder-bot
A Telegram bot that forwards Tweets
https://github.com/franciscod/telegram-twitter-forwarder-bot
Last synced: 4 days ago
JSON representation
A Telegram bot that forwards Tweets
- Host: GitHub
- URL: https://github.com/franciscod/telegram-twitter-forwarder-bot
- Owner: franciscod
- License: lgpl-3.0
- Created: 2015-11-13T23:19:37.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T07:36:41.000Z (almost 2 years ago)
- Last Synced: 2024-08-01T20:49:40.787Z (3 months ago)
- Language: Python
- Homepage:
- Size: 252 KB
- Stars: 317
- Watchers: 17
- Forks: 117
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - franciscod/telegram-twitter-forwarder-bot - A Telegram bot that forwards Tweets (Python)
README
# telegram-twitter-forwarder-bot
Hello! This projects aims to make a [Telegram](https://telegram.org) bot that forwards [Twitter](https://twitter.com/) updates to people, groups, channels, or whatever Telegram comes up with!
It was once hosted on Telegram as
[@TwitterForwarderBot](https://telegram.me/TwitterForwarderBot) which doesn't
work anymore. There are a few other instances running around:
- (add a Pull Request linking to your instance here!)
## Credit where credit is due
This is based on former work:
- [python-telegram-bot](https://github.com/leandrotoledo/python-telegram-bot)
- [tweepy](https://github.com/tweepy/tweepy)
- [peewee](https://github.com/coleifer/peewee)
- also, python, pip, the internets, and so on
So, big thanks to anyone who contributed on these projects! :D
## How do I run this?
1. clone this thing
2. fill secrets.py (see next readme section)
3. (optional) create your virtualenv, activate it, etc, e.g.:
```
virtualenv -p python3 venv
. venv/bin/activate
```
4. `pip install -r requirements.txt`
5. run it! `python main.py`
## secrets.py?? what is that?
This bot requires a few tokens that identify it both on Twitter and Telegram. This configuration should be present on the `secrets.py` file.
There's a skeleton of that on `example-secrets.py`, start by copying it to `secrets.py`. The second one is the one you should change.
First, you'll need a Telegram Bot Token, you can get it via BotFather ([more info here](https://core.telegram.org/bots)).
Also, setting this up will need an Application-only authentication token from Twitter ([more info here](https://dev.twitter.com/oauth/application-only)). Optionally, you can provide a user access token and secret.
You can get this by creating a Twitter App [here](https://apps.twitter.com/).
Bear in mind that if you don't have added a mobile phone to your Twitter account you'll get this:
>You must add your mobile phone to your Twitter profile before creating an application. Please read https://support.twitter.com/articles/110250-adding-your-mobile-number-to-your-account-via-web for more information.
Get a consumer key, consumer secret, access token and access token secret (the latter two are optional), fill in your `secrets.py`, and then run the bot!
## Setting up cronjob
_contributed by @llg, thanks!_
**Make sure crontab user have write access to venv directory**
1. use examples/cron-run.sh script in cron:
`* * * * * cd /path/to/telegram-twitter-forwarder-bot && examples/cron-run.sh >> /dev/null 2>&1`
2. you can change time for checking to any you want