parth-dl 1.0.0__tar.gz

parth_dl-1.0.0/LICENSE

@@ -0,0 +1,31 @@
+MIT License
+
+Copyright (c) 2025 Saksham Pathak (Parthmax)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+ADDITIONAL DISCLAIMER:
+
+This software may interact with third-party services (Instagram) in ways that
+could violate their Terms of Service. Users are solely responsible for ensuring
+their usage complies with all applicable terms, laws, and regulations.
+
+The author(s) disclaim all liability for any misuse of this software.

parth_dl-1.0.0/MANIFEST.in

@@ -0,0 +1,13 @@
+# Include documentation
+include README.md
+include LICENSE
+
+# Include requirements (even though empty)
+include requirements.txt
+
+# Exclude unnecessary files
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude .DS_Store
+global-exclude *.swp
+global-exclude *~

parth_dl-1.0.0/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.4
+Name: parth-dl
+Version: 1.0.0
+Summary: Instagram media downloader for public content (reels, posts, profile pictures)
+Home-page: https://github.com/parthmax2/parth-dl
+Author: Parth
+Author-email: your.email@example.com
+Project-URL: Bug Reports, https://github.com/parthmax2/parth-dl/issues
+Project-URL: Source, https://github.com/parthmax2/parth-dl
+Keywords: instagram downloader reel video image profile-picture media
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Topic :: Multimedia :: Video
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# parth-dl
+
+**Instagram Media Downloader for Developers** — Download reels, posts, and profile pictures. Public content only. Zero dependencies.
+
+[![Python Version](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Code Style](https://img.shields.io/badge/code%20style-clean-black.svg)]()
+
+> Built by [@parthmax_](https://instagram.com/parthmax_) • Zero bloat, pure Python stdlib
+
+---
+
+## 🔥 Why parth-dl?
+
+Most Instagram downloaders are **bloated**, **outdated**, or **require authentication**. This one doesn't.
+
+- ✅ **Reels with audio** — Guaranteed combined streams
+- ✅ **Posts (images/videos)** — Carousel support included
+- ✅ **Profile pictures** — High-resolution extraction
+- ✅ **Zero dependencies** — Pure Python stdlib (no pip hell)
+- ✅ **Rate limiting** — Built-in protection against IP bans
+- ✅ **Retry logic** — Exponential backoff on failures
+- ✅ **Public only** — No login required
+
+---
+
+## ⚡ Installation
+
+### From Source
+```bash
+git clone https://github.com/parthmax2/parth-dl.git
+cd parth-dl
+pip install -e .
+```
+
+### From PyPI (soon)
+```bash
+pip install parth-dl
+```
+
+---
+
+## 🚀 Usage
+
+### CLI
+
+```bash
+# Download a reel
+parth-dl https://www.instagram.com/reel/ABC123/
+
+# Download a post
+parth-dl https://www.instagram.com/p/ABC123/
+
+# Download profile picture
+parth-dl https://www.instagram.com/username/
+
+# Custom output
+parth-dl https://www.instagram.com/reel/ABC123/ -o my_video.mp4
+
+# List formats
+parth-dl https://www.instagram.com/reel/ABC123/ --list-formats
+
+# Verbose mode
+parth-dl https://www.instagram.com/reel/ABC123/ -v
+```
+
+### Python API
+
+```python
+from parth_dl import InstagramDownloader
+
+# Initialize
+dl = InstagramDownloader(verbose=True)
+
+# Download
+dl.download('https://www.instagram.com/reel/ABC123/')
+
+# Get metadata
+info = dl.get_info('https://www.instagram.com/reel/ABC123/')
+print(info)
+```
+
+**Quick function:**
+```python
+from parth_dl import download
+download('https://www.instagram.com/reel/ABC123/')
+```
+
+---
+
+## 🛠️ Architecture
+
+```
+parth-dl/
+├── parth_dl/
+│   ├── __init__.py      # Package entry + exports
+│   ├── core.py          # Main orchestrator
+│   ├── extractors.py    # API/GraphQL/Embed/Page extractors
+│   ├── utils.py         # Security, retry, rate-limit
+│   └── cli.py           # CLI interface
+├── setup.py
+├── README.md
+└── requirements.txt     # (Empty — zero deps!)
+```
+
+**Key Features:**
+- **4 extraction methods** with intelligent fallback
+- **Token bucket rate limiter** (30 req/60s)
+- **Exponential backoff** with jitter
+- **URL validation** to prevent injection
+- **Filename sanitization** for safe I/O
+
+---
+
+## 🔒 Security
+
+- **No external dependencies** → No supply chain attacks
+- **URL validation** → Prevents injection
+- **Rate limiting** → Avoids IP bans
+- **Retry logic** → Handles transient failures
+- **Timeout controls** → No hanging requests
+
+---
+
+## ⚠️ Disclaimer
+
+**For educational and personal use only.**
+
+This tool may violate Instagram's Terms of Service. By using it, you accept full responsibility for:
+- Compliance with Instagram ToS
+- Copyright and intellectual property laws
+- Ethical usage
+
+Only download content you have permission to use. Respect creators' rights.
+
+---
+
+## 🤝 Contributing
+
+PRs welcome! Follow these steps:
+
+1. Fork the repo
+2. Create a feature branch (`git checkout -b feature/xyz`)
+3. Commit changes (`git commit -m 'Add xyz'`)
+4. Push to branch (`git push origin feature/xyz`)
+5. Open a PR
+
+---
+
+## 📝 License
+
+MIT License — See [LICENSE](LICENSE) for details.
+
+**Provided "as is" without warranty.** Instagram may change APIs anytime. Not responsible for misuse.
+
+---
+
+## 📬 Connect
+
+- **Author:** Saksham Pathak (Parthmax)
+- **Instagram:** [@parthmax_](https://instagram.com/parthmax_)
+- **LinkedIn:** [Saksham Pathak](https://linkedin.com/in/sakshampathak)
+- **Hugging Face:** [parthmax](https://huggingface.co/parthmax)
+- **Email:** pathaksaksham430@gmail.com
+
+---
+
+<div align="center">
+  
+**Built with ❤️ by Parthmax**
+
+[⭐ Star this repo](https://github.com/parthmax2/parth-dl) if you found it useful!
+
+</div>

parth_dl-1.0.0/README.md

@@ -0,0 +1,174 @@
+# parth-dl
+
+**Instagram Media Downloader for Developers** — Download reels, posts, and profile pictures. Public content only. Zero dependencies.
+
+[![Python Version](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Code Style](https://img.shields.io/badge/code%20style-clean-black.svg)]()
+
+> Built by [@parthmax_](https://instagram.com/parthmax_) • Zero bloat, pure Python stdlib
+
+---
+
+## 🔥 Why parth-dl?
+
+Most Instagram downloaders are **bloated**, **outdated**, or **require authentication**. This one doesn't.
+
+- ✅ **Reels with audio** — Guaranteed combined streams
+- ✅ **Posts (images/videos)** — Carousel support included
+- ✅ **Profile pictures** — High-resolution extraction
+- ✅ **Zero dependencies** — Pure Python stdlib (no pip hell)
+- ✅ **Rate limiting** — Built-in protection against IP bans
+- ✅ **Retry logic** — Exponential backoff on failures
+- ✅ **Public only** — No login required
+
+---
+
+## ⚡ Installation
+
+### From Source
+```bash
+git clone https://github.com/parthmax2/parth-dl.git
+cd parth-dl
+pip install -e .
+```
+
+### From PyPI (soon)
+```bash
+pip install parth-dl
+```
+
+---
+
+## 🚀 Usage
+
+### CLI
+
+```bash
+# Download a reel
+parth-dl https://www.instagram.com/reel/ABC123/
+
+# Download a post
+parth-dl https://www.instagram.com/p/ABC123/
+
+# Download profile picture
+parth-dl https://www.instagram.com/username/
+
+# Custom output
+parth-dl https://www.instagram.com/reel/ABC123/ -o my_video.mp4
+
+# List formats
+parth-dl https://www.instagram.com/reel/ABC123/ --list-formats
+
+# Verbose mode
+parth-dl https://www.instagram.com/reel/ABC123/ -v
+```
+
+### Python API
+
+```python
+from parth_dl import InstagramDownloader
+
+# Initialize
+dl = InstagramDownloader(verbose=True)
+
+# Download
+dl.download('https://www.instagram.com/reel/ABC123/')
+
+# Get metadata
+info = dl.get_info('https://www.instagram.com/reel/ABC123/')
+print(info)
+```
+
+**Quick function:**
+```python
+from parth_dl import download
+download('https://www.instagram.com/reel/ABC123/')
+```
+
+---
+
+## 🛠️ Architecture
+
+```
+parth-dl/
+├── parth_dl/
+│   ├── __init__.py      # Package entry + exports
+│   ├── core.py          # Main orchestrator
+│   ├── extractors.py    # API/GraphQL/Embed/Page extractors
+│   ├── utils.py         # Security, retry, rate-limit
+│   └── cli.py           # CLI interface
+├── setup.py
+├── README.md
+└── requirements.txt     # (Empty — zero deps!)
+```
+
+**Key Features:**
+- **4 extraction methods** with intelligent fallback
+- **Token bucket rate limiter** (30 req/60s)
+- **Exponential backoff** with jitter
+- **URL validation** to prevent injection
+- **Filename sanitization** for safe I/O
+
+---
+
+## 🔒 Security
+
+- **No external dependencies** → No supply chain attacks
+- **URL validation** → Prevents injection
+- **Rate limiting** → Avoids IP bans
+- **Retry logic** → Handles transient failures
+- **Timeout controls** → No hanging requests
+
+---
+
+## ⚠️ Disclaimer
+
+**For educational and personal use only.**
+
+This tool may violate Instagram's Terms of Service. By using it, you accept full responsibility for:
+- Compliance with Instagram ToS
+- Copyright and intellectual property laws
+- Ethical usage
+
+Only download content you have permission to use. Respect creators' rights.
+
+---
+
+## 🤝 Contributing
+
+PRs welcome! Follow these steps:
+
+1. Fork the repo
+2. Create a feature branch (`git checkout -b feature/xyz`)
+3. Commit changes (`git commit -m 'Add xyz'`)
+4. Push to branch (`git push origin feature/xyz`)
+5. Open a PR
+
+---
+
+## 📝 License
+
+MIT License — See [LICENSE](LICENSE) for details.
+
+**Provided "as is" without warranty.** Instagram may change APIs anytime. Not responsible for misuse.
+
+---
+
+## 📬 Connect
+
+- **Author:** Saksham Pathak (Parthmax)
+- **Instagram:** [@parthmax_](https://instagram.com/parthmax_)
+- **LinkedIn:** [Saksham Pathak](https://linkedin.com/in/sakshampathak)
+- **Hugging Face:** [parthmax](https://huggingface.co/parthmax)
+- **Email:** pathaksaksham430@gmail.com
+
+---
+
+<div align="center">
+  
+**Built with ❤️ by Parthmax**
+
+[⭐ Star this repo](https://github.com/parthmax2/parth-dl) if you found it useful!
+
+</div>

parth_dl-1.0.0/parth_dl/__init__.py

@@ -0,0 +1,53 @@
+"""
+parth-dl: Instagram Media Downloader
+Download Instagram reels, posts, and profile pictures (public accounts only)
+
+Author: Parth
+License: MIT
+"""
+
+__version__ = "1.0.0"
+__author__ = "Parth"
+__description__ = "Instagram media downloader for public content"
+
+from .core import InstagramDownloader
+from .utils import DownloadError, RateLimitError, NetworkError
+
+__all__ = [
+    'InstagramDownloader',
+    'DownloadError',
+    'RateLimitError', 
+    'NetworkError',
+]
+
+
+def download(url, output_path=None, quality='best', verbose=False):
+    """
+    Quick download function
+    
+    Args:
+        url: Instagram URL (reel, post, or profile)
+        output_path: Output file/directory path
+        quality: 'best' or 'worst'
+        verbose: Enable verbose logging
+        
+    Returns:
+        Path to downloaded file(s)
+    """
+    downloader = InstagramDownloader(verbose=verbose)
+    return downloader.download(url, output_path, quality)
+
+
+def get_info(url, verbose=False):
+    """
+    Get media information without downloading
+    
+    Args:
+        url: Instagram URL
+        verbose: Enable verbose logging
+        
+    Returns:
+        Dictionary with media information
+    """
+    downloader = InstagramDownloader(verbose=verbose)
+    return downloader.get_info(url)

parth_dl-1.0.0/parth_dl/cli.py

@@ -0,0 +1,169 @@
+"""
+Command-line interface for parth-dl
+"""
+
+import sys
+import argparse
+from . import __version__, __description__
+from .core import InstagramDownloader
+from .utils import DownloadError, RateLimitError, NetworkError, ValidationError
+
+
+def print_banner():
+    """Print application banner"""
+    banner = f"""
+╔═══════════════════════════════════════════════════════════════╗
+║                         parth-dl v{__version__}                        ║
+║              Instagram Media Downloader                       ║
+║                  (Public Content Only)                        ║
+╚═══════════════════════════════════════════════════════════════╝
+"""
+    print(banner)
+
+
+def create_parser():
+    """Create command-line argument parser"""
+    parser = argparse.ArgumentParser(
+        prog='parth-dl',
+        description=__description__,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  Download a reel:
+    parth-dl https://www.instagram.com/reel/ABC123/
+  
+  Download a post:
+    parth-dl https://www.instagram.com/p/ABC123/
+  
+  Download profile picture:
+    parth-dl https://www.instagram.com/username/
+  
+  Download with custom output:
+    parth-dl https://www.instagram.com/reel/ABC123/ -o my_video.mp4
+  
+  List available formats:
+    parth-dl https://www.instagram.com/reel/ABC123/ --list-formats
+  
+  Enable verbose logging:
+    parth-dl https://www.instagram.com/reel/ABC123/ -v
+
+Supported Content:
+  ✓ Reels (with audio)
+  ✓ Video posts (with audio)
+  ✓ Image posts (single & carousel)
+  ✓ Profile pictures
+  ✗ Stories (requires authentication)
+  ✗ Highlights (requires authentication)
+  ✗ Private accounts (not supported)
+
+Note: This tool only works with PUBLIC Instagram content.
+        """
+    )
+    
+    # Positional arguments
+    parser.add_argument(
+        'url',
+        help='Instagram URL (post, reel, or profile)'
+    )
+    
+    # Optional arguments
+    parser.add_argument(
+        '-o', '--output',
+        metavar='PATH',
+        help='Output file or directory path'
+    )
+    
+    parser.add_argument(
+        '-q', '--quality',
+        choices=['best', 'worst'],
+        default='best',
+        help='Video quality preference (default: best)'
+    )
+    
+    parser.add_argument(
+        '-v', '--verbose',
+        action='store_true',
+        help='Enable verbose/debug output'
+    )
+    
+    parser.add_argument(
+        '--list-formats',
+        action='store_true',
+        help='List all available formats without downloading'
+    )
+    
+    parser.add_argument(
+        '--no-rate-limit',
+        action='store_true',
+        help='Disable rate limiting (not recommended)'
+    )
+    
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {__version__}'
+    )
+    
+    return parser
+
+
+def main():
+    """Main CLI entry point"""
+    parser = create_parser()
+    args = parser.parse_args()
+    
+    # Print banner for non-quiet operations
+    if not args.list_formats:
+        print_banner()
+    
+    try:
+        # Create downloader instance
+        downloader = InstagramDownloader(
+            verbose=args.verbose,
+            rate_limit=not args.no_rate_limit
+        )
+        
+        # Execute command
+        if args.list_formats:
+            downloader.list_formats(args.url)
+        else:
+            downloader.download(
+                url=args.url,
+                output_path=args.output,
+                quality=args.quality
+            )
+        
+        return 0
+    
+    except KeyboardInterrupt:
+        print("\n\n[parth-dl] ⚠ Download cancelled by user", file=sys.stderr)
+        return 130
+    
+    except ValidationError as e:
+        print(f"\n[parth-dl] ✗ Invalid input: {e}", file=sys.stderr)
+        return 1
+    
+    except RateLimitError as e:
+        print(f"\n[parth-dl] ✗ Rate limit error: {e}", file=sys.stderr)
+        print("Tip: Wait a few minutes before trying again.", file=sys.stderr)
+        return 1
+    
+    except NetworkError as e:
+        print(f"\n[parth-dl] ✗ Network error: {e}", file=sys.stderr)
+        print("Tip: Check your internet connection and try again.", file=sys.stderr)
+        return 1
+    
+    except DownloadError as e:
+        print(f"\n[parth-dl] ✗ Download failed: {e}", file=sys.stderr)
+        return 1
+    
+    except Exception as e:
+        print(f"\n[parth-dl] ✗ Unexpected error: {e}", file=sys.stderr)
+        if args.verbose:
+            import traceback
+            traceback.print_exc()
+        return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())