Why Hour Share?

Transferring files between devices on the same local network is unnecessarily difficult:

• Finding IP addresses and typing them manually on a phone is error-prone.
• Cloud storage or WhatsApp requires internet and an account.
• USB cables are overkill for quick, one-time file transfers.

Hour Share solves this: launch the CLI, scan the QR code, and share files or text instantly - password-protected and auto-expiring after 60 minutes.

| | | |---|---| | ⚡ Instant Connect | Scan QR, opens directly on your phone. No more typing IP addresses. | | 🔒 Password Protected | Every bundle is secured with bcrypt password hashing. | | 📱 No Internet Required | Works entirely over local Wi-Fi. Zero data leaves your network. | | ⏰ Auto-Expire | Files and text delete automatically after 60 minutes. |

Key Features

| Feature | Status | Description | | :--- | :---: | :--- | | QR Connect | ✅ | Scan from phone, opens directly in browser | | File Upload | ✅ | Drag & drop or select files. 100 MB limit per file | | File Download | ✅ | One-click download, password-gated | | Text Share | ✅ | Paste text, code snippets, or links | | Password Protection | ✅ | bcrypt per bundle and per group | | Auto-Expire | ✅ | Background sweeper removes expired items every 60 minutes | | Group Chat | ✅ | Real-time file and text sharing within a group | | i18n (EN/ID/CN/JP) | ✅ | 4 languages toggle in the header | | Dark/Light Mode | ✅ | Theme toggle in header, persistent preference | | Auto Start | ✅ | OS-level auto-start (systemd / LaunchAgent / schtasks) |

Tech Stack

| Layer | Technology | |-------|-----------| | CLI | Node.js (vanilla, zero dependencies) | | Backend | Python 3.10+, Flask 3, bcrypt, qrcode[pil], Pillow | | Frontend | Vanilla HTML/CSS/JS (no build step), inline SVG icons | | Storage | File-based JSON (no database) | | Distribution | npm global package + GitHub repository | | License | MIT |

Quick Start

Install the CLI globally (recommended):

npm install -g hourshare
hourshare

1. Run hourshare in your terminal.
2. Select Start from the menu:

========================================
  Hour Share (v1.0.3)
  🚀 Server: http://localhost:10101
========================================
 ★ Start (Open in Browser)           ○ Stopped
 ☆ Auto Start (Disable)           
 ☆ Check Update (Internet Require)
 ☆ Stop                           
 ☆ Exit                           
  ↑↓ navigate · Enter select · Esc/Ctrl+C exit

3. Open the displayed local URL (like http://localhost:10101 or your local IP) in your browser on the same device, or scan the QR code from your phone.
4. Enter a password and share files or text. To receive, enter the same password.

Auto Start: Select Auto Start from the menu to launch the server at login.

Installation

Download from GitHub Releases or build from source:

git clone https://github.com/Curzyori/hour-share.git
cd hour-share
pip install flask bcrypt qrcode[pil] pillow

Requirements:

• Node.js >= 18
• Python 3.10+ (Linux, macOS, Windows)
• pip packages: flask, bcrypt, qrcode[pil], pillow

CLI Flags

hourshare                     # Interactive menu
hourshare --port 8080          # Custom port
hourshare --daemon             # Headless mode (no menu)
hourshare --help               # Show help

API Endpoints

| Method | Path | Function | |--------|------|----------| | GET | / | Web dashboard | | GET | /api/qr | QR Code PNG | | POST | /api/send | Upload bundle (files + text + password) | | POST | /api/receive | Access bundle with password | | POST | /api/group/join | Join or create a group | | GET | /api/group/{name}/info | Group info | | POST | /api/group/{name}/send | Send to group | | GET | /download/bundle/{id}/{filename} | Download file (requires auth session) |

Preview

Support

Support this project by buying me a coffee!

License

This project is released under the MIT license - see LICENSE for full text.

Built with passion as the 21st Project of the 50 Projects Challenge by @Curzyori