Crate lamco_clipboard_core 

lamco-clipboard-core

Clipboard format conversion and synchronization utilities for Rust.

This crate provides core clipboard infrastructure that works independently of any specific remote desktop protocol:

• FormatConverter - MIME type and Windows clipboard format conversion
• LoopDetector - Prevent clipboard sync loops with content hashing
• TransferEngine - Chunked transfer for large clipboard data
• sanitize - Cross-platform filename sanitization and file URI parsing

Quick Start

use lamco_clipboard_core::{FormatConverter, LoopDetector};
use lamco_clipboard_core::formats::{ClipboardFormat, mime_to_rdp_formats};

// Convert MIME types to clipboard formats
let formats = mime_to_rdp_formats(&["text/plain", "text/html"]);

// Check for clipboard loops
let mut detector = LoopDetector::new();
if !detector.would_cause_loop(&formats) {
    // Safe to sync
}

Feature Flags

• image - Enable image format conversion (PNG, JPEG, BMP to Windows DIB)

Architecture

This crate handles format conversion, loop detection, and transfer mechanics. For the clipboard backend trait (ClipboardSink) and RDP-specific file transfer types, see lamco-rdp-clipboard.

Re-exports

pub use formats::ClipboardFormat;

pub use formats::FormatConverter;

pub use loop_detector::ClipboardSource;

pub use loop_detector::LoopDetectionConfig;

pub use loop_detector::LoopDetector;

Modules

formats

Clipboard format conversion utilities.

imageimage

Image format conversion utilities.

loop_detector

Loop detection for clipboard synchronization.

prelude

Prelude module for convenient imports

sanitize

Cross-platform sanitization utilities for clipboard data.

Structs

TransferConfig

Configuration for the transfer engine

TransferEngine

Handles chunked transfers of clipboard data.

TransferProgress

Progress information for a transfer

Enums

ClipboardError

Errors that can occur during clipboard operations

TransferState

State of a transfer operation

Constants

DEFAULT_CHUNK_SIZE

Default chunk size: 64KB

DEFAULT_MAX_SIZE

Default maximum data size: 16MB

DEFAULT_TIMEOUT_MS

Default timeout: 30 seconds

Type Aliases

ClipboardResult

Result type for clipboard operations