📱 StudentPaste — The Ultimate Cross-Device Clipboard & Keystroke Automator

StudentPaste is a premium, lightweight, cross-device utility that allows you to instantly synchronize text and code snippets from your smartphone to any computer, typing them hands-free with real keyboard hardware simulation.

Tip

🌐 Official Live Website: The responsive web landing page is fully live! You can access features, check out quick starts, or share the utility easily with classmates at: https://studentpaste.app

Specifically engineered to streamline typing and bypass restrictive laboratory environments, StudentPaste automatically neutralizes aggressive IDE auto-indentations, bracket closures, and autocomplete systems, leaving you with clean, perfectly aligned text.

---

✨ Features

• ⌨️ Hardware Keystroke Simulation: Types your synchronized snippets onto standard PCs with custom microsecond delays. Completely bypasses restrictive browser/IDE paste blocks.
• 🛡️ IDE Indentation Shield: Automatically detects and neutralizes IDE auto-tabbing and indentation layers, ensuring code alignment remains identical to your source.
• 🔒 Auto-Bracket Neutralizer: Automatically suppresses compiler-suggested double quotes, parentheses, and brackets, eliminating syntax compilation double-ups.
• 📱 Wireless Mobile Sender: Open a clean, responsive synchronization panel on your smartphone via QR code or local link, paste your text, and trigger remote injection to the PC.
• 📥 Silent System Tray Integration: Fully windowless background architecture. Running tasks tuck silently into your Windows Taskbar tray or macOS top Menu Bar.
• ⚡ Anti-Abort Safety Hook: Press the physical ESC key on your computer to instantly halt active keystroke injections at any millisecond.
• 🍏 Cross-Platform Ready: Tailored build scripts included for both Windows (Typer.exe) and macOS (Typer.app).

---

🛠️ Architecture

graph TD
    subgraph "Mobile Device"
        M[Mobile Web UI] -->|Sends Snippet via HTTP POST| F[Flask Web Server]
    end
    subgraph "Target Computer (Local Host)"
        F -->|Thread-Safe Synchronization| Q[Keystroke Processor]
        Q -->|Triggers Key Simulations| D[pynput Controller]
        D -->|Simulated Inputs| E[Active Text Editor / IDE]
        K[Physical Keyboard Listener] -->|Listens for ESC| Q
    end

Loading

---

🚀 Quick Start Guide

Prerequisites

Make sure you have Python 3.8+ installed on your computer.

⚡ 1-Click Launch (Easiest)

We've included handy, one-click launcher scripts that automatically verify your Python installation, install any missing dependencies silently, and launch the application for you!

• 🪟 Windows: Double-click run.bat
• 🍏 macOS: Double-click run_mac.command

---

💻 Manual Command Line Launch

If you prefer to run the application manually from your terminal:

1. Installation

Clone the repository and install the dependencies:

git clone https://github.com/yourusername/StudentPaste.git
cd StudentPaste
pip install -r requirements.txt

2. Launching Locally

Start the server and open your desktop controller dashboard:

python app.py

3. Pairing Your Mobile Device

1. Connect both your computer and phone to the same local network / Wi-Fi.
2. The desktop controller will display your Local IP Link and a randomly generated 4-Digit Session PIN.
3. Scan the QR code or visit the link on your phone, type the PIN, and start syncing!

---

📦 Compiling Standalone Binaries

You can package StudentPaste into a native, single-file, windowless executable that requires zero Python installation to run!

🪟 Windows Compilation (dist/Typer.exe)

Run the Windows compiler script in your terminal:

python build.py

🍏 macOS Compilation (dist/Typer.app)

On any Mac, run the macOS compiler script:

python build_mac.py

---

🌐 Web Landing Page Deployment (Vercel)

The premium, highly responsive web landing page of StudentPaste is built using pure, optimized static HTML and CSS, making it 100% compatible with modern static deployment platforms like Vercel, Netlify, or GitHub Pages.

If you fork this repository and want to launch your own public landing page:

1. Customize the landing page assets inside your static web directory.
2. Link your GitHub repository to your Vercel Dashboard.
3. Import the directory as a static project, and Vercel will build and host your custom landing page (e.g., yourbrand.vercel.app) with automatic SSL and edge-CDN performance in one click!

---

📄 License

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

⚠️ Disclaimer

This utility is created strictly for laboratory demonstrations, remote access utilities, typing assistance, and educational learning exercises. The developers do not promote, encourage, or condone cheating, plagiarism, or any form of academic dishonesty. Users are solely responsible for compliance with their respective institutional policies.