Ever tried sharing an Instagram post to Twitter, only to find out that all you tweeted was a link, and not the actual photo/video?
| ⚠ Humiliating 🤮 |
|---|
That could be literally anything. Nobody will click it. |
InstaTweet shares the actual content of the post. Not just a link to it.
With InstaTweet, you can rest easy knowing that, although nobody will click the link,
they'll at least see what you posted.
...
InstaTweet is a customizable tool to automatically repost content from Instagram to Twitter.
Simply create a Profile, configure the mandatory settings, and add_pages() to repost from
from InstaTweet import Profile
# Create a new (local) Profile
>>> profile = Profile('myProfile')
# Configure the mandatory settings (at minimum)
>>> profile.twitter_keys = twitter_api_keys
>>> profile.session_id = '6011991A'
# Add at least one Instagram page (user/hashtag) to repost from
>>> profile.add_pages(['the.dailykitten', '#thedailykitten'])
# Save the Profile [optional]
>>> profile.save()
Saved Local Profile myProfileOnce configured, the Profile can be used to initialize and start() InstaTweet:
from InstaTweet import InstaTweet
# Directly initialize with a Profile object
>>> insta_tweet = InstaTweet(profile)
# Or load a saved Profile by name
>>> insta_tweet = InstaTweet.load("myProfile")
# Run InstaTweet by calling start()
>>> insta_tweet.start()
As InstaTweet runs, its progress will be logged to console:
Starting InstaTweet for Profile: myProfile
Checking posts from @the.dailykitten
...
Checking posts from #thedailykitten
...
Finished insta-tweeting for #thedailykitten
All pages have been insta-tweeted...
| 🐥 But Why? 🤨 |
|---|
InstaTweet has two main use cases:
Regardless of your intention, InstaTweet will detect new posts from the pages you specify, download them, and repost them to Twitter. |
...
Other Use Case: The InstaClient
The package's custom InstaClient can also be used as a standalone Instagram scraper
from InstaTweet import InstaClient
>>> ig = InstaClient(session_id="kjfdn309wredsfl")
# Scrape Instagram user or hashtag
>>> user = ig.get_user('dailykittenig')
>>> hashtag = ig.get_hashtag('#dailykitten')
>>> print(user, hashtag, sep='\n')
Instagram User: @dailykittenig
Instagram Hashtag: #dailykitten
# Download most recent post
>>> post = user.posts[0]
>>> print(post)
>>> ig.download_post(post)
Post 2981866202934977614 by @dailykittenig on 2022-11-29 01:44:37
Downloaded post https://www.instagram.com/p/Clht4NRrqRO by dailykittenig to C:\path\to\insta-tweet\downloads\2981866202934977614.mp4...
To install using pip:
pip install insta-tweetPlease note that InstaTweet requires Python >= 3.8
...
The rest of this README, the API documentation, and snippets can all be found on Read the Docs