v1.0.0 - 🚀 Initial Release

ClipExpand v1.0.0 🚀

A lightweight, clipboard-based text expansion tool for Linux systems. Designed with Remote Desktop sessions in mind, ClipExpand copies your text snippets to the clipboard for easy pasting.

✨ Features

• 📋 Clipboard-based - Works seamlessly in Remote Desktop sessions (RDP, VNC)
• ⌨️ Keyboard-driven - Quick access via customizable keyboard shortcut (default: Ctrl+Shift+T)
• 📁 File-based snippets - Simple text files in ~/.clipexpand/ directory
• 🔍 Easy selection - Visual dialog for snippet selection
• 📢 Toast notifications - Non-intrusive confirmation messages
• 🗂️ Subdirectory support - Organize snippets in folders
• 🚀 Lightweight - Minimal dependencies, fast execution

🖥️ Compatible Systems

• Ubuntu 20.04+ (tested on 24.04)
• Linux Mint
• Debian 10+
• Pop!_OS
• Elementary OS
• Other Debian-based distributions with GNOME or similar desktop environments

Works with X11, Wayland, Remote Desktop (RDP, VNC), and SSH with X forwarding.

📦 Installation

Quick Install

./install.sh

The installer will automatically:
1. Install required dependencies
2. Copy the script to ~/bin/clipexpand.sh
3. Create the ~/.clipexpand/ directory
4. Install example snippets
5. Configure the keyboard shortcut (Ctrl+Shift+T)

Manual Installation

See the https://github.com/jparkerweb/clip-expand/blob/main/README.md for detailed manual installation instructions.

🎯 Usage

1. Press Ctrl+Shift+T (or your configured shortcut)
2. Select a snippet using arrow keys and Enter
3. Press Ctrl+V to paste

📝 Creating Snippets

Create simple text files in ~/.clipexpand/:

# Basic snippet
echo "your.email@example.com" > ~/.clipexpand/email

# Organize with folders
mkdir -p ~/.clipexpand/work
echo "work@company.com" > ~/.clipexpand/work/email

📋 Requirements

- bash
- zenity
- xsel
- notify-send (libnotify-bin)

📖 Documentation

For detailed usage, troubleshooting, and examples, see the https://github.com/jparkerweb/clip-expand/blob/main/README.md.

📄 License

MIT License

---
Inspired by https://github.com/leehblue/texpander, reimagined for clipboard-based workflow and Remote Desktop compatibility.