pyservx 1.1.0__tar.gz → 2.0.0__tar.gz

pyservx-2.0.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: pyservx
+Version: 2.0.0
+Summary: A feature-rich Python HTTP server for file sharing with retro UI, dark/light themes, notepad, analytics, thumbnails, and QR code access.
+Author-email: Subz3r0x01 <subz3r0x01@protonmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/SubZ3r0-0x01/pyservx
+Project-URL: Repository, https://github.com/SubZ3r0-0x01/pyservx
+Keywords: file server,http server,file sharing,retro ui,qrcode,pyservx,dark mode,light mode,notepad,text editor,file preview,analytics,thumbnails
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+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
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: System :: Filesystems
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: qrcode
+Requires-Dist: Pillow
+Dynamic: license-file
+
+# PyServeX – Advanced Python HTTP File Server
+
+A feature-rich HTTP server for file sharing with a retro-styled web interface, dark/light themes, built-in notepad, analytics, and advanced file operations.
+
+**by Parth Padhiyar (SubZ3r0-0x01)**
+
+## Installation
+
+Install using pip:
+
+```bash
+pip install pyservx
+```
+
+Or use pipx for an isolated environment (recommended):
+
+```bash
+pipx install pyservx
+```
+
+Requires Python 3.6 or higher.
+
+## Usage
+
+Run the server:
+
+```bash
+pyservx
+```
+
+Or with custom options:
+
+```bash
+pyservx --port 8080 --no-qr
+```
+
+- The server automatically creates a shared folder in your Downloads directory (`PyServeX-Shared`)
+- Access the web interface at `http://localhost:8088` (or your custom port)
+- Scan the QR code in the terminal to access from mobile devices
+- Use `Ctrl+C` to stop the server
+
+## Features
+
+### Core Features
+- **Retro "Hacker" UI** with dark/light theme toggle
+- **File and folder browsing** with modern, responsive interface
+- **Download entire folders** as ZIP files
+- **Upload multiple files** simultaneously via drag-and-drop
+- **QR Code Access** for easy mobile device connection
+- **Real-time Progress Tracking** for uploads and downloads with ETA and speed
+- **No File Size Restrictions** - upload files of any size
+
+### Advanced Features
+- **Built-in Notepad/Text Editor**
+  - Create and edit text files directly in the browser
+  - Syntax highlighting support
+  - Keyboard shortcuts (Ctrl+S to save)
+  - Theme-aware editor
+
+- **File Preview System**
+  - Images (JPG, PNG, GIF, etc.)
+  - PDFs (embedded viewer)
+  - Videos (MP4, WebM, OGG)
+  - Audio files (MP3, WAV, OGG)
+  - Text files with syntax highlighting
+
+- **Analytics & Usage Tracking**
+  - SQLite-based analytics database
+  - Track file access, downloads, and uploads
+  - Monitor popular files and usage patterns
+  - Client IP and user agent logging
+
+- **Enhanced File Operations**
+  - Duplicate file detection
+  - File hash generation (MD5)
+  - Advanced file search with filters
+  - Thumbnail generation for images
+  - File copy and move operations
+  - Archive extraction support
+
+- **Smart Configuration**
+  - Persistent settings stored in user home directory
+  - Automatic shared folder creation in Downloads
+  - Configurable analytics and thumbnail generation
+  - Custom port support
+
+### User Interface
+- **Dark/Light Theme Toggle** with persistent settings
+- **Search Functionality** to quickly find files
+- **File Sorting** by name, size, or date
+- **Responsive Design** for desktop and mobile
+- **Breadcrumb Navigation** for easy folder traversal
+- **File Type Icons** for better visual organization
+
+### Security & Privacy
+- **Path Traversal Protection** prevents unauthorized access
+- **Automated `robots.txt`** to prevent search engine indexing
+- **Secure File Operations** with proper validation
+
+### Technical Features
+- **Modular Codebase** for easy maintenance and extension
+- **Chunked File Transfer** for efficient large file handling
+- **Progress Callbacks** for real-time feedback
+- **Threaded Server** for concurrent connections
+- **Graceful Shutdown** handling
+
+## Requirements
+
+- Python 3.6+
+- `qrcode` library (automatically installed with pip)
+
+## License
+
+MIT License

pyservx-2.0.0/README.md

@@ -0,0 +1,114 @@
+# PyServeX – Advanced Python HTTP File Server
+
+A feature-rich HTTP server for file sharing with a retro-styled web interface, dark/light themes, built-in notepad, analytics, and advanced file operations.
+
+**by Parth Padhiyar (SubZ3r0-0x01)**
+
+## Installation
+
+Install using pip:
+
+```bash
+pip install pyservx
+```
+
+Or use pipx for an isolated environment (recommended):
+
+```bash
+pipx install pyservx
+```
+
+Requires Python 3.6 or higher.
+
+## Usage
+
+Run the server:
+
+```bash
+pyservx
+```
+
+Or with custom options:
+
+```bash
+pyservx --port 8080 --no-qr
+```
+
+- The server automatically creates a shared folder in your Downloads directory (`PyServeX-Shared`)
+- Access the web interface at `http://localhost:8088` (or your custom port)
+- Scan the QR code in the terminal to access from mobile devices
+- Use `Ctrl+C` to stop the server
+
+## Features
+
+### Core Features
+- **Retro "Hacker" UI** with dark/light theme toggle
+- **File and folder browsing** with modern, responsive interface
+- **Download entire folders** as ZIP files
+- **Upload multiple files** simultaneously via drag-and-drop
+- **QR Code Access** for easy mobile device connection
+- **Real-time Progress Tracking** for uploads and downloads with ETA and speed
+- **No File Size Restrictions** - upload files of any size
+
+### Advanced Features
+- **Built-in Notepad/Text Editor**
+  - Create and edit text files directly in the browser
+  - Syntax highlighting support
+  - Keyboard shortcuts (Ctrl+S to save)
+  - Theme-aware editor
+
+- **File Preview System**
+  - Images (JPG, PNG, GIF, etc.)
+  - PDFs (embedded viewer)
+  - Videos (MP4, WebM, OGG)
+  - Audio files (MP3, WAV, OGG)
+  - Text files with syntax highlighting
+
+- **Analytics & Usage Tracking**
+  - SQLite-based analytics database
+  - Track file access, downloads, and uploads
+  - Monitor popular files and usage patterns
+  - Client IP and user agent logging
+
+- **Enhanced File Operations**
+  - Duplicate file detection
+  - File hash generation (MD5)
+  - Advanced file search with filters
+  - Thumbnail generation for images
+  - File copy and move operations
+  - Archive extraction support
+
+- **Smart Configuration**
+  - Persistent settings stored in user home directory
+  - Automatic shared folder creation in Downloads
+  - Configurable analytics and thumbnail generation
+  - Custom port support
+
+### User Interface
+- **Dark/Light Theme Toggle** with persistent settings
+- **Search Functionality** to quickly find files
+- **File Sorting** by name, size, or date
+- **Responsive Design** for desktop and mobile
+- **Breadcrumb Navigation** for easy folder traversal
+- **File Type Icons** for better visual organization
+
+### Security & Privacy
+- **Path Traversal Protection** prevents unauthorized access
+- **Automated `robots.txt`** to prevent search engine indexing
+- **Secure File Operations** with proper validation
+
+### Technical Features
+- **Modular Codebase** for easy maintenance and extension
+- **Chunked File Transfer** for efficient large file handling
+- **Progress Callbacks** for real-time feedback
+- **Threaded Server** for concurrent connections
+- **Graceful Shutdown** handling
+
+## Requirements
+
+- Python 3.6+
+- `qrcode` library (automatically installed with pip)
+
+## License
+
+MIT License

pyservx-2.0.0/frida_tool.py

@@ -0,0 +1,108 @@
+import os
+import subprocess
+import threading
+import time
+
+# --- Configuration ---
+FRIDA_SERVER_PATH = "/data/local/tmp"
+FRIDA_SERVER_EXECUTABLE = "frida-server-16.4.1-android-arm64"
+FRIDA_SCRIPTS = ["EMbypass.js", "3.sslPinning.js", "1.RootBypass.js"]
+
+def run_command(command, shell=False):
+    """Runs a command and returns its output."""
+    try:
+        process = subprocess.Popen(
+            command,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            shell=shell,
+            text=True
+        )
+        stdout, stderr = process.communicate()
+        if process.returncode != 0:
+            print(f"Error running command: {' '.join(command)}")
+            print(f"Stderr: {stderr}")
+            return None
+        return stdout.strip()
+    except FileNotFoundError:
+        print(f"Error: Command not found: {command[0]}")
+        return None
+
+def start_frida_server():
+    """Starts the Frida server on the Android device."""
+    print("--- Starting Frida Server ---")
+    # Check if the server is already running
+    pid = run_command(["adb", "shell", f"pidof {FRIDA_SERVER_EXECUTABLE}"])
+    if pid:
+        print("Frida server is already running.")
+        return True
+
+    print("Starting Frida server in the background...")
+    command = f"adb shell 'su -c "cd {FRIDA_SERVER_PATH} && ./{FRIDA_SERVER_EXECUTABLE} &"'"
+    # Since this command runs in the background, we don't need to wait for it.
+    # We'll just run it and assume it works. A small delay to ensure it starts.
+    subprocess.Popen(command, shell=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    time.sleep(3) # Give the server a moment to start
+
+    # Verify it's running
+    pid = run_command(["adb", "shell", f"pidof {FRIDA_SERVER_EXECUTABLE}"])
+    if pid:
+        print("Frida server started successfully.")
+        return True
+    else:
+        print("Error: Failed to start Frida server.")
+        print("Please ensure that the Frida server executable is located at:")
+        print(f"{FRIDA_SERVER_PATH}/{FRIDA_SERVER_EXECUTABLE}")
+        print("and that your device is properly rooted.")
+        return False
+
+
+def get_packages():
+    """Gets a list of all installed packages on the device."""
+    print("\n--- Getting list of installed packages ---")
+    packages_output = run_command(["adb", "shell", "pm", "list", "packages"])
+    if packages_output:
+        packages = [line.split(":")[-1] for line in packages_output.splitlines()]
+        return sorted(packages)
+    return []
+
+def main():
+    """Main function to run the tool."""
+    if not start_frida_server():
+        return
+
+    packages = get_packages()
+    if not packages:
+        print("Could not retrieve package list. Exiting.")
+        return
+
+    print("\n--- Select a package to bypass SSL pinning ---")
+    for i, pkg in enumerate(packages):
+        print(f"[{i+1}] {pkg}")
+
+    try:
+        choice = int(input("\nEnter the number of the package: ")) - 1
+        if 0 <= choice < len(packages):
+            selected_package = packages[choice]
+            print(f"\nYou selected: {selected_package}")
+
+            # Construct and run the Frida command
+            frida_command = ["frida"]
+            for script in FRIDA_SCRIPTS:
+                frida_command.extend(["-l", script])
+            frida_command.extend(["-U", "-f", selected_package, "--pause"])
+
+            print("\n--- Starting Frida ---")
+            print(f"Command: {' '.join(frida_command)}")
+            print("Press Ctrl+C to stop the script.")
+
+            # We use os.system here because frida can be interactive
+            os.system(' '.join(frida_command))
+
+        else:
+            print("Invalid choice.")
+    except (ValueError, IndexError):
+        print("Invalid input. Please enter a number from the list.")
+
+if __name__ == "__main__":
+    main()

pyservx-2.0.0/publish_to_pypi.py

@@ -0,0 +1,196 @@
+#!/usr/bin/env python3
+"""
+PyServeX - Automated PyPI Publishing Script
+Author: Parth Padhiyar (SubZ3r0-0x01)
+"""
+
+import subprocess
+import sys
+import os
+import shutil
+
+def run_command(command, description):
+    """Run a command and handle errors"""
+    print(f"\n{'='*60}")
+    print(f"🔧 {description}")
+    print(f"{'='*60}")
+    print(f"Running: {command}\n")
+    
+    try:
+        # Use list format for better handling of paths with spaces
+        if isinstance(command, str):
+            result = subprocess.run(command, shell=True, check=True, capture_output=True, text=True)
+        else:
+            result = subprocess.run(command, check=True, capture_output=True, text=True)
+        print(result.stdout)
+        if result.stderr:
+            print(result.stderr)
+        print(f"✅ {description} - SUCCESS")
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"❌ {description} - FAILED")
+        print(f"Error: {e.stderr}")
+        return False
+
+def clean_build_artifacts():
+    """Remove old build artifacts"""
+    print("\n🧹 Cleaning old build artifacts...")
+    
+    dirs_to_remove = ['dist', 'build', 'pyservx.egg-info']
+    for dir_name in dirs_to_remove:
+        if os.path.exists(dir_name):
+            try:
+                shutil.rmtree(dir_name)
+                print(f"  ✅ Removed {dir_name}/")
+            except Exception as e:
+                print(f"  ⚠️  Could not remove {dir_name}/: {e}")
+        else:
+            print(f"  ℹ️  {dir_name}/ does not exist")
+
+def check_prerequisites():
+    """Check if required tools are installed"""
+    print("\n🔍 Checking prerequisites...")
+    
+    # Check if build is installed
+    try:
+        subprocess.run([sys.executable, "-m", "build", "--version"], 
+                      capture_output=True, check=True)
+        print("  ✅ build is installed")
+    except:
+        print("  ❌ build is not installed")
+        print("  Installing build...")
+        subprocess.run([sys.executable, "-m", "pip", "install", "build"], check=True)
+    
+    # Check if twine is installed
+    try:
+        subprocess.run([sys.executable, "-m", "twine", "--version"], 
+                      capture_output=True, check=True)
+        print("  ✅ twine is installed")
+    except:
+        print("  ❌ twine is not installed")
+        print("  Installing twine...")
+        subprocess.run([sys.executable, "-m", "pip", "install", "twine"], check=True)
+
+def main():
+    """Main publishing workflow"""
+    print("""
+╔══════════════════════════════════════════════════════════════╗
+║                                                              ║
+║           PyServeX - PyPI Publishing Script                  ║
+║                                                              ║
+║           Author: Parth Padhiyar (SubZ3r0-0x01)             ║
+║           Version: 1.2.0                                     ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+    """)
+    
+    # Check prerequisites
+    check_prerequisites()
+    
+    # Clean old builds
+    clean_build_artifacts()
+    
+    # Build the package
+    if not run_command(
+        [sys.executable, "-m", "build"],
+        "Building distribution packages"
+    ):
+        print("\n❌ Build failed. Exiting.")
+        sys.exit(1)
+    
+    # Check the package
+    if not run_command(
+        [sys.executable, "-m", "twine", "check", "dist/*"],
+        "Checking package validity"
+    ):
+        print("\n⚠️  Package check failed. Review the errors above.")
+        response = input("\nDo you want to continue anyway? (y/N): ")
+        if response.lower() != 'y':
+            sys.exit(1)
+    
+    # Ask user which repository to upload to
+    print("\n" + "="*60)
+    print("📦 Ready to upload!")
+    print("="*60)
+    print("\nChoose upload destination:")
+    print("  1. TestPyPI (recommended for testing)")
+    print("  2. PyPI (production)")
+    print("  3. Both (TestPyPI first, then PyPI)")
+    print("  4. Exit")
+    
+    choice = input("\nEnter your choice (1-4): ").strip()
+    
+    if choice == "1":
+        # Upload to TestPyPI
+        print("\n🚀 Uploading to TestPyPI...")
+        run_command(
+            [sys.executable, "-m", "twine", "upload", "--repository", "testpypi", "dist/*"],
+            "Uploading to TestPyPI"
+        )
+        print("\n✅ Upload to TestPyPI complete!")
+        print("\nTest installation with:")
+        print("  pip install --index-url https://test.pypi.org/simple/ --no-deps pyservx")
+        
+    elif choice == "2":
+        # Upload to PyPI
+        print("\n⚠️  WARNING: You are about to upload to PRODUCTION PyPI!")
+        confirm = input("Are you sure? Type 'yes' to confirm: ")
+        if confirm.lower() == 'yes':
+            print("\n🚀 Uploading to PyPI...")
+            run_command(
+                [sys.executable, "-m", "twine", "upload", "dist/*"],
+                "Uploading to PyPI"
+            )
+            print("\n✅ Upload to PyPI complete!")
+            print("\nInstall with:")
+            print("  pip install pyservx")
+        else:
+            print("\n❌ Upload cancelled.")
+            
+    elif choice == "3":
+        # Upload to both
+        print("\n🚀 Uploading to TestPyPI first...")
+        if run_command(
+            [sys.executable, "-m", "twine", "upload", "--repository", "testpypi", "dist/*"],
+            "Uploading to TestPyPI"
+        ):
+            print("\n✅ TestPyPI upload successful!")
+            print("\n⚠️  Now uploading to PRODUCTION PyPI!")
+            confirm = input("Continue to PyPI? Type 'yes' to confirm: ")
+            if confirm.lower() == 'yes':
+                run_command(
+                    [sys.executable, "-m", "twine", "upload", "dist/*"],
+                    "Uploading to PyPI"
+                )
+                print("\n✅ Upload to PyPI complete!")
+            else:
+                print("\n❌ PyPI upload cancelled.")
+        else:
+            print("\n❌ TestPyPI upload failed. Not proceeding to PyPI.")
+            
+    elif choice == "4":
+        print("\n👋 Exiting without upload.")
+        sys.exit(0)
+    else:
+        print("\n❌ Invalid choice. Exiting.")
+        sys.exit(1)
+    
+    print("\n" + "="*60)
+    print("🎉 Publishing process complete!")
+    print("="*60)
+    print("\nNext steps:")
+    print("  1. Verify on PyPI: https://pypi.org/project/pyservx/")
+    print("  2. Test installation: pip install pyservx")
+    print("  3. Tag release in Git: git tag -a v1.2.0 -m 'Version 1.2.0'")
+    print("  4. Push to GitHub: git push origin main --tags")
+    print("\n✨ Great job! Your package is now available to the world! ✨\n")
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("\n\n❌ Publishing cancelled by user.")
+        sys.exit(1)
+    except Exception as e:
+        print(f"\n\n❌ An error occurred: {e}")
+        sys.exit(1)

pyservx-2.0.0/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "pyservx"
+version = "2.0.0"
+description = "A feature-rich Python HTTP server for file sharing with retro UI, dark/light themes, notepad, analytics, thumbnails, and QR code access."
+readme = "README.md"
+requires-python = ">=3.6"
+license = {text = "MIT"}
+keywords = ["file server", "http server", "file sharing", "retro ui", "qrcode", "pyservx", "dark mode", "light mode", "notepad", "text editor", "file preview", "analytics", "thumbnails"]
+authors = [
+    { name = "Subz3r0x01", email = "subz3r0x01@protonmail.com" }
+]
+dependencies = [
+    "qrcode",
+    "Pillow"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Topic :: Internet :: WWW/HTTP :: HTTP Servers",
+    "Topic :: System :: Filesystems",
+]
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages]
+find = { include = ["pyservx*"] }
+
+[project.urls]
+Homepage = "https://github.com/SubZ3r0-0x01/pyservx"
+Repository = "https://github.com/SubZ3r0-0x01/pyservx"
+
+[project.scripts]
+pyservx = "pyservx.server:main"

pyservx-2.0.0/pyservx/__init__.py

@@ -0,0 +1 @@
+__version__ = "2.0.0"  # Unified version with all features: dark/light mode, notepad, analytics, thumbnails, and file operations