WayPaste

Wayland-native image-to-Markdown paste tool for Linux VS Code users.

[](https://opensource.org/licenses/MIT) []()

WayPaste bridges the gap between the Linux Wayland clipboard and your Markdown files. It bypasses unreliable X11 compatibility layers to provide a blazing fast, seamless image pasting experience designed specifically for native Wayland compositors (like Hyprland, Sway, KDE Plasma Wayland, and GNOME Wayland).

✨ Features

• 🚀 100% Wayland Native: Interacts directly with wl-clipboard, completely avoiding xclip or XWayland translation layers.
• 🖼️ Smart Format Detection: Automatically detects clipboard image MIME types (PNG, JPEG, WebP, AVIF, BMP, TIFF) and extracts the raw bytes securely.
• 📁 Workspace-Aware: Remembers where you want to save images on a per-project basis (e.g., docs/images vs assets/img).
• ✏️ Native VS Code UX: Uses standard VS Code Command Palette input boxes to let you review and edit auto-generated filenames before saving.
• ⚡ Large Image Support: Handles high-resolution clipboard images up to 50MB without breaking a sweat.

📋 Requirements

• Linux operating system running a Wayland compositor.
• wl-clipboard must be installed and available in your system's PATH.

🚀 Installation

1. Install Dependencies

Ensure wl-clipboard is installed using your distribution's package manager:

Fedora:

sudo dnf install wl-clipboard

Arch Linux:

sudo pacman -S wl-clipboard

Ubuntu/Debian:

sudo apt install wl-clipboard

2. Install WayPaste

The easiest way to install WayPaste is directly from the VS Code Marketplace.

You can install it directly inside VS Code:

1. Open VS Code and press Ctrl+P
2. Paste the following command and hit Enter:

   ext install dis70rt.waypaste
   

Alternatively, you can just search for WayPaste in the Extensions panel (Ctrl+Shift+X) and click Install.

💡 Usage

1. Copy an image to your clipboard from any application (browser, screenshot tool like grim or hyprshot, etc).
2. Open a Markdown file (or any text editor) in VS Code.
3. Press Ctrl+Shift+Alt+V.
4. First time in a project only: It will prompt you for an image folder (default: images).
5. A native input box will appear with a pre-generated filename (e.g., image-20260823-120000.png).
6. Hit Enter to accept the filename, or type a new one and press Enter.
7. The image is instantly saved, and a relative Markdown link (![image](https://github.com/dis70rt/WayPaste/raw/HEAD/images/your-file.png)) is inserted at your cursor!

⚙️ Configuration

• waypaste.imageFolder: The workspace-relative folder path where pasted images will be saved. The extension automatically asks for this and saves it to your workspace .vscode/settings.json.

⌨️ Keyboard Shortcuts

• Paste Image: Ctrl+Shift+Alt+V (Feel free to rebind this in your VS Code Keyboard Shortcuts by searching for waypaste.paste!)

🛠️ Troubleshooting

• "wl-paste is not available": The extension cannot find wl-paste in your PATH. Please verify your wl-clipboard installation.
• "No image found": The clipboard contains text, URLs, or unsupported data, but no image MIME types.
• "Failed to retrieve image data": Usually occurs if the clipboard data is corrupted or the system clipboard manager rejected the read request.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page if you want to contribute.