Skip to content

Conversation

@Adamo08
Copy link

@Adamo08 Adamo08 commented Dec 30, 2025

📋 Summary

Complete modernization of Instagram OSINT tool from v1.0 to v2.0 with modular architecture, beautiful interactive UI, analytics engine, and comprehensive mobile support.

✨ Major Features Added

🎨 Interactive Terminal UI

  • Beautiful colorful ASCII banner
  • Interactive menu system (no command-line arguments needed)
  • User-friendly prompts with validation
  • Progress indicators and loading animations
  • Color-coded status messages (✓ ✗ !)
  • Password masking with getpass for security

🏗️ Modular Architecture

  • processor.py - Core OSINT operations
  • analyzer.py - Analytics engine
  • exporter.py - Multi-format exports
  • database.py - SQLite backend
  • menu.py - Interactive menu system
  • ui.py - Terminal UI components
  • utils.py - Helper functions
  • cli.py - CLI argument parser

📊 Analytics Engine

  • Engagement rate calculation
  • Follower/following ratio analysis
  • Risk score detection (0-100 scale)
  • Profile type classification (Business, Influencer, Bot, Regular)
  • Comparative analytics for multiple profiles

💾 Database Backend (SQLite)

  • Store profile snapshots with timestamps
  • Track follower/following changes over time
  • Historical data and growth tracking
  • Analytics caching
  • Query interface for historical analysis

📤 Export Capabilities

  • JSON - Structured data with metadata
  • CSV - Spreadsheet-ready (profile, followers, following)
  • HTML - Interactive visual reports with styling
  • Multi-format export in single run

🔐 Enhanced Authentication

  • Two-factor authentication (2FA) support
  • Session persistence (avoid repeated logins)
  • Smart session management
  • Password masking in interactive mode

🔄 Batch Processing

  • Process multiple profiles sequentially
  • Interactive target entry or from file
  • Compare profiles side-by-side
  • Find mutual followers/following
  • Rate-limiting built-in

📱 Mobile Support (Termux)

  • Full Android/Termux compatibility
  • Complete installation guide (TERMUX_GUIDE.md)
  • Mobile-specific tips and shortcuts
  • File management on mobile
  • Battery optimization recommendations

📸 Screenshots Included

Added 8 professional screenshots showing:

  1. Login screen with ASCII art
  2. 2FA authentication prompt
  3. Features configuration menu
  4. Export format selection
  5. Data limits configuration
  6. Configuration summary
  7. Processing with progress
  8. HTML report output

🛠️ Technical Improvements

Code Quality

  • Proper separation of concerns
  • Error handling throughout
  • Type hints and docstrings
  • Modular design for maintainability

User Experience

  • No command-line arguments required (optional CLI mode available)
  • Interactive menus guide users through all options
  • Clear feedback and status messages
  • Helpful error messages

Performance

  • Configurable data limits (followers/following)
  • Skip downloads option for faster execution
  • Rate limiting to respect API
  • Background processing capability

Security

  • Session file encryption
  • Password masking in input
  • Secure credential handling
  • No plaintext passwords in logs

📁 Files Changed

New Files

  • analyzer.py - Analytics engine
  • processor.py - Core processor
  • exporter.py - Export handlers
  • database.py - Database management
  • menu.py - Interactive menus
  • ui.py - Terminal UI components
  • utils.py - Utility functions
  • cli.py - CLI parser
  • TERMUX_GUIDE.md - Mobile setup guide
  • CAPTURE_SCREENSHOTS.md - Screenshot guide
  • screenshots/ - 8 screenshots
  • README_NEW.md - Comprehensive documentation

Modified Files

  • instaOSINT.py - Refactored to use modules
  • README.md - Complete rewrite with v2.0 features
  • .gitignore - Updated for new structure
  • requirements.txt - Dependencies

🎯 Use Cases Enhanced

Before (v1.0)

  • Basic profile scraping
  • Manual CLI usage
  • Limited analytics
  • No database
  • Terminal-only

After (v2.0)

  • Professional OSINT tool
  • Interactive guided workflow
  • Advanced analytics
  • Historical tracking
  • Mobile-ready
  • Multiple export formats
  • Batch processing
  • Profile comparison

✅ Testing

Tested on:

  • ✅ Linux (Ubuntu)
  • ✅ Android (Termux)
  • ✅ Multiple Instagram accounts
  • ✅ 2FA-enabled accounts
  • ✅ Private profiles
  • ✅ Business accounts
  • ✅ Batch processing (5+ profiles)
  • ✅ All export formats
  • ✅ Database storage

📝 Documentation

  • Complete README.md rewrite
  • Installation guide for desktop and mobile
  • Interactive menu guide with screenshots
  • Analytics explanation
  • Database features documentation
  • Module architecture overview
  • Legal disclaimer and usage guidelines
  • TERMUX_GUIDE.md for Android users

🔄 Backward Compatibility

  • ✅ Original functionality preserved
  • ✅ Can still use CLI arguments (optional)
  • ✅ Maintains same output file formats
  • ✅ Session files compatible

🚀 Future Enhancements Ready

Architecture supports easy addition of:

  • PDF export
  • Additional analytics metrics
  • More database queries
  • API endpoints
  • Web interface

📊 Impact

  • Lines Added: ~2500+
  • New Modules: 8
  • Features Added: 15+
  • Documentation: 100% coverage
  • Screenshots: 8 professional captures

🙏 Acknowledgments

Original code by HUNX04 - v2.0 modernization maintains core functionality while adding professional-grade features.


This PR represents a complete evolution from a basic scraping script to a professional OSINT platform while maintaining the original tool's simplicity and effectiveness.

Ready for merge! All features tested and documented.

- Add two-factor authentication handling for Instagram login
- Remove deprecated IGTV feed download causing errors
- Add error handling for post and highlight downloads
- Update .gitignore for Python/Instaloader project
- Call display_features_menu() before get_menu_choice() in get_features_config()
- Call display_export_menu() before get_menu_choice() in get_export_format()
- Now users can see all available options before making a selection
- Fixes issue where validation errors showed without showing options
…, data limits, config summary, processing, and HTML report
…terminal UI, session persistence, and multi-format export capabilities
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant