Skip to content
This repository was archived by the owner on Jul 25, 2024. It is now read-only.

Home

Jump to bottom
sujay1599 edited this page Jul 18, 2024 · 1 revision

Instagram Thefty Poster V3.1 Wiki

Welcome to the Instagram Thefty Poster V3.1 Wiki! This guide will help you understand the program, its features, and how to use it effectively.

Table of Contents

  1. Overview
  2. Features
  3. Installation
  4. Configuration
  5. Usage
  6. Dashboard
  7. Troubleshooting
  8. Pitfalls
  9. FAQ
  10. Contributing
  11. License

Overview

Instagram Thefty Poster V3.1 is an advanced automation tool designed to manage Instagram reels more efficiently. This program automates the process of scraping, uploading, and managing Instagram reels in a way that mimics human behavior.

Features

  • Scraping Reels: Automatically scrape reels from specified Instagram profiles.
  • Uploading Reels: Upload scraped reels with new descriptions, optional hashtags, and credits.
  • Randomized Actions: Introduces random intervals between actions to simulate human behavior.
  • Dashboard: Provides a detailed overview of scraping and uploading activities.
  • Automated Scheduling: Schedules scraping, uploading, and deletion tasks at specified intervals.
  • Detailed Logging: Logs all actions for better traceability and debugging.

Installation

Prerequisites

  • Python 3.6+
  • Required Python packages (specified in requirements.txt)

Steps

  1. Clone the Repository:

    git clone https://github.com/sujay1599/InstagramTheftyPosterV3.1.git
cd InstagramTheftyPosterV3.1

  2. Install Required Packages:

    pip install -r requirements.txt

  3. Run Initial Setup:

    python start.py

    Follow the prompts to enter your configuration details. This will generate a config.yaml file with the necessary settings, including encrypted Instagram credentials.

Configuration

The config.yaml file will be generated by running start.py. It includes the following settings:

instagram:
  username: ENCRYPTED_USERNAME
  password: ENCRYPTED_PASSWORD
key: ENCRYPTION_KEY
scraping:
  enabled: true
  profiles: profile1 profile2
  num_reels: 10
  scrape_interval_minutes: 60
uploading:
  enabled: true
  upload_interval_minutes: 30
  add_to_story: true
description:
  use_original: true
  custom_description: ""
hashtags:
  use_hashtags: true
  hashtags_list: "#example #hashtags"
credit:
  give_credit: true
leave_comment: true
comments:
  - "Nice reel!"
  - "Great post!"
deleting:
  delete_interval_minutes: 1440
  • Instagram Credentials: Provide your Instagram username and password. These will be encrypted and stored securely.
  • Scraping Settings:
    • enabled: Set to true to enable scraping.
    • profiles: Space-separated list of Instagram profiles to scrape reels from.
    • num_reels: Number of reels to scrape per profile.
    • scrape_interval_minutes: Interval in minutes between scraping sessions.
  • Uploading Settings:
    • enabled: Set to true to enable uploading.
    • upload_interval_minutes: Interval in minutes between uploads.
    • add_to_story: Set to true to add reels to your Instagram story.
  • Description Settings:
    • use_original: Set to true to use the original reel description. If false, you will be prompted to enter a custom description.
    • custom_description: The custom description to use if use_original is false.
  • Hashtags Settings:
    • use_hashtags: Set to true to use hashtags in the reel descriptions.
    • hashtags_list: List of hashtags to include in the reel descriptions (if use_hashtags is true).
  • Credit Settings:
    • give_credit: Set to true to give credit to the original poster in the reel descriptions.
  • Deleting Settings:
    • delete_interval_minutes: Interval in minutes between deletions.
  • Comments:
    • leave_comment: Set to true to leave comments on scraped videos.
    • comments: List of comments to leave if leave_comment is true.

Usage

To run the script, use the following command:

python main.py

How It Works

  1. Scraping Reels:

    • The program scrapes reels from specified Instagram profiles at random intervals.
    • It downloads the reels along with their descriptions and saves them locally.
    • It randomly likes and comments on the reels to mimic human interaction.

  2. Uploading Reels:

    • The program uploads the scraped reels to the user's Instagram account at random intervals.
    • Users can choose to upload the reels with the original description or a custom description.
    • The program can also add the uploaded reels to the user's Instagram story.

  3. Automated Scheduling:

    • Scraping, uploading, and deletion tasks are scheduled to run at specified intervals, ensuring continuous and automated management of Instagram reels.

  4. Random Intervals:

    • Random intervals are added between actions to simulate human behavior and avoid detection by Instagram's anti-bot measures.

Dashboard

Run the dashboard script to view detailed information about scraping and uploading activities:

python dashboard.py

The terminal will populate the dashboard after each upload for convenience.

Sample Dashboard

Instagram Thefty Poster Dashboard

Troubleshooting

  1. Login Issues:

    • Ensure your Instagram credentials are correct.
    • Check for any changes in Instagram's login mechanisms that might require updating the instagrapi library.

  2. Missing Files:

    • Ensure all required files (e.g., status.json, config.yaml) are in the correct directory.
    • If any file is deleted by mistake, re-run start.py to regenerate the config.yaml file.

  3. Scraping Errors:

    • If scraping fails due to JSON decode errors or request exceptions, the script will retry with exponential backoff.
    • Ensure the target profiles are public and accessible.

  4. Uploading Errors:

    • If uploading fails, the script logs the error and continues with the next reel. Check the logs for specific error messages.

  5. Random Wait Times:

    • The script includes random wait times between actions. If these times seem too long or short, adjust the intervals in the configuration.

Pitfalls

  1. Account Suspension Risk:

    • Excessive bot-like activity can lead to account suspension. Ensure the intervals between actions are sufficiently randomized and not too frequent.
    • Avoid running the script for extended periods without breaks.

  2. Changes in Instagram API:

    • Instagram may update its API, which can break the script. Regularly check for updates to the instagrapi library and this repository.

  3. Rate Limits:

    • Instagram enforces rate limits on actions like liking, commenting, and uploading. Ensure your intervals respect these limits to avoid temporary bans.

  4. Privacy Concerns:

    • Scraping public content is generally permissible, but respect privacy and avoid scraping private profiles or content without permission.

  5. System Resource Usage:

    • Running the script continuously may consume significant system resources. Monitor your system's performance and adjust the script's activity accordingly.

FAQ

How do I add or remove Instagram profiles to scrape?

Edit the config.yaml file and modify the profiles field under scraping.

How do I change the number of reels to scrape per profile?

Edit the config.yaml file and modify the num_reels field under scraping.

How do I adjust the intervals between actions?

Edit the config.yaml file and modify the scrape_interval_minutes, upload_interval_minutes, and delete_interval_minutes fields.

Can I use custom descriptions for the uploaded reels?

Yes, you can set use_original to false in the config.yaml file and provide a custom_description.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Feel free to copy this content into your GitHub Wiki. It provides a comprehensive yet user-friendly breakdown of the program, its features, installation, usage, and troubleshooting, along with common pitfalls.

Clone this wiki locally