https://github.com/0wd0/alist_clipboard
A cross-platform solution for seamless clipboard synchronization via Alist server, enabling clipboard content sharing between devices without third-party services. Built with pure shell scripts (Bash/PowerShell) with minimal system dependencies.
https://github.com/0wd0/alist_clipboard
alist bash clipboard clipboard-manager cross-platform lightweight linux no-dependencies powershell privacy productivity self-hosted shell-script synchronization utility windows x11
Last synced: 3 months ago
JSON representation
A cross-platform solution for seamless clipboard synchronization via Alist server, enabling clipboard content sharing between devices without third-party services. Built with pure shell scripts (Bash/PowerShell) with minimal system dependencies.
- Host: GitHub
- URL: https://github.com/0wd0/alist_clipboard
- Owner: 0WD0
- Created: 2025-04-08T15:22:55.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-08T15:37:05.000Z (about 1 year ago)
- Last Synced: 2025-04-08T16:35:43.434Z (about 1 year ago)
- Topics: alist, bash, clipboard, clipboard-manager, cross-platform, lightweight, linux, no-dependencies, powershell, privacy, productivity, self-hosted, shell-script, synchronization, utility, windows, x11
- Language: Shell
- Homepage:
- Size: 7.81 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Alist Clipboard Integration
A cross-platform solution for seamless clipboard synchronization via Alist server, enabling clipboard content sharing between devices without third-party services. **Built with pure shell scripts (Bash/PowerShell) with minimal system dependencies.**
## About
Alist Clipboard Integration provides a set of native scripts that allow you to synchronize clipboard content (both text and images) between multiple devices using your own Alist server as the intermediary. This project eliminates the need for cloud-based clipboard services by leveraging your self-hosted Alist instance, giving you complete control over your clipboard data.
## Use Cases
- **VM & Host Sharing**: Zero-configuration clipboard sharing between virtual machines and host systems
- **Cross-VM Communication**: Seamless clipboard transfer between different virtual machines
- **Cross-Platform Sync**: Share clipboard between Linux and Windows systems
- **Air-Gapped Environments**: Transfer data between isolated systems via a controlled intermediary
## Key Features
- **Cross-Platform Support**: Works on Linux (Wayland/X11) and Windows systems
- **Content Type Handling**: Seamlessly handles both text and image clipboard content
- **Pure Shell Implementation**: Entirely written in Bash (Linux) and PowerShell (Windows) with no programming language dependencies
- **Zero Runtime Dependencies**: No Python, Node.js, or other runtime environments required
- **Automatic Content Detection**: Intelligently identifies and processes different content types
- **Self-Hosted**: Uses your own Alist server, keeping your clipboard data private
- **Minimal System Dependencies**: Relies only on standard system tools that are either pre-installed or easily available
## System Requirements
### Linux Requirements
- Wayland: `wl-clipboard` package
- X11: `xclip` package
- Basic tools: `curl`, `grep`, `sed`, `file`, `hexdump`
- **No runtime environments required** (Python, Node.js, etc.)
### Windows Requirements
- PowerShell 5.0+
- Basic PowerShell modules (typically pre-installed)
## Setup
1. Copy `.env.example` to `.env`
2. Edit `.env` with your Alist server details
3. For Windows only: Install required packages: `pip install -r requirements.txt`
## Usage
### Linux Usage
Upload clipboard to Alist:
```bash
./linux_clipboard_to_alist.sh
```
Download from Alist to clipboard:
```bash
./linux_alist_to_clipboard.sh
```
### Windows Usage
Upload clipboard to Alist:
```powershell
.\windows_clipboard_to_alist.ps1
```
Download from Alist to clipboard:
```powershell
.\windows_alist_to_clipboard.ps1
```