Skip to content

Octoclip Knowledge Base

Welcome to the Octoclip Knowledge Base! Here you will find comprehensive guides, feature explanations, and key terminology. Whether you are a newcomer or an experienced user, this resource will help you make the most of Octoclip.

Table of Contents


Key Terminology

TermDefinition
ClipboardThe system clipboard on your device.
ClipA transient collection of data captured from the clipboard at a single moment.
Clip HistoryA chronological list of clips that you can browse, reuse, or delete.
Clip SourceMetadata describing where a clip originated — e.g. app, site, device, sender.
Alias TriggerA prefix + suffix pattern (e.g. :date⎵) that invokes Quick Input replacement.

Features

Clipboard & Clip

Octoclip distinguishes between the clipboard (system-level) and a clip (a captured snapshot). This separation allows powerful operations—such as indexing, sharing, and versioning—without interfering with the OS clipboard.

Clip History

Clip History keeps every captured clip for quick retrieval. You can:

  • Search or filter by text, type, or source.
  • Pin favorites for one-tap access.
  • Export clips or share them directly.

Nearby Sync

Synchronise clips over the local network (Wi-Fi, Ethernet, USB, or Thunderbolt) using Bonjour discovery. No account is required.

Quick Copy

Push the current clip to all discovered devices instantly.

Quick Paste

Pull the most recent clip from a nearby device and paste it into the active field.

Cloud Sync

For roaming scenarios, Octoclip offers instant cloud sync via an anonymised MQTT channel. Devices logged into the same storage ID stay in sync even when not on the same network.

Quick Input

Type a trigger and Octoclip autocompletes it with clip content or dynamic data.

Quick Input Alias

Create aliases like :date⎵, :now, or custom snippets (OTP codes, URLs, etc.). Aliases can be managed per device and synced.

Temporary Clipboard

A scratchpad for short-lived items—great for sequential file renaming or one-off formatting tasks. Items expire automatically after a configurable timeout.

Batch Input

Paste multiple clips in sequence or as a formatted batch. Useful for mass-entry workflows (e.g. CSV rows, code blocks).

Plugins & Workflows

Extend Octoclip with Rust-based plugins:

  • Transform data (e.g. lowercase, JSON prettify).
  • Hook into third-party APIs.
  • Automate post-paste actions.

The optional index-and-search module builds a full-text index of clip content (including OCR on images), enabling lightning-fast search with rich filters.

File & System Operations

Open, reveal, share, or select files via a unified Rust library that bridges Finder, Explorer, and common Linux file managers. Desktop versions report anonymous analytics to improve cross-platform performance.


Supported Clip Types

CategoryNotes & Examples
Plain TextUTF-8 strings, markdown, code snippets
Rich TextHTML, RTF, styled content
FilesAny file type, folders, symlinks
ImagePNG, JPEG, GIF, screenshots
VideoMP4, MOV, WebM
URLHyperlinks, deep-links
ColorHex, RGB(A) swatches

Note: Some features described above are still under active development and may not yet be available in the current release.