Simple and elegant local network clipboard sharing. Copy text and files between devices on the same network via a beautiful web interface.
- ✨ Simple & Elegant: Clean, modern UI with delightful interactions
- 🔒 Private & Secure: Only works on your local network
- ⚡ Fast & Real-time: Instant clipboard sharing via WebSocket
- 📋 Text Sharing: Copy and paste text between devices
- 📎 File Sharing: Send and receive files up to 100MB
- 🌐 Cross-platform: Works on all major browsers and operating systems
- 📱 Responsive: Optimized for desktop, tablet, and mobile devices
- 🌙 Dark/Light Mode: Beautiful gold theme with dark mode by default
- 📊 Device Tracking: See all connected devices with their IP addresses
- 💾 History: Keep track of recent clipboard items
- 🚀 Offline Ready: All assets are local, no CDN dependencies
- Node.js 14.x or higher
- npm or yarn
- Devices connected to the same local network
-
Clone or download this repository
git clone <repository-url> cd locopy
-
Install dependencies
npm install
Start the locopy server:
npm startOr for development with auto-reload:
npm run devThe server will start on port 5555 and display all available network IPs:
🚀 locopy server running on port 5555
Access locopy at:
http://192.168.1.100:5555
http://localhost:5555
- On the server machine: Open
http://localhost:5555in your browser - On other devices: Open
http://[server-ip]:5555(use the IP shown when server starts)
- Type or paste text in the "Text to Copy" field
- Click "Send Text" button
- The text will appear on all connected devices and be automatically copied to their clipboard
- Click "Choose files or drag and drop" or drag files directly
- Select one or multiple files (up to 100MB each)
- Click "Send File" button
- Files will be available for download on all connected devices
- Received text is automatically copied to your clipboard
- Received files can be downloaded with a single click
- All received items are saved in "Recent Items" for quick access
- Click any item in "Recent Items" to copy/download it again
- Click the × button on any item to delete it
- Click "Clear All" to remove all history
- Click the moon/sun icon in the top-right to switch between dark and light modes
- Your preference is saved automatically
The server automatically detects all available network interfaces and displays their IP addresses when starting. Access locopy from any device on the same network using:
http://[your-server-ip]:5555
Common IP ranges:
192.168.x.x- Most home networks10.0.x.x- Some corporate networks172.16.x.x- Some networks
locopy/
├── public/ # Frontend files
│ ├── index.html # Main HTML file
│ ├── styles.css # Stylesheet
│ ├── app.js # Frontend JavaScript
│ ├── fonts/ # Local font files
│ │ └── fonts.css # Font definitions
│ └── lib/ # Third-party libraries
│ └── lucide.js # Icon library
├── server.js # Express server with WebSocket
├── package.json # Dependencies and scripts
├── .gitignore # Git ignore rules
└── README.md # This file
Default port is 5555. You can change it using environment variables:
Option 1: Using .env file (recommended)
- Copy
.env.exampleto.env:cp .env.example .env
- Edit
.envand set your desired port:PORT=8080
Option 2: Using environment variable
Set the PORT environment variable before starting the server:
Linux/macOS:
export PORT=8080
npm startWindows (Command Prompt):
set PORT=8080
npm startWindows (PowerShell):
$env:PORT=8080
npm startOne-liner (all platforms):
PORT=8080 npm startDefault file size limit is 100MB. To change it, edit the multer configuration in server.js:
limits: {
fileSize: 100 * 1024 * 1024, // Change to your desired limit
}- Local Network Only: Only accessible on your local network
- No External Dependencies: All assets are served locally
- File Validation: Dangerous file types are blocked
- Path Traversal Protection: Secure file download handling
- Auto-cleanup: Temporary files are deleted after 1 hour
npm start- Start the production servernpm run dev- Start development server with auto-reload (requires nodemon)
- express - Web server framework
- ws - WebSocket library for real-time communication
- multer - File upload handling
- cors - CORS middleware
- nodemon - Auto-reload during development
- Chrome/Edge (latest)
- Firefox (latest)
- Safari (latest)
- Mobile browsers (iOS Safari, Chrome Mobile)
- Ensure all devices are on the same network
- Check firewall settings (port 5555 must be open)
- Verify the server IP address is correct
- Try accessing via IP instead of hostname
- Check browser download settings
- Ensure pop-ups aren't blocked
- Verify file hasn't been auto-deleted (1 hour limit)
- Refresh the page
- Check browser console for errors
- Verify server is running and accessible
- Check browser localStorage is enabled
- Clear browser cache and try again
MIT
- Built with Express.js and WebSocket
- Icons by Lucide
- Fonts: Nunito and Inter
For issues, questions, or contributions, please open an issue on the repository.
Enjoy seamless clipboard sharing across your devices! 🎉