Import a File as a Clip

What it does

Pick a single text or code file from disk and Blue Synergy imports it as a new clip — no editor round-trip, no copy-paste. The file’s name becomes the clip title, the content lands as text, and known code extensions get syntax-highlighted automatically.

Useful for pulling a snippet, a config fragment, a log excerpt, or a note into your clip library straight from Explorer or a file picker.

How to use it

Top menu — File → Import → Clip from File…

A native file picker opens. Pick the file, and Blue Synergy:

  • Reads it as UTF-8 text (1 MB cap).
  • Creates a new clip with the file basename as title (e.g. notes.md → title notes.md).
  • Places the clip in the folder you’re currently viewing (or All Clips if no folder is selected).
  • Auto-selects the new clip and scrolls it into view.

A status toast confirms the import (Imported as clip #N).

Format detection

Blue Synergy looks at the file extension and picks a content type:

  • CODE — .json, .xml, .yaml, .yml, .toml, .ini, .html, .css, .js, .ts, .tsx, .jsx, .py, .rs, .go, .java, .kt, .c, .cpp, .h, .cs, .rb, .php, .sh, .ps1, .bat, .sql, .md, .rst. These get syntax highlighting in the preview.
  • TXT — everything else (.txt, .log, .csv, no extension, …).

The clip’s source_app is set to "Import", and source_title to the filename, so you can filter all imports with a tag/source filter.

Limits

Constraint Value Why
Single file at a time Yes MVP — multi-select and drag-and-drop come next
Encoding UTF-8 Other encodings reject with an error toast — re-save as UTF-8 first
File size 1 MB Prevents accidental gigabyte-log imports; the cap will likely become configurable
Binary files Rejected Show as Cannot read file as UTF-8 text
Images Not supported here Use Captures or paste from clipboard

If a file exceeds the cap or isn’t valid UTF-8, you get a status-bar error explaining why — the clip is not created.

When to use which import path

You have… Use…
One file you want as a clip File → Import → Clip from File… (this page)
A folder full of text/code files Import Clips from a Folder
Many files from different locations Import the folder, or import one-by-one (multi-select is a planned follow-up)
A file from a non-UTF-8 encoding Open in Notepad / VS Code, save as UTF-8, then import