Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yashraj-n/instagram-reddit-automation
A simple automation script that posts images from Reddit to Instagram.
https://github.com/yashraj-n/instagram-reddit-automation
automate instagram python reddit
Last synced: 3 days ago
JSON representation
A simple automation script that posts images from Reddit to Instagram.
- Host: GitHub
- URL: https://github.com/yashraj-n/instagram-reddit-automation
- Owner: yashraj-n
- License: mit
- Created: 2024-04-18T05:45:49.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2024-04-25T06:41:34.000Z (9 months ago)
- Last Synced: 2024-04-25T08:42:12.706Z (9 months ago)
- Topics: automate, instagram, python, reddit
- Language: Python
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Instagram-Reddit Automation
A simple automation script that posts images from Reddit to Instagram.
Key Features •
How To Use •
Credits •
License
## Key Features
- Fetches images from Reddit
- Posts images to Instagram
- Customizable settings
- Easy to use
- Easy Automation using GitHub Actions
- Use any subreddit
## Requirements
- Instagram Account
- Reddit Client ID and Secret
> 1. Goto [Reddit Apps](https://www.reddit.com/prefs/apps)
> 2. Click on "Create App" or "Create Another App"
> 3. Fill in the details
>  > 
- OPTIONAL: Sentry DSN
> Create a free account on [Sentry](https://sentry.io/) and get the DSN
- Upstash Redis URL
> Create a free account on [Upstash](https://upstash.com/) and get the Redis URL
> :warning: **It's Recommended to use a 2fa token to Login with Intagram**: Get a 2FA token from [here](https://accountscenter.instagram.com/password_and_security/).
Check [.env.example](.env.example) for more details
## How To Use
You can either run the script locally or use GitHub Actions to automate the process.
### Local
To clone and run this application, you'll need [Git](https://git-scm.com) and [Python](https://www.python.org/) installed on your computer. From your command line:
```bash
# Clone this repository
$ git clone https://github.com/yashraj-n/Instagram-Reddit-Automation
# Go into the repository
$ cd Instagram-Reddit-Automation
# Install dependencies
$ pip install -r requirements.txt
```
Rename `.env.example` to `.env` and fill in the required details.
Get Upstash Redis URL from [here](https://upstash.com/)
OPTIONAL: You can also use Sentry for error tracking. Get the DSN from [here](https://sentry.io/)
Run the script
```bash
# Run the app
$ python main.py
```
### GitHub Actions
1. Fork this repository
2. Go to the repository settings and add the following secrets
```bash
INSTA_USERNAME - Your Instagram Username
INSTA_PASSWORD - Your Instagram Password
SUBREDDIT - The subreddit you want to fetch images from
UPSTASH_REDIS_REST_URL - Upstash Redis URL
UPSTASH_REDIS_REST_TOKEN - Upstash Redis Token
SENTRY_URL - Sentry DSN (Optional)
REDDIT_CLIENT_ID - Reddit Client ID
REDDIT_CLIENT_SECRET - Reddit Client Secret
TOTP_SECRET - 2FA Token for Instagram Login (Optional but Recommended)
```
3. Go to the Actions tab and enable workflows
4. You can also customize the schedule in `.github/workflows/Automate.yml`
## Credits
This repo uses [subzeroid/instagrapi](https://github.com/subzeroid/instagrapi)'s api for posting images to Instagram and [PRAW](https://praw.readthedocs.io/) to fetch images from Reddit.
## License
[MIT](LICENSE)