.. meta::
:title: InstaTweet - Automatically Repost Content From Instagram to Twitter
:description: A Python package to automatically repost content from Instagram to Twitter
.. |.InstaTweet| replace:: InstaTweet
.. _.InstaTweet: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/instatweet.py#L5-L147
.. |.add_pages| replace:: add_pages()
.. _.add_pages: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/profile.py#L132-L165
.. |.Profile| replace:: Profile
.. _.Profile: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/profile.py#L11-L382
.. |.start| replace:: start()
.. _.start: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/instatweet.py#L71-L121
.. |.InstaClient| replace:: InstaClient
.. _.InstaClient: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/instaclient.py#L17-L180
.. |mandatory-settings| replace:: mandatory settings
.. _mandatory-settings: https://instatweet.readthedocs.io/en/latest/_readme/getting-started.html#mandatory-settings
.. _about-insta-tweet:
✨🐥 InstaTweet 🐤✨
-----------------------
.. image:: https://img.shields.io/pypi/v/insta-tweet
:target: https://pypi.org/project/insta-tweet/
:alt: PyPI Version
.. image:: https://img.shields.io/badge/GitHub-insta--tweet-4f1abc
:target: https://github.com/tdkorn/insta-tweet
:alt: GitHub Repository
.. image:: https://static.pepy.tech/personalized-badge/insta-tweet?period=total&units=none&left_color=grey&right_color=blue&left_text=Downloads
:target: https://pepy.tech/project/insta-tweet
.. image:: https://readthedocs.org/projects/instatweet/badge/?version=latest
:target: https://instatweet.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
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?
.. image:: https://instatweet.readthedocs.io/en/latest/_images/share_with_instagram.png
:alt: Sharing an Instagram post to Twitter directly from the Instagram app. Only a link appears.
It could be literally anything, nobody will click it.
+-------------------------------------------------------------+
| ⚠ Humiliating 🤮 |
+=============================================================+
| That could be literally anything. Nobody will click it. |
+-------------------------------------------------------------+
|
|.InstaTweet|_ **shares the** *actual* **content of the post. Not just a link to it.**
|
.. image:: https://instatweet.readthedocs.io/en/latest/_images/share_with_instatweet.png
:alt: Sharing an Instagram post to Twitter using InstaTweet. The actual photo or video appears in the tweet.
It's a thicc cat, very handsome. Nobody will click the link, but they'll definitely see this bad boy.
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 customizable tool to automatically repost content from Instagram to Twitter.
Simply create a |.Profile|_, configure the |mandatory-settings|_, and |.add_pages|_ to repost from
.. code-block:: python
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 myProfile
Once configured, the |.Profile|_ can be used to initialize and |.start|_ InstaTweet:
.. code-block:: python
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()
|
.. image:: https://user-images.githubusercontent.com/96394652/236979506-83d12d6f-114d-43ce-b4db-b062f8d0ed3a.png
:width: 700px
|
As ``InstaTweet`` runs, its progress will be logged to console:
.. code-block:: python
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
...
Okay... But Why? 😟
~~~~~~~~~~~~~~~~~~~~~~~
.. |why| replace:: 🐥 But Why? 🤨
+-----------------------------------------------------------------+
| |why| |
+=================================================================+
| **InstaTweet has two main use cases:** |
| |
| * To automatically share your own Instagram posts to Twitter |
| * 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. |
+-----------------------------------------------------------------+
...
Other Use Case: The |.InstaClient|_
======================================
The package's custom |.InstaClient|_ can also be used as a standalone Instagram scraper
.. code-block:: python
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
...
Installation
~~~~~~~~~~~~~~
To install using pip:
.. code-block:: shell
pip install insta-tweet
Please note that ``InstaTweet`` requires ``Python >= 3.8``
...
Documentation
~~~~~~~~~~~~~~~~~
The rest of this `README <https://instatweet.readthedocs.io/en/latest/_readme/getting-started.html>`_,
the `API documentation <https://instatweet.readthedocs.io/en/latest/modules.html>`_, and
`snippets <https://instatweet.readthedocs.io/en/latest/snippets.html>`_
can all be found on `Read the Docs <https://instatweet.readthedocs.io/en/latest/index.html>`_
Raw data
{
"_id": null,
"home_page": "https://www.github.com/TDKorn/insta-tweet/",
"name": "insta-tweet",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "instagram,twitter,api,instagram api,twitter api,repost,instagram repost,reposter",
"author": "Adam Korn",
"author_email": "hello@dailykitten.net",
"download_url": "https://files.pythonhosted.org/packages/95/e6/0a4cbc7c1acebbf6a79a1143c7eab0de9d041b848979ead747891ce25bd4/insta-tweet-2.2.1.tar.gz",
"platform": null,
"description": ".. meta::\n :title: InstaTweet - Automatically Repost Content From Instagram to Twitter\n :description: A Python package to automatically repost content from Instagram to Twitter\n\n.. |.InstaTweet| replace:: InstaTweet\n.. _.InstaTweet: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/instatweet.py#L5-L147\n.. |.add_pages| replace:: add_pages()\n.. _.add_pages: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/profile.py#L132-L165\n.. |.Profile| replace:: Profile\n.. _.Profile: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/profile.py#L11-L382\n.. |.start| replace:: start()\n.. _.start: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/instatweet.py#L71-L121\n.. |.InstaClient| replace:: InstaClient\n.. _.InstaClient: https://github.com/tdkorn/insta-tweet/blob/v2.2.1/InstaTweet/instaclient.py#L17-L180\n.. |mandatory-settings| replace:: mandatory settings\n.. _mandatory-settings: https://instatweet.readthedocs.io/en/latest/_readme/getting-started.html#mandatory-settings\n\n.. _about-insta-tweet:\n\n\u2728\ud83d\udc25 InstaTweet \ud83d\udc24\u2728\n-----------------------\n\n.. image:: https://img.shields.io/pypi/v/insta-tweet\n :target: https://pypi.org/project/insta-tweet/\n :alt: PyPI Version\n\n.. image:: https://img.shields.io/badge/GitHub-insta--tweet-4f1abc\n :target: https://github.com/tdkorn/insta-tweet\n :alt: GitHub Repository\n\n.. image:: https://static.pepy.tech/personalized-badge/insta-tweet?period=total&units=none&left_color=grey&right_color=blue&left_text=Downloads\n :target: https://pepy.tech/project/insta-tweet\n\n.. image:: https://readthedocs.org/projects/instatweet/badge/?version=latest\n :target: https://instatweet.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n\nAutomatically Repost Content From Instagram to Twitter\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nEver tried sharing an Instagram post to Twitter, only to find out that all you tweeted was a link, and not the actual photo/video?\n\n.. image:: https://instatweet.readthedocs.io/en/latest/_images/share_with_instagram.png\n :alt: Sharing an Instagram post to Twitter directly from the Instagram app. Only a link appears.\n It could be literally anything, nobody will click it.\n\n\n+-------------------------------------------------------------+\n| \u26a0 Humiliating \ud83e\udd2e |\n+=============================================================+\n| That could be literally anything. Nobody will click it. |\n+-------------------------------------------------------------+\n\n\n|\n\n|.InstaTweet|_ **shares the** *actual* **content of the post. Not just a link to it.**\n\n|\n\n.. image:: https://instatweet.readthedocs.io/en/latest/_images/share_with_instatweet.png\n :alt: Sharing an Instagram post to Twitter using InstaTweet. The actual photo or video appears in the tweet.\n It's a thicc cat, very handsome. Nobody will click the link, but they'll definitely see this bad boy.\n\n\nWith ``InstaTweet``, you can rest easy knowing that, although nobody will click the link,\nthey'll at least see what you posted.\n\n...\n\nWhat's InstaTweet?\n~~~~~~~~~~~~~~~~~~~~~\n\n|.InstaTweet|_ is a customizable tool to automatically repost content from Instagram to Twitter.\n\n\n\nSimply create a |.Profile|_, configure the |mandatory-settings|_, and |.add_pages|_ to repost from\n\n\n.. code-block:: python\n\n from InstaTweet import Profile\n\n # Create a new (local) Profile\n >>> profile = Profile('myProfile')\n\n # Configure the mandatory settings (at minimum)\n >>> profile.twitter_keys = twitter_api_keys\n >>> profile.session_id = '6011991A'\n\n # Add at least one Instagram page (user/hashtag) to repost from\n >>> profile.add_pages(['the.dailykitten', '#thedailykitten'])\n\n # Save the Profile [optional]\n >>> profile.save()\n\n Saved Local Profile myProfile\n\n\nOnce configured, the |.Profile|_ can be used to initialize and |.start|_ InstaTweet:\n\n.. code-block:: python\n\n from InstaTweet import InstaTweet\n\n # Directly initialize with a Profile object\n >>> insta_tweet = InstaTweet(profile)\n\n # Or load a saved Profile by name\n >>> insta_tweet = InstaTweet.load(\"myProfile\")\n\n # Run InstaTweet by calling start()\n >>> insta_tweet.start()\n\n\n|\n\n.. image:: https://user-images.githubusercontent.com/96394652/236979506-83d12d6f-114d-43ce-b4db-b062f8d0ed3a.png\n :width: 700px\n\n|\n\nAs ``InstaTweet`` runs, its progress will be logged to console:\n\n.. code-block:: python\n\n Starting InstaTweet for Profile: myProfile\n Checking posts from @the.dailykitten\n ...\n Checking posts from #thedailykitten\n ...\n Finished insta-tweeting for #thedailykitten\n All pages have been insta-tweeted\n\n...\n\nOkay... But Why? \ud83d\ude1f\n~~~~~~~~~~~~~~~~~~~~~~~\n\n\n.. |why| replace:: \ud83d\udc25 But Why? \ud83e\udd28\n\n+-----------------------------------------------------------------+\n| |why| |\n+=================================================================+\n| **InstaTweet has two main use cases:** |\n| |\n| * To automatically share your own Instagram posts to Twitter |\n| * To automatically tweet new content from other Instagram users |\n| |\n| Regardless of your intention, InstaTweet will detect new posts |\n| from the users you specify, download them, and repost them to |\n| Twitter. |\n+-----------------------------------------------------------------+\n\n\n...\n\n\nOther Use Case: The |.InstaClient|_\n======================================\n\nThe package's custom |.InstaClient|_ can also be used as a standalone Instagram scraper\n\n.. code-block:: python\n\n from InstaTweet import InstaClient\n\n >>> ig = InstaClient(session_id=\"kjfdn309wredsfl\")\n\n # Scrape Instagram user or hashtag\n >>> user = ig.get_user('dailykittenig')\n >>> hashtag = ig.get_hashtag('#dailykitten')\n >>> print(user, hashtag, sep='\\n')\n\n Instagram User: @dailykittenig\n Instagram Hashtag: #dailykitten\n\n # Download most recent post\n >>> post = user.posts[0]\n >>> print(post)\n >>> ig.download_post(post)\n\n Post 2981866202934977614 by @dailykittenig on 2022-11-29 01:44:37\n Downloaded post https://www.instagram.com/p/Clht4NRrqRO by dailykittenig to C:\\path\\to\\insta-tweet\\downloads\\2981866202934977614.mp4\n\n...\n\nInstallation\n~~~~~~~~~~~~~~\n\nTo install using pip:\n\n.. code-block:: shell\n\n pip install insta-tweet\n\n\nPlease note that ``InstaTweet`` requires ``Python >= 3.8``\n\n...\n\nDocumentation\n~~~~~~~~~~~~~~~~~\n\nThe rest of this `README <https://instatweet.readthedocs.io/en/latest/_readme/getting-started.html>`_,\nthe `API documentation <https://instatweet.readthedocs.io/en/latest/modules.html>`_, and\n`snippets <https://instatweet.readthedocs.io/en/latest/snippets.html>`_\ncan all be found on `Read the Docs <https://instatweet.readthedocs.io/en/latest/index.html>`_\n\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Automatically Repost Content From Instagram to Twitter",
"version": "2.2.1",
"project_urls": {
"Download": "https://github.com/TDKorn/insta-tweet/tarball/master/",
"Homepage": "https://www.github.com/TDKorn/insta-tweet/"
},
"split_keywords": [
"instagram",
"twitter",
"api",
"instagram api",
"twitter api",
"repost",
"instagram repost",
"reposter"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f7550e85b62a338742aa878f2a99d0b4bfa76f3903b62141a2ecf800a4d3c742",
"md5": "519aa3a9b4b00445d0211ff4a79734ea",
"sha256": "2f761a5f234a6b22ea0410ec141196f64e16e9a5f1bbc26b46449ca7989e999e"
},
"downloads": -1,
"filename": "insta_tweet-2.2.1-py3.10.egg",
"has_sig": false,
"md5_digest": "519aa3a9b4b00445d0211ff4a79734ea",
"packagetype": "bdist_egg",
"python_version": "2.2.1",
"requires_python": null,
"size": 50857,
"upload_time": "2023-06-15T09:06:22",
"upload_time_iso_8601": "2023-06-15T09:06:22.227073Z",
"url": "https://files.pythonhosted.org/packages/f7/55/0e85b62a338742aa878f2a99d0b4bfa76f3903b62141a2ecf800a4d3c742/insta_tweet-2.2.1-py3.10.egg",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ae4c1baed6339b5000670dacc401470c69b1db6c11c3520623a24c5634e640a3",
"md5": "d9d612d1e366e4d91427d915f2e7dc9d",
"sha256": "611d2a16e93cb0bd38aba05dd2eb0d194cf1d122d996901e156fb0d12ed03f5a"
},
"downloads": -1,
"filename": "insta_tweet-2.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d9d612d1e366e4d91427d915f2e7dc9d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 23594,
"upload_time": "2023-06-15T09:06:19",
"upload_time_iso_8601": "2023-06-15T09:06:19.113404Z",
"url": "https://files.pythonhosted.org/packages/ae/4c/1baed6339b5000670dacc401470c69b1db6c11c3520623a24c5634e640a3/insta_tweet-2.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "95e60a4cbc7c1acebbf6a79a1143c7eab0de9d041b848979ead747891ce25bd4",
"md5": "9da5a170662e641aab19567bc496a93d",
"sha256": "0c389869743d3f79902c5d70505f9edb1ab639050cc4cdbe0bbd4a48bc41e56f"
},
"downloads": -1,
"filename": "insta-tweet-2.2.1.tar.gz",
"has_sig": false,
"md5_digest": "9da5a170662e641aab19567bc496a93d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 20005,
"upload_time": "2023-06-15T09:06:21",
"upload_time_iso_8601": "2023-06-15T09:06:21.105144Z",
"url": "https://files.pythonhosted.org/packages/95/e6/0a4cbc7c1acebbf6a79a1143c7eab0de9d041b848979ead747891ce25bd4/insta-tweet-2.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-15 09:06:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TDKorn",
"github_project": "insta-tweet",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "tweepy",
"specs": [
[
">=",
"4.10.0"
]
]
},
{
"name": "requests",
"specs": []
},
{
"name": "sqlalchemy",
"specs": [
[
">=",
"1.4.36"
]
]
}
],
"lcname": "insta-tweet"
}
JSON
