Skip to content

Karthigaiselvam-R-official/High-SpeedShare

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Typing SVG

Python License Platform Offline Single File


High-SpeedShare is a zero-dependency, fully offline LAN file sharing system.
Drop files. Scan a QR. Done. No internet. No cloud. No accounts.



πŸ“Έ Screenshots

πŸ–₯️ File Sharing Dashboard

File Sharing Dashboard



πŸ“‘ Host Console β€” Generate Connection

Generate Connection Β Β  QR Code Login



πŸ” Receiver Login & File Manager

Receiver Login Β Β  File Manager

✨ Features

πŸ”’ Security First

  • OTP-protected access β€” 4-digit code, session-scoped
  • QR auto-login β€” scan once, instantly authenticated
  • Brute-force protection β€” IP lockout after 5 attempts
  • CSV XSS sanitization β€” safe file previews
  • Path traversal prevention β€” is_safe_path() on every op

⚑ Speed & UX

  • Chunked resumable uploads β€” pause, resume, no re-upload
  • Drag & drop β€” files and entire folder trees
  • Live progress bars β€” real-time per-file
  • Private folders β€” each session gets isolated storage
  • Auto browser open β€” double-click and it just works

πŸ“‘ Truly Offline

  • Zero internet required β€” air-gapped LAN compatible
  • QR generated locally β€” no Google Charts, no CDN
  • No cloud, no accounts β€” pure LAN peer-to-peer
  • Works on any device β€” mobile browser, tablet, laptop

🎨 Modern UI

  • Dark glassmorphism design β€” premium feel
  • File previews β€” images, video, audio, PDF, CSV, code
  • Responsive layout β€” works on 320px to 4K
  • Real-time file list β€” auto-refreshes on upload complete

πŸš€ Quick Start

Option 1 β€” Single Executable (no Python needed)

# Linux / macOS (make it executable first)
chmod +x High-SpeedShare*
./High-SpeedShare*

# Windows
High-SpeedShare.exe

Browser opens automatically at http://localhost:8000/host

Option 2 β€” Run from Source

# Install dependencies
pip install -r requirements.txt

# Run
python3 fileshare.py

πŸ“– How It Works

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                                                             β”‚
β”‚   SENDER (Host)                  RECEIVER                  β”‚
β”‚   ──────────────                 ────────                  β”‚
β”‚                                                             β”‚
β”‚   1. Run High-SpeedShare         3. Scan QR code           β”‚
β”‚   2. Click "Generate Connection"    (or visit URL)         β”‚
β”‚      β†’ QR code + OTP appears     4. Auto-logged in!        β”‚
β”‚                                  5. Upload / Download files β”‚
β”‚                                                             β”‚
β”‚   β—‰  All traffic stays on your Local Area Network          β”‚
β”‚   β—‰  No data ever touches the internet                     β”‚
β”‚   β—‰  OTP expires when server restarts                      β”‚
β”‚                                                             β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ“¦ Build Executable from Source

# Install build tool
pip install pyinstaller qrcode[pil]

# Build β€” Linux / macOS
pyinstaller --onefile --name "High-SpeedShare" \
  --hidden-import qrcode \
  --hidden-import qrcode.image.pil \
  --hidden-import PIL \
  fileshare.py

# Output: dist/High-SpeedShare  (or .exe on Windows)

Automated builds for Linux, Windows, and macOS run via GitHub Actions on every release β€” check the Releases page.


πŸ›‘οΈ Security Model

Threat Mitigation
OTP brute-force IP lockout after 5 attempts β€” 5 min cooldown
XSS via CSV All cell content HTML-escaped before render
Directory traversal is_safe_path() validation on every file operation
External dependencies QR generated locally β€” zero outbound network calls
Session fixation UUID v4 session IDs, 24h TTL
Slowloris / slow clients 60s socket timeout on all connections

πŸ“‹ Requirements

Requirement
Python 3.8 or higher
Dependency qrcode[pil] (only when running from source)
Executable Zero dependencies β€” fully self-contained

πŸ—‚οΈ Project Structure

High-SpeedShare/
β”œβ”€β”€ fileshare.py              # Entire app β€” single Python file
β”œβ”€β”€ public/                   # README screenshots
β”‚   β”œβ”€β”€ high-speedshare.png
β”‚   β”œβ”€β”€ high-speedshare1.png
β”‚   β”œβ”€β”€ generateconnection.png
β”‚   β”œβ”€β”€ qrlogin.png
β”‚   └── receiverlogin.png
β”œβ”€β”€ .github/
β”‚   └── workflows/
β”‚       └── build.yml         # Auto-build for all platforms on release
β”œβ”€β”€ README.md
└── LICENSE

🀝 Contributing

  1. Fork the repo
  2. Create a feature branch: git checkout -b feat/your-feature
  3. Commit with context: feat(upload): add folder zip support
  4. Push and open a Pull Request

πŸ“„ License

License Β© Karthigaiselvam R
See LICENSE for full terms.


Built with ❀️ for offline-first, privacy-respecting file sharing

GitHub stars Β  GitHub forks

Packages

 
 
 

Contributors

Languages