diff --git a/README.md b/README.md index cf49806c..a4fbe3d6 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -[![Package](https://github.com/adw0rd/instagrapi/actions/workflows/python-package.yml/badge.svg?branch=master)](https://github.com/adw0rd/instagrapi/actions/workflows/python-package.yml) +[![Package](https://github.com/subzeroid/instagrapi/actions/workflows/python-package.yml/badge.svg?branch=master)](https://github.com/subzeroid/instagrapi/actions/workflows/python-package.yml) [![PyPI](https://img.shields.io/pypi/v/instagrapi)](https://pypi.org/project/instagrapi/) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/instagrapi) ![Checked with mypy](https://img.shields.io/badge/mypy-checked-blue) @@ -7,7 +7,7 @@ [![Downloads](https://pepy.tech/badge/instagrapi/month)](https://pepy.tech/project/instagrapi) [![Downloads](https://pepy.tech/badge/instagrapi/week)](https://pepy.tech/project/instagrapi) -[![Donate](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/adw0rd) +[![Donate](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/subzeroid) Features: @@ -32,22 +32,22 @@ Fast and effective Instagram Private API wrapper (public+private requests and ch Support **Python >= 3.9** -For any other languages (e.g. C++, C#, F#, D, [Golang](https://github.com/adw0rd/instagrapi-rest/tree/main/golang), Erlang, Elixir, Nim, Haskell, Lisp, Closure, Julia, R, Java, Kotlin, Scala, OCaml, JavaScript, Crystal, Ruby, Rust, [Swift](https://github.com/adw0rd/instagrapi-rest/tree/main/swift), Objective-C, Visual Basic, .NET, Pascal, Perl, Lua, PHP and others), I suggest using [instagrapi-rest](https://github.com/adw0rd/instagrapi-rest) +For any other languages (e.g. C++, C#, F#, D, [Golang](https://github.com/subzeroid/instagrapi-rest/tree/main/golang), Erlang, Elixir, Nim, Haskell, Lisp, Closure, Julia, R, Java, Kotlin, Scala, OCaml, JavaScript, Crystal, Ruby, Rust, [Swift](https://github.com/subzeroid/instagrapi-rest/tree/main/swift), Objective-C, Visual Basic, .NET, Pascal, Perl, Lua, PHP and others), I suggest using [instagrapi-rest](https://github.com/subzeroid/instagrapi-rest) [Support Chat in Telegram](https://t.me/instagrapi) -![](https://gist.githubusercontent.com/m8rge/4c2b36369c9f936c02ee883ca8ec89f1/raw/c03fd44ee2b63d7a2a195ff44e9bb071e87b4a40/telegram-single-path-24px.svg) and [GitHub Discussions](https://github.com/adw0rd/instagrapi/discussions) +![](https://gist.githubusercontent.com/m8rge/4c2b36369c9f936c02ee883ca8ec89f1/raw/c03fd44ee2b63d7a2a195ff44e9bb071e87b4a40/telegram-single-path-24px.svg) and [GitHub Discussions](https://github.com/subzeroid/instagrapi/discussions) ## Features -1. Performs [Web API](https://adw0rd.github.io/instagrapi/usage-guide/fundamentals.html) or [Mobile API](https://adw0rd.github.io/instagrapi/usage-guide/fundamentals.html) requests depending on the situation (to avoid Instagram limits) -2. [Login](https://adw0rd.github.io/instagrapi/usage-guide/interactions.html) by username and password, including 2FA and by sessionid (and uses Authorization header instead Cookies) -3. [Challenge Resolver](https://adw0rd.github.io/instagrapi/usage-guide/challenge_resolver.html) have Email and SMS handlers -4. Support [upload](https://adw0rd.github.io/instagrapi/usage-guide/media.html) a Photo, Video, IGTV, Reels, Albums and Stories -5. Support work with [User](https://adw0rd.github.io/instagrapi/usage-guide/user.html), [Media](https://adw0rd.github.io/instagrapi/usage-guide/media.html), [Comment](https://adw0rd.github.io/instagrapi/usage-guide/comment.html), [Insights](https://adw0rd.github.io/instagrapi/usage-guide/insight.html), [Collections](https://adw0rd.github.io/instagrapi/usage-guide/collection.html), [Location](https://adw0rd.github.io/instagrapi/usage-guide/location.html) (Place), [Hashtag](https://adw0rd.github.io/instagrapi/usage-guide/hashtag.html) and [Direct Message](https://adw0rd.github.io/instagrapi/usage-guide/direct.html) objects -6. [Like](https://adw0rd.github.io/instagrapi/usage-guide/media.html), [Follow](https://adw0rd.github.io/instagrapi/usage-guide/user.html), [Edit account](https://adw0rd.github.io/instagrapi/usage-guide/account.html) (Bio) and much more else -7. [Insights](https://adw0rd.github.io/instagrapi/usage-guide/insight.html) by account, posts and stories -8. [Build stories](https://adw0rd.github.io/instagrapi/usage-guide/story.html) with custom background, font animation, link sticker and mention users +1. Performs [Web API](https://subzeroid.github.io/instagrapi/usage-guide/fundamentals.html) or [Mobile API](https://subzeroid.github.io/instagrapi/usage-guide/fundamentals.html) requests depending on the situation (to avoid Instagram limits) +2. [Login](https://subzeroid.github.io/instagrapi/usage-guide/interactions.html) by username and password, including 2FA and by sessionid (and uses Authorization header instead Cookies) +3. [Challenge Resolver](https://subzeroid.github.io/instagrapi/usage-guide/challenge_resolver.html) have Email and SMS handlers +4. Support [upload](https://subzeroid.github.io/instagrapi/usage-guide/media.html) a Photo, Video, IGTV, Reels, Albums and Stories +5. Support work with [User](https://subzeroid.github.io/instagrapi/usage-guide/user.html), [Media](https://subzeroid.github.io/instagrapi/usage-guide/media.html), [Comment](https://subzeroid.github.io/instagrapi/usage-guide/comment.html), [Insights](https://subzeroid.github.io/instagrapi/usage-guide/insight.html), [Collections](https://subzeroid.github.io/instagrapi/usage-guide/collection.html), [Location](https://subzeroid.github.io/instagrapi/usage-guide/location.html) (Place), [Hashtag](https://subzeroid.github.io/instagrapi/usage-guide/hashtag.html) and [Direct Message](https://subzeroid.github.io/instagrapi/usage-guide/direct.html) objects +6. [Like](https://subzeroid.github.io/instagrapi/usage-guide/media.html), [Follow](https://subzeroid.github.io/instagrapi/usage-guide/user.html), [Edit account](https://subzeroid.github.io/instagrapi/usage-guide/account.html) (Bio) and much more else +7. [Insights](https://subzeroid.github.io/instagrapi/usage-guide/insight.html) by account, posts and stories +8. [Build stories](https://subzeroid.github.io/instagrapi/usage-guide/story.html) with custom background, font animation, link sticker and mention users 9. In the next release, account registration and captcha passing will appear ## Examples of apps that use instagrapi @@ -84,14 +84,14 @@ cl.login(USERNAME, PASSWORD, verification_code="<2FA CODE HERE>") media_pk = cl.media_pk_from_url('https://www.instagram.com/p/CGgDsi7JQdS/') media_path = cl.video_download(media_pk) -adw0rd = cl.user_info_by_username('adw0rd') +subzeroid = cl.user_info_by_username('subzeroid') hashtag = cl.hashtag_info('dhbastards') cl.video_upload_to_story( media_path, - "Credits @adw0rd", - mentions=[StoryMention(user=adw0rd, x=0.49892962, y=0.703125, width=0.8333333333333334, height=0.125)], - links=[StoryLink(webUri='https://github.com/adw0rd/instagrapi')], + "Credits @subzeroid", + mentions=[StoryMention(user=subzeroid, x=0.49892962, y=0.703125, width=0.8333333333333334, height=0.125)], + links=[StoryLink(webUri='https://github.com/subzeroid/instagrapi')], hashtags=[StoryHashtag(hashtag=hashtag, x=0.23, y=0.32, width=0.5, height=0.22)], medias=[StoryMedia(media_pk=media_pk, x=0.5, y=0.5, width=0.6, height=0.8)] ) @@ -100,44 +100,44 @@ cl.video_upload_to_story( ## Documentation -* [Index](https://adw0rd.github.io/instagrapi/) -* [Getting Started](https://adw0rd.github.io/instagrapi/getting-started.html) -* [Usage Guide](https://adw0rd.github.io/instagrapi/usage-guide/fundamentals.html) -* [Interactions](https://adw0rd.github.io/instagrapi/usage-guide/interactions.html) - * [`Media`](https://adw0rd.github.io/instagrapi/usage-guide/media.html) - Publication (also called post): Photo, Video, Album, IGTV and Reels - * [`Resource`](https://adw0rd.github.io/instagrapi/usage-guide/media.html) - Part of Media (for albums) - * [`MediaOembed`](https://adw0rd.github.io/instagrapi/usage-guide/media.html) - Short version of Media - * [`Account`](https://adw0rd.github.io/instagrapi/usage-guide/account.html) - Full private info for your account (e.g. email, phone_number) - * [`TOTP`](https://adw0rd.github.io/instagrapi/usage-guide/totp.html) - 2FA TOTP helpers (generate seed, enable/disable TOTP, generate code as Google Authenticator) - * [`User`](https://adw0rd.github.io/instagrapi/usage-guide/user.html) - Full public user data - * [`UserShort`](https://adw0rd.github.io/instagrapi/usage-guide/user.html) - Short public user data (used in Usertag, Comment, Media, Direct Message) - * [`Usertag`](https://adw0rd.github.io/instagrapi/usage-guide/user.html) - Tag user in Media (coordinates + UserShort) - * [`Location`](https://adw0rd.github.io/instagrapi/usage-guide/location.html) - GEO location (GEO coordinates, name, address) - * [`Hashtag`](https://adw0rd.github.io/instagrapi/usage-guide/hashtag.html) - Hashtag object (id, name, picture) - * [`Collection`](https://adw0rd.github.io/instagrapi/usage-guide/collection.html) - Collection of medias (name, picture and list of medias) - * [`Comment`](https://adw0rd.github.io/instagrapi/usage-guide/comment.html) - Comments to Media - * [`Highlight`](https://adw0rd.github.io/instagrapi/usage-guide/highlight.html) - Highlights - * [`Notes`](https://adw0rd.github.io/instagrapi/usage-guide/notes.html) - Notes - * [`Story`](https://adw0rd.github.io/instagrapi/usage-guide/story.html) - Story - * [`StoryLink`](https://adw0rd.github.io/instagrapi/usage-guide/story.html) - Link Sticker - * [`StoryLocation`](https://adw0rd.github.io/instagrapi/usage-guide/story.html) - Tag Location in Story (as sticker) - * [`StoryMention`](https://adw0rd.github.io/instagrapi/usage-guide/story.html) - Mention users in Story (user, coordinates and dimensions) - * [`StoryHashtag`](https://adw0rd.github.io/instagrapi/usage-guide/story.html) - Hashtag for story (as sticker) - * [`StorySticker`](https://adw0rd.github.io/instagrapi/usage-guide/story.html) - Tag sticker to story (for example from giphy) - * [`StoryBuild`](https://adw0rd.github.io/instagrapi/usage-guide/story.html) - [StoryBuilder](/instagrapi/story.py) return path to photo/video and mention co-ordinates - * [`DirectThread`](https://adw0rd.github.io/instagrapi/usage-guide/direct.html) - Thread (topic) with messages in Direct Message - * [`DirectMessage`](https://adw0rd.github.io/instagrapi/usage-guide/direct.html) - Message in Direct Message - * [`Insight`](https://adw0rd.github.io/instagrapi/usage-guide/insight.html) - Insights for a post - * [`Track`](https://adw0rd.github.io/instagrapi/usage-guide/track.html) - Music track (for Reels/Clips) -* [Best Practices](https://adw0rd.github.io/instagrapi/usage-guide/best-practices.html) -* [Development Guide](https://adw0rd.github.io/instagrapi/development-guide.html) -* [Handle Exceptions](https://adw0rd.github.io/instagrapi/usage-guide/handle_exception.html) -* [Challenge Resolver](https://adw0rd.github.io/instagrapi/usage-guide/challenge_resolver.html) -* [Exceptions](https://adw0rd.github.io/instagrapi/exceptions.html) +* [Index](https://subzeroid.github.io/instagrapi/) +* [Getting Started](https://subzeroid.github.io/instagrapi/getting-started.html) +* [Usage Guide](https://subzeroid.github.io/instagrapi/usage-guide/fundamentals.html) +* [Interactions](https://subzeroid.github.io/instagrapi/usage-guide/interactions.html) + * [`Media`](https://subzeroid.github.io/instagrapi/usage-guide/media.html) - Publication (also called post): Photo, Video, Album, IGTV and Reels + * [`Resource`](https://subzeroid.github.io/instagrapi/usage-guide/media.html) - Part of Media (for albums) + * [`MediaOembed`](https://subzeroid.github.io/instagrapi/usage-guide/media.html) - Short version of Media + * [`Account`](https://subzeroid.github.io/instagrapi/usage-guide/account.html) - Full private info for your account (e.g. email, phone_number) + * [`TOTP`](https://subzeroid.github.io/instagrapi/usage-guide/totp.html) - 2FA TOTP helpers (generate seed, enable/disable TOTP, generate code as Google Authenticator) + * [`User`](https://subzeroid.github.io/instagrapi/usage-guide/user.html) - Full public user data + * [`UserShort`](https://subzeroid.github.io/instagrapi/usage-guide/user.html) - Short public user data (used in Usertag, Comment, Media, Direct Message) + * [`Usertag`](https://subzeroid.github.io/instagrapi/usage-guide/user.html) - Tag user in Media (coordinates + UserShort) + * [`Location`](https://subzeroid.github.io/instagrapi/usage-guide/location.html) - GEO location (GEO coordinates, name, address) + * [`Hashtag`](https://subzeroid.github.io/instagrapi/usage-guide/hashtag.html) - Hashtag object (id, name, picture) + * [`Collection`](https://subzeroid.github.io/instagrapi/usage-guide/collection.html) - Collection of medias (name, picture and list of medias) + * [`Comment`](https://subzeroid.github.io/instagrapi/usage-guide/comment.html) - Comments to Media + * [`Highlight`](https://subzeroid.github.io/instagrapi/usage-guide/highlight.html) - Highlights + * [`Notes`](https://subzeroid.github.io/instagrapi/usage-guide/notes.html) - Notes + * [`Story`](https://subzeroid.github.io/instagrapi/usage-guide/story.html) - Story + * [`StoryLink`](https://subzeroid.github.io/instagrapi/usage-guide/story.html) - Link Sticker + * [`StoryLocation`](https://subzeroid.github.io/instagrapi/usage-guide/story.html) - Tag Location in Story (as sticker) + * [`StoryMention`](https://subzeroid.github.io/instagrapi/usage-guide/story.html) - Mention users in Story (user, coordinates and dimensions) + * [`StoryHashtag`](https://subzeroid.github.io/instagrapi/usage-guide/story.html) - Hashtag for story (as sticker) + * [`StorySticker`](https://subzeroid.github.io/instagrapi/usage-guide/story.html) - Tag sticker to story (for example from giphy) + * [`StoryBuild`](https://subzeroid.github.io/instagrapi/usage-guide/story.html) - [StoryBuilder](/instagrapi/story.py) return path to photo/video and mention co-ordinates + * [`DirectThread`](https://subzeroid.github.io/instagrapi/usage-guide/direct.html) - Thread (topic) with messages in Direct Message + * [`DirectMessage`](https://subzeroid.github.io/instagrapi/usage-guide/direct.html) - Message in Direct Message + * [`Insight`](https://subzeroid.github.io/instagrapi/usage-guide/insight.html) - Insights for a post + * [`Track`](https://subzeroid.github.io/instagrapi/usage-guide/track.html) - Music track (for Reels/Clips) +* [Best Practices](https://subzeroid.github.io/instagrapi/usage-guide/best-practices.html) +* [Development Guide](https://subzeroid.github.io/instagrapi/development-guide.html) +* [Handle Exceptions](https://subzeroid.github.io/instagrapi/usage-guide/handle_exception.html) +* [Challenge Resolver](https://subzeroid.github.io/instagrapi/usage-guide/challenge_resolver.html) +* [Exceptions](https://subzeroid.github.io/instagrapi/exceptions.html) ## Contributing -[![List of contributors](https://opencollective.com/instagrapi/contributors.svg?width=890&button=0)](https://github.com/adw0rd/instagrapi/graphs/contributors) +[![List of contributors](https://opencollective.com/instagrapi/contributors.svg?width=890&button=0)](https://github.com/subzeroid/instagrapi/graphs/contributors) To release, you need to call the following commands: