insta-tweet 2.0.0b8

Automatically Repost Content From Instagram to Twitter

InstaTweet

Automatically Repost Content From Instagram to Twitter

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.

What's InstaTweet?

InstaTweet is a tool that automatically reposts content from Instagram to Twitter.

Simply create a Profile, configure the necessary settings, and add the Instagram users you'd like repost from. InstaTweet will then periodically scrape their accounts and, if new posts are detected, they'll be automatically downloaded and posted to Twitter.

Once you've got a Profile set up, using InstaTweet is as simple as:

from InstaTweet import InstaTweet

insta_tweet = InstaTweet.load('myProfile')
insta_tweet.start()

The scheduler can also be used (remotely and locally) to InstaTweet your profile(s)

https://github.com/TDKorn/insta-tweet/blob/1d862bf0c7d04109f5b9e1fe0cb39ac78ed4b114/scheduler.py#L1-L19

Why?

InstaTweet has two main use cases:

1. To automatically share your own Instagram posts to Twitter
2. To automatically tweet new content from other Instagram users

Regardless of your intention, InstaTweet will detect new posts from the users you specify, download them, and repost them to Twitter.

Documentation

Documentation can be found on Read the Docs

Installation

InstaTweet is compatible with Python 3.8 or higher.

To install from PyPi using pip:

pip install insta-tweet

Getting Started

InstaTweet uses the Profile class to help manage Twitter accounts, Instagram sessions, and user maps.

https://github.com/TDKorn/insta-tweet/blob/d08a18a8089c0c2f92c0bf387f7561d0487af0d2/InstaTweet/profile.py#L12-L70

You must create a Profile and validate() the settings before you can run InstaTweet.

NOTE: Although Profiles can be saved (remotely or locally), a Profile doesn't need to be saved to be InstaTweeted

Creating a Profile

A Profile can be configured by specifying arguments at the time of initialization, or by setting object attributes at any point afterwards.

from InstaTweet import Profile

# Initialize a Profile with arguments
p = Profile(
  name='myProfile',
  local=True,
  session_id='SNKIASFD93WI4R920DWQ',
  proxy_key='QUOTAGUARD_STATIC'
)

# Initialize with no arguments and set attributes after
q = Profile()
q.name = 'myProfile'
q.local = True
q.session_id = 'SNKIASFD93WI4R920DWQ'
q.proxy_key = 'QUOTAGUARD_STATIC'

print("Profiles have the same settings: {}".format(p.config==q.config))
print('Profile Config: ')
p.view_config()

Output:

Profiles have the same settings: True
Profile Config: 
name : myProfile
local : True
session_id : SNKIASFD93WI4R920DWQ
twitter_keys : {'Consumer Key': 'string', 'Consumer Secret': 'string', 'Access Token': 'string', 'Token Secret': 'string'}
user_agent : Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.5005.63 Safari/537.36
proxy_key : QUOTAGUARD_STATIC
user_map : {}

Profile Settings

As seen above, a Profile can be created without any arguments or attributes set -- there are no requirements until it comes to actually InstaTweeting the Profile, at which point there are both mandatory and optional settings

• Mandatory settings will have their data type validated by property setters
• Mandatory settings will have their actual values validated when validate() is called (the first step of InstaTweet.start())

---

Mandatory Settings

• session_id — Instagram Sessionid Cookie, obtained by logging in on a desktop browser
• twitter_keys — Twitter API Keys with v1.1 endpoint access

Mandatory Settings with Default Values

• name="default" — Profile name; a unique, non-default name is needed to save the Profile, but not to InstaTweet it
• local=True — Indicates if the profile should be saved locally (default) or uploaded to a remote database
• user_agent=utils.get_agent() — User agent to use when making requests to Instagram/Twitter

Entirely Optional Settings

• proxy_key — Environment variable to retrieve proxies from when making requests to Instagram/Twitter
• user_map — Fully formatted dictionary of IG usernames mapped to their USER_MAPPING

As tweets are sent, each profile will update its `user_map` – a mapping of Instagram usernames to their associated lists of:
* ```hashtags``` — the user's associated hashtag list (for use when composing tweets)
* ```scraped``` — the list of posts that have been scraped from the user (only the post id)
* ```tweets``` — the list of sent tweets containing media scraped from that user (limited data)

<br>

***

# STUFF I NEED TO EDIT

## Populating the User Map

The user map is a mapping of Instagram usernames to their associated ```USER_MAPPING```

https://github.com/TDKorn/insta-tweet/blob/dc904af214596588bfc75b32eccc1ff37d0c271b/InstaTweet/profile.py#L14

<br>

The mapping gets updated as InstaTweet runs, when posts are successfully scraped and tweeted from these users.
The ```Profile``` has methods to easily access and modify these mappings

### Adding Users

Use the ```add_users()``` method to add users to a Profile's user map

```python
from InstaTweet import Profile

>>> p = Profile('myProfile')
>>> p.add_users('username')

Added Instagram user @username to the user map

>>> usernames = ['user','names']
>>> p.add_users(usernames)

Added Instagram user @user to the user map
Added Instagram user @names to the user map

>>> p.view_config()

name : myProfile
local : True
session_id : 
twitter_keys : {'Consumer Key': 'string', 'Consumer Secret': 'string', 'Access Token': 'string', 'Token Secret': 'string'}
user_agent : Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.5005.63 Safari/537.36
proxy_key : None
user_map : {'username': {'hashtags': [], 'scraped': [], 'tweets': []}, 'user': {'hashtags': [], 'scraped': [], 'tweets': []}, 'names': {'hashtags': [], 'scraped': [], 'tweets': []}}

You can use the get_user() method to retrieve the mapping of a particular user

>>> print(p.get_user('names'))

{'hashtags': [], 'scraped': [], 'tweets': []}

---

Adding Hashtags

Use the add_hashtags() method to add hashtags to a specific user in the Profile's user map

>>> p.add_hashtags(user='username', hashtags='cool')

Added hashtags for @username

>>> hashtags = ['wow', 'okay']
>>> p.add_hashtags('user', hashtags)

Added hashtags for @user

>>> print(p.user_map)
{'username': {'hashtags': ['cool'], 'scraped': [], 'tweets': []}, 'user': {'hashtags': ['wow', 'okay'], 'scraped': [], 'tweets': []}, 'names': {'hashtags': [], 'scraped': [], 'tweets': []}}

You can use the get_hashtags_for() method to retrieve the hashtag list of a specific username

>>> print(p.get_hashtags_for('user'))

['wow', 'okay']

Saving a Profile

The profile can be saved either locally or to a SQLAlchemy supported database -- just set the DATABASE_URL environment variable

NOTE: Saving a Profile is not mandatory to run InstaTweet, but doing so allows for easy access to associated API settings as well as tracking of previously scraped & tweeted posts (which is used to determine which posts are new)

Call save() to save the profile using the current or specified profile name. The value of local determines the location and save format

• If local=True, the profile will be saved as a pickle file in the Profile.LOCAL_DIR

• Otherwise, the profile will be saved to the database specified by the DATABASE_URL environment variable

  • It gets converted to a pickle byte string (via to_pickle()), which is then used to add/update a row

https://github.com/TDKorn/insta-tweet/blob/dc904af214596588bfc75b32eccc1ff37d0c271b/InstaTweet/profile.py#L142-L147

Example:

>>> p = Profile('myProfile')
>>> p.save()

Saved Local Profile myProfile

Note that you can specify a new name for the profile at the time of saving, but it still must be unique

>>> q = Profile()
>>> q.save('aProfile')

Saved Local Profile aProfile

>>> q.save('myProfile')

FileExistsError: Local save file already exists for profile named "myProfile"
Please choose another name, load the profile, or delete the file.

You can see if a profile name already exists remotely or locally by calling the profile_exists() static method:

https://github.com/TDKorn/insta-tweet/blob/dc904af214596588bfc75b32eccc1ff37d0c271b/InstaTweet/profile.py#L79-L86