Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ibnaleem/instatracker
📸 an Instagram tracking script that logs any changes to an Instagram account (followers, following, posts, and bio) written in Python.
https://github.com/ibnaleem/instatracker
cybersecurity information-gathering infosec instagram instagram-api instagram-bot instagram-downloader instagram-scraper instagram-tool osint osint-framework osint-python osint-reconnaissance osint-resources osint-tool osint-toolkit redteam redteaming
Last synced: 7 days ago
JSON representation
📸 an Instagram tracking script that logs any changes to an Instagram account (followers, following, posts, and bio) written in Python.
- Host: GitHub
- URL: https://github.com/ibnaleem/instatracker
- Owner: ibnaleem
- License: mit
- Created: 2024-06-30T00:20:29.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-11-18T21:20:37.000Z (about 1 month ago)
- Last Synced: 2024-11-18T22:24:06.774Z (about 1 month ago)
- Topics: cybersecurity, information-gathering, infosec, instagram, instagram-api, instagram-bot, instagram-downloader, instagram-scraper, instagram-tool, osint, osint-framework, osint-python, osint-reconnaissance, osint-resources, osint-tool, osint-toolkit, redteam, redteaming
- Language: Python
- Homepage:
- Size: 214 KB
- Stars: 58
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
InstaTracker
📸 an Instagram tracker that logs any changes to an Instagram account (followers, following, posts, and bio)
Report Bugs
---------------------------------------
```
python3 main.py -h
usage: Instagram Tracker [-h] -u USERNAME
📸 an Instagram tracker that logs any changes to an Instagram account
(followers, following, posts, and bio)
options:
-h, --help show this help message and exit
-u USERNAME, --username USERNAME
The username of the account to track
🤝 Contribute: https://github.com/ibnaleem/instatracker
```
> [!IMPORTANT]
> You must login to *your* Instagram account in order to properly scrape someone else's Instagram account. This is due to Instagram blocking `HTTPS GET` requests from unauthenticated cookies. Your login information is never stored. See more [here](https://github.com/ibnaleem/instatracker/blob/main/main.py#L51C1-L56C136) and [here](https://github.com/instaloader/instaloader/blob/master/instaloader/instaloadercontext.py#L253C1-L338C43).
> [!TIP]
> You can always create/use an alt-account for the interative login.
## Installation
> [!TIP]
> [Install Python if you don't have it already](https://www.python.org/downloads/)
#### Clone this repository:
```
$ git clone https://github.com/ibnaleem/instatracker.git
```
#### Install dependencies:
```
$ pip install -r requirements.txt
```
#### Set `user` & `passwd` field on [line 71](https://github.com/ibnaleem/instatracker/blob/main/main.py#L71)
```python
self.bot.login(user="YOUR INSTAGRAM USERNAME", passwd="YOUR INSTAGRAM PASSWORD") # this allows us to access & scrape Instagram.
```
#### Run the script
```
$ python3 main.py -u USERNAME
```
## Automated Logging
InstaTracker not only displays all modifications an Instagram account makes directly to the terminal (e.g., *USERNAME has unfollowed 1 person*), but it also records these changes in a text file, including the date and time.
```
------2024-06-30 01:01:13.659694+00:00------
johndoe has 100
johndoe is following 100 people
johndoe has 0 posts
johndoe has the following bio: this is my biography
------2024-06-31 02:03:15.761715+00:00------
johndoe has lost 2 followers (100 followers --> 98 followers)
------2024-06-31 05:03:15.761715+00:00------
johndoe has gained 5 followers (98 followers --> 103 followers)
...
```
This script checks for any changes every 5 minutes because Instagram's firewall starts blocking requests that are sent too quickly. You can manually update this [here](https://github.com/ibnaleem/instatracker/blob/main/main.py#L70), but do not be surprised if the script stops working.
## Built With
- [Python](https://www.python.org/)
- [Instaloader](https://github.com/instaloader/instaloader)
- [Rich](https://github.com/Textualize/rich)
## LICENSE
This repository is under the [MIT License](https://github.com/ibnaleem/instatracker/blob/main/LICENSE)
## Created By
[Ibn Aleem](https://www.linkedin.com/in/shaffan-aleem-b7a852255/)
## Contributing
I welcome contributions from the community and appreciate the time and effort put into making [InstaTracker](https://github.com/ibnaleem/InstaTracker) better. To contribute, please follow the guidelines and steps outlined below:
> Note: **_Your pull request will be closed if you do not specify the changes you've made._**
### Fork the Repository
Start by [forking this repository](https://github.com/ibnaleem/InstaTracker/fork). You can do this by clicking on the ["Fork"](https://github.com/ibnaleem/InstaTracker/fork) button located at the top right corner of the GitHub page. This will create a personal copy of the repository under your own GitHub account.
### Clone the Repository
Next, clone the forked repository to your local machine using the following command:
```bash
$ git clone https://github.com/yourusername/instatracker.git
```
Navigate to the cloned directory:
```bash
$ cd instatracker
```
### Create a New Branch
Before making any changes, it's recommended to create a new branch. This ensures that your changes won't interfere with other contributions and keeps the main branch clean. Use the following command to create and switch to a new branch:
```bash
$ git checkout -b branch-name
```
### Make the Desired Changes
Now, you can proceed to make your desired changes to the project. Whether it's fixing bugs, adding new features, improving documentation, or optimising code, your efforts will be instrumental in enhancing the project.
### Commit and Push Changes
Once you have made the necessary changes, commit your work using the following commands:
```bash
$ git add .
$ git commit -m "Your commit message"
```
Push the changes to your forked repository:
```bash
$ git push origin branch-name
```
### Submit a Pull Request
Head over to the [original repository](https://github.com/ibnaleem/instatracker) on GitHub and go to the ["Pull requests"](https://github.com/ibnaleem/instatracker/pulls) tab.
1. Click on the "New pull request" button.
2. Select your forked repository and the branch containing your changes.
3. Provide a clear and informative title for your pull request, and use the description box to explain the modifications you have made. **_Your pull request will be closed if you do not specify the changes you've made._**
4. Finally, click on the "Create pull request" button to submit your changes.
## [PGP Fingerprint](https://github.com/ibnaleem/ibnaleem/blob/main/public_key.asc)
```
2024 7EC0 23F2 769E 6618 1C0F 581B 4A2A 862B BADE
```
     