Kolate — Complete User Guide
The complete manual · Kolate 2.0.0
Press F1 anytime to reopen this guide. Click a part below to jump to it. New to Kolate 2? Start with What’s new in Kolate 2. Carrying your work on a USB stick? See Carrying Your Work on a USB Stick — Safely. Want to know how your data is kept safe? See How Your Data Is Protected and Keeping Your Data Safe — a Beginner's Guide.
Part 1 — Getting Started
This is the first part of the full Kolate 2.0.0 manual. It mirrors the built-in guide you can open at any time by pressing F1 (see §1.5). Part 1 covers what Kolate is for and what is new in Kolate 2, exactly what happens the first time you run it, how your privacy is protected, and how to move from the free Unregistered edition to the full Registered edition with a licence. Later parts cover the main window, sessions and pages, each content format and its editor, the sound pages and the Sound Studio, the Inspectors, the data tools and the power tools.
1.1 What Kolate Is — the Round-Trip Guarantee
- Light and Dark themes for the whole application — View ▸ Theme (§2.13).
- Notifications — toasts now stack at the bottom-right, and the bell keeps this session's history (§2.14).
- Title and summary strip after every Save CB, plus the save notice that tells you why a save was blocked (§2.4).
- Command Palette (Ctrl+K) to find and run any command, and the Keyboard Shortcuts sheet (§2.15).
- Mouse wheel scrolls anywhere in the deck — over a page, a container or the deck itself (§2.8).
- A full Image Editor for PNG, JPEG, BMP and GIF (including GIF frames), and New Pg blank pictures (§4.5).
- An SVG Editor and Export to PNG (§4.6).
- Modern TXT, RTF and HTML toolbars with Find & Replace, editor Undo / Redo, and English (UK) spell check with My dictionary (Part 4, §3.12).
- Background colour and transparent erasing in the Image Editor (§4.5).
- My Profile — export and import your personal settings: recent colours, remembered printers, your dictionary (§3.12).
- WAV page zones and Sound Studio upgrades — background rendering, Undo and keyboard keys (Part 7A, Part 7B).
- Statistics window and Data Collation (which replaces Lab Analysis), alongside the Data Plotter (Part 12).
- New licence-based activation — the Kolate Activation window; Kolate 1 passcodes are no longer accepted (§1.4).
- Start Fresh with a full backup first, keeping your activation and profile (§3.8).
- Full encryption of your store — with a passphrase, the database and every stored page, picture, sound and text are encrypted on disk (§11.1, §11.11), with a beginner's guide to good security habits (§11.12).
The Windows clipboard normally holds one thing at a time: copy something new and the previous copy is gone forever. Kolate replaces that single slot with a permanent, organised, searchable store of everything you choose to keep.
The core promise is the round trip. Anything Kolate captures can be recalled back onto the clipboard in exactly its original form. Pasting a recalled item behaves identically to pasting the original copy — same bytes, same format, no degradation. A recalled image is still the image; recalled formatted text keeps its formatting; a recalled sound file is the same file.
Around that promise Kolate adds metadata (Session, Category, Title, Importance, Summary), a visual grid, live previews, an editor for most formats, page generation, data tools and search across your whole store.
Supported formats
Kolate recognises the format automatically when you save. Each format has its own signature colour, used consistently on tiles, grid slots and buttons throughout the app:
| Format | Colour | What it is |
|---|---|---|
| TXT | Green | Plain text — edited in place with its own toolbar, Find & Replace and spell check (Part 4). |
| RTF | Blue | Rich (formatted) text — fonts, sizes, colours and styles preserved; full formatting toolbar and spell check (Part 4). |
| HTML | Red | Web content; edited as a rendered page with its own toolbar, or as source (Part 4). |
| PNG / BMP / JPEG / GIF | Yellow / Orange / Purple / Lime | Pictures. Edited in the Kolate Image Editor (rotate, crop, resize, adjust, draw); GIF frames and their timing can be edited too. New Pg adds a blank picture page (§4.5). |
| Cyan | Documents, viewed with a zoom toolbar (view only). | |
| SVG | Deep pink | Vector graphics — zoom toolbar, the Kolate SVG Editor, and Export to PNG (§4.6). |
| WAV / MP3 | Violet | Sound — full subsystem with tile grids and the Sound Studio (Part 7). |
| MIDI (.mid) | Teal | Musical sequences; can be rendered to WAV (Part 8). |
| URL | Black | Link collections with their own generated pages (Part 6). |
| File Collection | Brown | A multi-file copy made in Windows Explorer. |
1.2 Your First Run, Step by Step
The first time you launch Kolate on a computer, it sets itself up with no technical questions and nothing scary to answer. Here is the exact sequence:
- Kolate builds its store silently. Because no database exists yet, Kolate creates one and validates it automatically. If anything needs repair it fixes it in the background — no confirmation dialog is shown on a first run.
- The guide opens. This same guide appears on screen so you can read it or close it. It will not appear automatically again once you have closed it once (see §1.5 to reopen it, and to turn the automatic appearance off).
- Kolate measures your computer. A one-time calibration runs in the background to rate this machine's audio capability. You are never left waiting: Kolate carries on as normal and shows one message that calibration is in progress and a second reporting the result — for example “High spec — Sound Studio starts in Dynamic adjustment mode.” This only affects the Sound Studio's initial mode, which you can change later (Part 7).
- The limits form appears once. So you can set how many tiles each page holds, the Setup form opens the first time only. You can accept the defaults and change them later from Tools ▸ Preferences ▸ Setup Limits (Part 11).
- You are ready. Kolate opens in the Light theme; switch to Dark at any time from View ▸ Theme (§2.13). From then on, each launch restores the session you were last working in, ready to continue.
1.3 Privacy, the Diagnostic Log and Crash Reports
Logging starts OFF. Every time Kolate starts, the toggle at the bottom of the window reads LOGGING OFF and nothing is written to the diagnostic log. The only exceptions are two start-up options that you can switch on yourself in Manage Logs (Part 10 §10.2):
- “Enable logging on Kolate startup” — Kolate asks you at each start whether logging should be on for that session.
- “Log the startup transition (loading → ready) — no prompt” — Kolate logs from the very first moment of start-up, without asking.
Otherwise, activities are recorded only while you have switched logging on during that run (the toggle then reads LOGGING ACTIVE in bold red). The moment you close Kolate and reopen it, logging is off again.
The log is a plain text file (cima.log) in Kolate's default data folder. It stays on this computer even if you move your store elsewhere with Database Location (Part 3 §3.10). Its only purpose is to help diagnose a problem: if you ever report unexpected behaviour, support may ask you to switch logging on, reproduce the issue, and send the log. Until you do that, Kolate records nothing about what you copy or view.
Crash reports
If something unexpected goes wrong inside Kolate, it writes a short crash report to the Crash folder in its data folder, shows a friendly message and keeps running. A crash report is written even when logging is off. It holds only the error and where in Kolate it happened — no page contents. If Kolate ever closes by itself, send the newest crash report with your description of what you were doing.
1.4 Editions and Activation
Kolate is licensed per computer. Without a licence it runs as the Unregistered edition — fully usable, but scoped to the session you are currently in, with fixed page sizes. Entering the licence from the publisher unlocks the Registered edition. A yellow banner under the menu, “Kolate Unregistered User Id = …”, shows that you are unregistered and shows your User Id; it is not a button.
What the Registered edition adds
| Unregistered | Registered |
|---|---|
| The Session dropdown lists only the current session. | Every session is listed in the Session dropdown — resume any of them. |
| Search is locked to the current session (“All Sessions” is greyed out). | Free choice of search scope, including “All Sessions”. |
| Page generators and the MIDI / WAV / URL views work on the current session only. | “All sessions” scope on every page generator and tiled view. |
| Capacity is fixed: 1 PSA grid page; 12 URLs, 12 sounds and 12 MIDIs per page; 25 files per File Collection. | Each value is a dropdown: 1–20 grid pages (up to 720 slots); 1–40 URLs, sounds and MIDIs per page; 1–50 files per File Collection (Part 11 §11.3). |
| Production Mode is not available. | Tools ▸ Preferences ▸ Production Mode can be used (Part 11). |
How to activate — step by step
- Choose Help ▸ Enter Pass Code.... The Kolate Activation window opens.
- Press Copy beside the Kolate Identifier and send that single line to support.
- Optionally type an Email so support can reach you.
- Support sends back your licence — a long code in an e-mail, a licence file (
.kolatelic), or both. - Put the licence into the Kolate Licence box in any of these ways:
- press Paste (or click in the box and press Ctrl+V) after copying the code from the e-mail — line breaks and quote marks added by the e-mail program do not matter, and text after the code (such as “Kind regards”) is ignored;
- press Open file… and pick the licence file;
- drag the licence file from Explorer and drop it on the licence box, or anywhere on the window.
- The line under the box turns green: “Valid licence for this computer. Registration Id: … Issued: …”, and OK becomes available. Press OK.
- The banner disappears and a message confirms “This computer has been activated for Kolate.” The Registered ranges are available straight away — no restart is needed.
The controls
| Control | What it does |
|---|---|
| Kolate Identifier | A read-only line combining this computer's User Id (the same one shown in the yellow banner) and a support token, joined by a dash. Copy copies the whole line so you can send it in one go. |
| Email (optional) | Only used so support can contact you; leave it blank if you prefer. If the licence carries an e-mail address and this box is empty, it is filled in for you. |
| Kolate Licence | Where the licence goes — paste the code, or load the licence file with Open file… or by drag and drop. It is checked live, every time the text changes. |
| Paste | Pastes the licence code from the clipboard into the box. |
| Open file… | Opens the licence file that support sent. |
| Status line | Under the box. Dim while waiting (“Waiting for the licence…”), green for a valid licence, red with a plain reason when the text is not a usable licence — for example “This licence was issued for another computer.” |
| Licence key in this Kolate | Small text at the bottom-left, “Licence key in this Kolate: Key …”. A short code identifying your copy of Kolate; quote it if support asks. |
| OK / Cancel | OK is enabled only once a valid licence is present and applies the activation. Cancel closes the window without changing anything. |
1.5 The Built-in Guide (F1)
This guide is always available inside Kolate. There are three ways to open it:
- Press F1 in the main window at any time. If the guide is already open, it is brought to the front.
- Choose Help ▸ Kolate — Complete User Guide (F1).
- It also opens by itself the very first time you run Kolate.
Finding your way around
The guide opens on a Contents page. Every entry is a link — click one to jump straight to that section. The ⌂ Contents button at the top returns you to the Contents page from anywhere, and Close closes the guide.
Two quicker kinds of help
- Help ▸ Keyboard Shortcuts… shows every keyboard shortcut on one sheet (§2.15).
- Help ▸ Command Palette… (or Ctrl+K) lets you type part of a command's name and run it, without knowing which menu it lives in (§2.15).
Part 2 — The Main Window & Everyday Capture
This part maps the whole main window and the day-to-day loop of copy → Save CB → recall → paste. It documents every control you meet on the way, the title and summary strip that follows each save, and the new Kolate 2 helpers: the Light and Dark themes, the notification bell, and the Command Palette. Deep subsystems (each content format, the Sound Studio, the Inspectors, the data and power tools) are pointed to here and covered in full in their own parts.
2.1 The Window in Four Regions
The main window has four regions. Once you can name them, everything else in this manual has a home:
- Menu bar (top) — File, Tools, View, Help (§2.2), with the notification bell at its right-hand end (§2.14).
- Control panel (left) — collapsible cards for metadata, saving, recall, the grid slots and search (§2.3).
- Format containers (centre) — one live preview per format, each with its own header and page pager (§2.8).
- Command bar (bottom) — the action buttons, the Ext Functions runner, the status line and the app toggles (§2.9).
Above the format containers sits the PSA grid — the coloured Page/Slot shortcut grid (§2.6). While Kolate is unregistered, a yellow banner under the menu shows your User Id (Part 1 §1.4).
2.2 The Menu Bar — Full Map
Everything that is not an everyday button lives in the menus, grouped by purpose. Any of these can also be found and run from the Command Palette (§2.15).
| Menu path | What it does |
|---|---|
| File ▸ Exit | Closes Kolate (your last session is restored next launch). |
| Tools ▸ Sessions ▸ New Session… | Start a fresh, empty session (Part 3 §3.1). |
| Tools ▸ Sessions ▸ Rename / Merge Sessions… | Rename a session or merge two together (Part 3 §3.2). |
| Tools ▸ Database ▸ Database Status… | See the store's schema, migration history and validation (Part 3 §3.8). |
| Tools ▸ Database ▸ Cleanup Database… | Remove entries whose files are missing, repair titles, fill in missing page numbers and compact the database (Part 3 §3.8). |
| Tools ▸ Database ▸ Database Location… | Point Kolate at another folder or drive for its data (Part 3 §3.10). |
| Tools ▸ Database ▸ Merge Database… | Fold another computer's CIMAdb into this one (Part 3 §3.9). |
| Tools ▸ Database ▸ Start Fresh… | Clear the whole store — every entry and stored file — with an optional full backup first; your activation is kept (Part 3 §3.8). |
| Tools ▸ My Profile ▸ Export my profile… | Save your personal settings to one .zip file (Part 3 §3.12). |
| Tools ▸ My Profile ▸ Import a profile… | Load personal settings from a profile .zip; your current profile is kept aside (Part 3 §3.12). |
| Tools ▸ My Profile ▸ My dictionary… | See, add and remove the words you added to the spell checker (Part 4). |
| Tools ▸ My Profile ▸ Open the profile folder | Show the Kolate_Profile folder in Explorer (Part 3 §3.12). |
| Tools ▸ Protection ▸ Protect the store (passphrase)… | Encrypt the database behind a passphrase (Part 11). |
| Tools ▸ Output ▸ Data Plotter... | Graph logger data or a clipboard table (Part 12). |
| Tools ▸ Output ▸ Data Collation... | Bring time-based logs together and turn them into a report (Part 12). |
| Tools ▸ Output ▸ Statistics... | Summary figures, percentiles and charts of a pasted or opened table (Part 12). |
| Tools ▸ Output ▸ Print Page (A4)… | Print the page in view as an A4 sheet (Part 10). |
| Tools ▸ Output ▸ Multi‑Copy (HUD)… | The heads-up multi-copy helper (Part 10). |
| Tools ▸ Preferences ▸ Setup Limits… | PSA grid size and tiles-per-page limits (Part 11). |
| Tools ▸ Preferences ▸ Toast Duration… | The minimum time every toast stays on screen (§2.14, Part 11). |
| Tools ▸ Preferences ▸ Production Mode | A checkable switch, Registered edition only; it takes effect when Kolate restarts (Part 11). |
| View ▸ Toggle Compact Mode (F11) | Step to the next of the five VIEW states (§2.11). |
| View ▸ Theme ▸ Light / Dark | Light or dark colours for the whole application; the active one is ticked (§2.13). |
| View ▸ Notifications | Open the list of messages Kolate showed this session — the same list as the bell (§2.14). |
| View ▸ Command Palette… (Ctrl+K) | Find and run any command by typing part of its name (§2.15). |
| Help ▸ Kolate — Complete User Guide (F1) | Opens this guide (Part 1 §1.5). |
| Help ▸ Keyboard Shortcuts… | Every keyboard shortcut in Kolate on one sheet (§2.15). |
| Help ▸ Command Palette… (Ctrl+K) | The same palette as in the View menu (§2.15). |
| Help ▸ Enter Pass Code... | Opens the Kolate Activation window to enter your licence (Part 1 §1.4). |
| Help ▸ About Kolate | Shows the product name and version (2.0.0). |
The bell at the right end of the menu row is not a menu, but lives there too: it shows how many new notifications you have and opens their list (§2.14).
Back to contents2.3 The Control Panel (Left)
The left panel is a stack of collapsible cards. Click a card's header bar to open or close it — the bar looks pressed in while its card is open, and each card remembers whether it was open or closed the next time you start Kolate. The ↔ button in the CONTROL PANEL header cycles the panel's width through Full, Half, Third and Hidden; the width you choose is remembered. When the panel is Hidden, a small green CB button stays at the top so you can still save the clipboard.
METADATA — describe what you are about to save
Fill these in before you press Save CB and they are attached to the saved item: Session, Category, Title, Importance and Summary / Comments. The card's helpers:
- 📅 beside Session sets today's date and opens the “Select Session Date” calendar; picking a date puts it at the start of the session name. Ctrl+B in the Session box inserts the “ • ” separator.
- Change... beside Session renames, moves or unlocks the session (Part 3 §3.2).
- + and − beside Category add the typed category to the list or remove it. A core category, or one used by any saved entry, cannot be removed.
- 📝 beside Title saves the Title, Category and Summary onto the current item.
- Small icons beside each field flag a problem; ✓ Apply Fixes appears only when there is something to correct, and applies the automatic corrections to Session and Title.
Under the card is a row of quick actions: Clear Fields resets the fields, New Session starts one (it asks for Category, Title and Importance), and Stay OnTop keeps Kolate above other windows — while it is on, the button reads Sink App; press it again to let Kolate sink back.
MODIFY CURRENT ENTRY METADATA — edit the item you are standing on
The S (session), C (category), T (title) and Σ (summary) boxes always mirror your item of interest: the clip you just recalled, the page you navigated to, the container you clicked, or the search result you are on. Edit the category, title or summary and press UPDATE PAGE (or press Enter in the T or Σ box) to write the changes straight onto that clip's database row; focus then returns to the live page. The ✕ at the end of the T and Σ boxes clears them for retyping.
The red box further down is for showing things: the entry's summary, a search listing, or the ♬ indicator while a sound plays. It is never saved by UPDATE PAGE — the summary that is saved is always the one in the Σ box.
SAVE • RECALL • NAVIGATE
Holds Save CB with its counter and lamp, Recall CB, the Auto-Save toggle, the Allow duplicates option, the SD (Show Duplicates) button, a local ◀ Prev / Next ▶ pair, and the save notice bar beneath them. These are covered in §2.4.
PAGE ➜ SLOT ➜ ASSIGN
Pick a page and a slot and pin the current item there (§2.7).
SEARCH RESULTS & SEARCH
SEARCH runs a keyword query over Session / Category / Title / Comments / Contents with a choice of fields and scope (press Enter in the Keyword box to run it); SEARCH RESULTS lets you step through the hits (▲ UP / DOWN ▼ / Select). Search is covered fully in Part 5.
Back to contents2.4 Saving from the Clipboard — Save CB
This is the heart of Kolate. Copy anything in Windows, then capture it:
- Copy something (text, an image, a file, a sound, a link…).
- Make sure a Session is set, and optionally fill in the rest of the METADATA card (Category, Title, Importance, Summary).
- Press Save CB. Kolate detects the format, writes the content into its store, and records a database row carrying your metadata. The container that received it comes to the front so you can see the save.
- The lamp turns orange right after the save and then green about five seconds later; the save counter ticks up.
- For page formats the title and summary strip appears so you can change the title or summary if you wish; for WAV, MIDI and URL the name box takes the cursor instead (see below). Ignore either and the save stands as it is.
| Control | What it does |
|---|---|
| Save CB | Saves the current clipboard content to the store. The lamp shows the result (see the table below). |
| Recall CB | Puts the most recent (or navigated-to) item back on the clipboard. Click a format container first to focus it; recall uses the Prev/Next position. |
| Auto-Save | When on, every clipboard change is saved immediately — hands-free continuous capture. It does not save what was already on the clipboard before Kolate started; press Save CB if you want to keep that. When off, you press Save CB yourself. |
| Allow duplicates | When ticked, identical content can be saved more than once; unticked blocks exact duplicates, and the save notice says so. |
| SD (Show Duplicates) | Shows duplicates of the last saved entry — the latest duplicate, browse all with Prev/Next, and a count. |
What the lamp tells you
| Lamp | Meaning |
|---|---|
| Orange, then green | Saved. It turns green about five seconds after the save. |
| Red | Nothing was saved — nothing recognisable was on the clipboard, or it was an exact duplicate that was blocked. |
| Orange (stays) | The clipboard was busy in another program (press Save CB again in a moment), or the save went through but another entry has the same title and summary. |
| Steel blue | The clipboard only holds something you copied out of Kolate, so there was nothing new to save. |
Save CB needs a session: with none, Kolate says “Please enter a session name before saving.” and puts the cursor in
the Session box. A blank Category is filled in for you as Category_ plus the date and time.
The title and summary strip
For TXT, RTF, HTML, PNG, BMP, JPEG, GIF, SVG, PDF and File Collections, Kolate never stops to ask for a title. It saves at once with the title “BaseTitle_Suggestion”:
- the base title is the title you set — typed in the Title box, picked from its history, or given in the New Session dialog;
- the suggestion is taken from the content — for example the first meaningful words of a text, or a picture's file name (Part 3 §3.7);
- the two are joined with an underscore; if one is empty, or both are the same, only one is used.
Right after the save, a small light-amber strip appears at the bottom-left of the deck. It never takes the keyboard away from you:
- “Saved as:” shows the title just saved — “pick another title, or ignore to keep it”.
- 1 uses your base title only; 2 uses Kolate's suggestion only; 3 Own title... lets you type your own and press Enter or OK. The choice re-titles the entry you just saved.
- Summary: shows the saved summary. Edit it (the box widens while you type), or press Suggested for Kolate's summary or Previous for the summary of the entry saved before this one, then Apply. In the summary box Enter applies, Shift+Enter starts a new line and Esc puts back the saved text.
- A note line appears when needed — for example “'X' already exists in this session - saved as 'X (2)'.”
- × or Esc closes the strip and keeps the saved title.
The strip closes by itself on your next Save CB, UPDATE PAGE or Clear Fields, shortly after you make a choice, or after about 15 seconds left alone. Click on the strip and it waits for you instead.
Naming WAV, MIDI and URL saves
- WAV / MP3 and MIDI — the container opens full size and a cyan name box takes the cursor, filled with the tile's current name and fully selected. Type a friendly name and press Enter, or ignore it to keep the name.
- URL — the label box takes the cursor: “Type label for URL, press Enter (Esc to cancel)”. A link left without a label is named after its web site. For the first link on a URL page, the title and summary strip then appears for the URL page itself; later links on that page are named by their label only.
The save notice
A coloured bar inside the SAVE • RECALL • NAVIGATE card, just under Prev / Next, tells you why a save did or did not happen. It pulses briefly, hides after about eight seconds, and stays while the pointer is over it. Each notice is also kept in the bell's list (§2.14).
- “Not saved - exact duplicate of entry n. Tick 'Allow duplicates' to save it anyway.” — the Allow duplicates box flashes too, so you can see where to tick.
- “Duplicate of entry n saved ('Allow duplicates' is ticked).”
- “Saved - note: entry n has the same title and summary.”
- “Not saved - this URL is already on the page: … Tick 'Allow duplicates' to add it again.”
If the card is closed or out of sight, the same message appears as a toast instead.
2.5 Copying Back Out — the Copy Button and Attach Bar
Recall is not the only way out. In every format container's header there is a 📋 Copy button and an attach bar that copies the item you are viewing back to the Windows clipboard in different shapes — so it pastes cleanly into whatever app you are heading to.
| Button | What it copies | Use it when… |
|---|---|---|
| 📋 Copy | The item in view, back to the clipboard in its native format. For MIDI/WAV it copies the checked tiles as files with their friendly names. | …you just want it back on the clipboard as it is. |
| Copy (attach) | The item in view, to the clipboard exactly as shown. | …pasting the visible content into another app. |
| File | Turns the view into a file of its format, then copies that file. | …the target wants a file, not inline content. |
| Zip | Turns the view into a file, zips it, and copies the zip. | …emailing or attaching a compressed file. |
| Append | Appends to what is already on the clipboard (by default as a new row). | …building up a multi-part clipboard payload. |
| Append ▸ Row | Appends the view as a new row. | …adding a line/row to the existing entry. |
| Append ▸ Collection | Appends the view's file as a file collection (paste into a folder). | …gathering several files to drop into a folder. |
2.6 The PSA Grid (Top)
The PSA (Page / Slot / Assign) grid is the coloured shortcut grid above the format containers. Each page shows 36 lettered slots (0–9 then A–Z). A coloured slot is filled — its colour is the format's signature colour (Part 1 §1.1); a grey slot is empty.
- Click a filled slot to recall its item instantly.
- The ▲ / page / ▼ control chooses which page the grid shows.
- Alt+PgDn and Alt+PgUp step to an older or newer archive set in the grid; the status line names the set you are on (“Newest set”, “Archive set N”).
- A colour legend under the grid reminds you which colour is which format.
- Helper buttons let you assign the most recent item and clear a slot.
2.7 Assigning Items to Grid Slots
To pin an item to a specific slot, use the PAGE ➜ SLOT ➜ ASSIGN card:
- Choose the Page from the page dropdown.
- Choose the Slot from the slot dropdown.
- Press ASSIGN to place the current item there. CLEAR empties the chosen slot.
From then on, that slot is a one-click recall for the item.
Back to contents2.8 Format Containers, Navigating Pages and the Mouse Wheel
The centre holds one format container per format, each a live preview with its own header. The header is where you move through the pages of that format:
| Control | What it does |
|---|---|
| Status lamp + page dropdown | Shows the container's state and jumps to any page (the dropdown appears whenever the session has more than one page). |
| ⏮ First / ◀ Prev / Next ▶ / Last ⏭ | Step through pages one at a time, or jump to the first/last. |
| Go (with page box) | Type a page number and jump straight to it. |
| ◀◀ Auto / Auto ▶▶ + interval + ■ Stop | Auto-advance through pages; the seconds box sets the dwell between steps; Stop halts it. |
| 🔍 Scan | Runs the Find scan across pages — it moves quickly through non-matching pages and dwells on hits (Part 5). |
| Session / Global toggle | Switches navigation between this session's pages only and the whole store. |
| V (nav cycle) | Cycles how much of the navigation strip is shown — the basic pager, then First/Last/Go, then Auto-advance, then Scan. |
| Maximise / Restore | Expands the container to fill the deck, or restores it. |
Container toolbars never cut buttons off: anything that does not fit moves into a » “More” drop-down at the end of the toolbar.
The mouse wheel scrolls anywhere
- Wheel — scrolls whatever is under the pointer: the innermost area that can still move up or down. When that area reaches its end, the wheel passes outwards to the next one (the page text, then the container…).
- Over parts that cannot scroll up or down, the wheel moves the deck of containers sideways.
- Shift + wheel — the same, but sideways.
- Ctrl + wheel — left alone, so zooming in pictures and previews still works.
- An open drop-down list scrolls itself, and HTML and PDF pages handle the wheel themselves.
2.9 The Command Bar (Bottom)
The command bar carries the actions that operate on the focused item or format. Its buttons have a raised, three-dimensional face that visibly sinks when you click, so you can see at once that the click landed. When the window is narrow, the labels shorten (for example FREEZE → FZ, Start Fresh → SF, Del Session → DS).
| Control | What it does |
|---|---|
| Inspector | Opens the Inspector for the maximised format — the tile Inspector for WAV, MIDI and URL, or the Page Inspector for TXT, RTF, HTML and the other paged formats (Part 9). Maximise a format first. |
| Jump-to-format | Focuses and maximises the chosen format's container. |
| Latest-format button | Shows “—” until you save; then shows the most recently saved format and turns amber. One click jumps to and maximises that format. |
| FREEZE | Freezes container order so nothing auto-reorders while you work; it stays pressed in while on. |
| Delete | Deletes the focused item (asks for confirmation). |
| Insert | Inserts before the current item, shifting the rest down. |
| Swap (with two index boxes) | Swaps two items within the same format; click an index box to auto-fill it. |
| Copy | Copies the focused item to the clipboard — the same as Recall CB. |
| Apply | Saves your edits to a TXT, RTF or HTML page (and confirms deletes). It lights up while the focused page has unsaved edits (§2.12). Picture and SVG edits are saved with Save in their own editor instead and never light Apply (Part 4). |
| Commit-on-leave mode (Auto-save / Ask / Off) | What happens to unsaved edits when you leave a page, switch session, or close Kolate. Auto-save (the default) saves them silently with a toast; Ask offers Save / Discard / Cancel; Off discards them (Part 4). |
| Start Fresh | Clears the whole store after showing a per-format summary, and offers a full backup first (recommended). Your activation is kept (Part 3 §3.8). |
| Cleanup | Removes entries whose files are missing, repairs titles, fills in missing page numbers and compacts the database (Part 3 §3.8). |
| Del Session | Removes the current session — its entries and stored files — after a confirmation (Part 3 §3.2). |
| VIEW n/5 | Steps to the next of the five VIEW states (§2.11). |
Below the buttons sit the red summary / comments box, the Ext Functions runner — a dropdown plus RUN FUNCTION that runs your own program on the focused clip's file (Part 10) — the TOOL TIP TEXT INFO status strip, and the app toggles:
| Toggle | What it does |
|---|---|
| VIEW n/5 (F11) | Steps through the five VIEW states (§2.11). |
| LOGGING OFF / LOGGING ACTIVE | Turns the diagnostic log on for this run; it starts off (Part 1 §1.3). |
| Manage Logs | Opens the log tools — save, search, organise and review logs, backup and media audit (Part 10). |
| ToolT ON / OFF | Shows or hides the hover tooltips; your choice is remembered. |
| OPEN: External / OPEN: Embedded (F9) | Opens web-style content externally (default) or in the embedded view. |
| Close on Switch | When ticked, closes the previous embedded browser when you switch to another URL. |
2.10 The Per-Format Activity Counter
The small round counter badge in each container header counts the Copy / attach-button clicks you have made for that format, in the current session. It is a quick tally of how much you have copied out of a format this sitting.
- The count is separate for each format — TXT has its own tally, WAV its own, and so on.
- Double-click the badge to reset just that format's count to zero.
- Counts are for the current session and are not part of your saved data.
2.11 Compact Mode and the Five VIEW States
Kolate gives you three ways to change how much is on screen:
- The five VIEW states — press F11, the VIEW n/5 button on the command bar, the VIEW n/5 toggle at the bottom, or View ▸ Toggle Compact Mode. All of them step through the same cycle, and the state you leave Kolate in is restored next time.
- The control panel width — the ↔ button in the panel header (§2.3).
- Per-format views — the V button in a container header cycles that format's own navigation strip (§2.8).
| State | What is shown |
|---|---|
| VIEW 5/5 | Everything. |
| VIEW 1/5 | No PSA grid — the slot squares, their navigation row and the Slot-Colours strip are hidden. |
| VIEW 2/5 | The grid is back, but nothing below the command bar (no red box, Ext Functions, status strip or bottom toggles). |
| VIEW 3/5 | The deck only. Because the command bar is hidden too, a small floating VIEW 3/5 ▸ chip appears at the bottom-right of the deck — click it to move on. |
| VIEW 4/5 | The Slot-Colours strip, the deck and the command bar. |
2.12 Feedback You Can Trust
Kolate always tells you what just happened, so you are never guessing:
| Signal | What it means |
|---|---|
| Save lamp | Orange right after a save, then green: the last Save CB succeeded. Red: nothing was saved. Steel blue: nothing new on the clipboard (§2.4). |
| Save notice | The bar under Save CB that explains a blocked or flagged save (§2.4). |
| Title and summary strip | Shows the title just saved and offers other choices (§2.4). |
| Toasts | Short messages that stack at the bottom-right of the active Kolate window — up to three at once. A repeated message shows “×2”, “×3” instead of stacking. Point at a toast to hold it; click it to close it. Set the minimum time they stay from Tools ▸ Preferences ▸ Toast Duration (§2.14, Part 11). |
| The bell | Counts new notifications and keeps a list of every message this session (§2.14). |
| Busy / wait overlay | Appears during longer operations so you know Kolate is working, not stuck. Some long jobs show a progress toast that stays until the job ends. |
| Pressed buttons | A button's face sinks when you click it, so you know the click landed — no need to press twice. |
| Apply light | Lit when a TXT, RTF or HTML page has unsaved edits; press Apply to save them. |
| Tooltips (ToolT) | Hover any control for a plain-language explanation; toggle them with ToolT. |
| Red comments box | Shows the current item's summary — and, while sound is playing, which page and tile is playing (♬). |
| Kolate's message boxes | Follow the theme. Enter presses the default button, Esc cancels, and Ctrl+C copies the message text. |
2.13 Light and Dark Themes
Kolate can show the whole application in light or dark colours.
- Choose View ▸ Theme.
- Pick Light or Dark. The active theme is ticked.
The switch is instant: every open Kolate window changes colour at once, and the status strip confirms “Theme: Light” or “Theme: Dark”. Your choice is remembered and used from the very start of the next launch. Light is the default, and Start Fresh does not change the theme.
2.14 Notifications and the Bell
Every message Kolate shows goes to one place, so nothing is lost. Questions that need an answer (Yes / No) still appear as dialogs.
Toasts
- Toasts appear at the bottom-right corner of the active Kolate window — a dialog if one is open, otherwise the main window. The newest is at the bottom; older ones stack upwards, with at most three on screen.
- They never take the keyboard, so typing and Save CB are never interrupted, and they float above page previews.
- Each has a coloured bar and icon for its kind: Info (blue), Success (green), Warning (amber) and Error (red), sometimes with a bold headline.
- The same message again within a minute does not add a new toast: the existing one shows “×2”, “×3”… and its timer restarts.
- Point at a toast to pause it; when the pointer leaves, it stays a few seconds more. Click it, or its ×, to close it.
- How long a toast stays depends on its kind — Success shortest, Error longest — but never less than the minimum you set in Tools ▸ Preferences ▸ Toast Duration (default 3 seconds; Part 11).
The bell
The bell sits at the right end of the menu row. A red badge shows how many new (unread) notifications there are; it is hidden when there are none and shows “99+” above 99. Click the bell — or choose View ▸ Notifications — to open the list:
- The header reads “Notifications” with “N new · M in all”.
- Each row shows the kind icon, the full message, its “×N” count, the time, and an × that removes that row. Unread rows are in heavier type.
- Mark all read clears the badge; Clear removes the rows you have selected (click a row first; Ctrl or Shift to pick several); Clear all empties the list.
- Closing the list marks everything as read. An empty list says “No notifications yet.”
The list covers this session only (newest first, up to 200 messages) and is not kept after Kolate closes. Save notices (§2.4) are recorded here too, under “Save CB”.
2.15 The Command Palette and the Keyboard Shortcuts Sheet
The Command Palette
You do not need to remember where a command lives. Open the palette, type part of its name, and run it.
- Press Ctrl+K (or Ctrl+Shift+P) in the main window, or choose View ▸ Command Palette… or Help ▸ Command Palette…. The Command palette window opens.
- Type any part of a command's name. Every word you type must appear in the command's name, its location or its tooltip; names that start with your first word come first.
- Choose with ↑ / ↓, then press Enter, double-click the row, or press Run ↵. The command runs exactly as if you had clicked it; a tickable menu item is ticked or unticked.
- The palette lists every menu command (with its menu path and shortcut) and every button and toggle visible on the main window and the containers, each with where it lives — for example “Main window” or “TXT container”.
- Commands that cannot be used right now are dimmed and marked “(not available now)”.
- Esc closes the palette, and it also closes by itself when you click elsewhere.
- Inside an RTF page, Ctrl+K inserts a hyperlink instead — use Ctrl+Shift+P there.
The Keyboard Shortcuts sheet
Help ▸ Keyboard Shortcuts… opens the Keyboard shortcuts sheet: every shortcut in Kolate on one page, grouped by area — everywhere, text pages, RTF and HTML, the Image Editor, the SVG Editor, and dialogs. Esc closes it. The keys that work everywhere are:
| Keys | What they do |
|---|---|
| Ctrl+K or Ctrl+Shift+P | Command palette — find and run any command. |
| F1 | The user guide (Part 1 §1.5). |
| F9 | OPEN mode: embedded / external. |
| F11 | Step to the next VIEW state (§2.11). |
| Alt+PgUp / Alt+PgDn | Newer / older archive set in the grid (§2.6). |
The complete list of keyboard and mouse shortcuts is in Part 13.
Back to contentsPart 3 — Sessions, Pages & the Store
Everything you save is organised into sessions, split into pages, and kept inside one portable folder called CIMAdb. This part explains how sessions work, how pages are numbered and deleted without ever leaving a hole, how Kolate titles your saves, and how to back up, clear, merge and carry your whole store to another computer. It ends with My Profile — your personal settings, which live outside the store and travel separately.
3.1 Sessions — Start New, Continue, Resume Any
A session groups everything you save under one name. When Kolate starts it brings back the session that was in play when it last closed — content, pages, and the last Category, Title, Importance and Summary — so you continue exactly where you left off (in every edition). Save CB always needs a session; with none set, Kolate asks you to enter one first.
| Action | How |
|---|---|
| Start new | Tools ▸ Sessions ▸ New Session…, or the New Session button under the METADATA card. Name it and give its Category, Title and Importance, then confirm. The Title you give becomes the session's base title for automatic titles (§3.7). The deck clears (previous data stays safe in the database) and it looks like a fresh start, bound to the new session. |
| Continue | Just keep saving — everything lands in the current session. |
| Resume any | Pick an earlier session from the Session dropdown, or type its name in the Session box and press Enter; it returns exactly as it was left, including the latest metadata. |
Edition difference: the Unregistered edition offers only the current session; the Registered edition lists every session, most-recently-active first (Part 1 §1.4).
3.2 Renaming, Merging and Switching Sessions
- Rename, move or unlock the active session — the Change... button beside the Session field. (A 🔒 beside the Session field shows that the session is locked.)
- Rename or merge — Tools ▸ Sessions ▸ Rename / Merge Sessions… opens the Edit / Merge Sessions window. Choose Edit one session or Merge two sessions into one, pick the Session (and the Second session for a merge), fill in the New Session Topic and New Session Sub-Task, and press Apply. Editing keeps the session's date; merging keeps the later of the two dates. After a merge the pages are renumbered without gaps and the merged session loads at once — no restart. The status line reports how many items were re-labelled.
- Delete a session — the red Del Session button removes just one session (its rows and stored files) after a confirmation that summarises what goes. Sessions are keyed by name, so deleting one never renumbers or disturbs the others.
3.3 Pages and Page Order
Paginated formats (TXT, RTF, HTML, images, SVG, PDF, URL, WAV, File Collections) store each save as a numbered
page of the session. The container header shows a page dropdown whenever the session has pages — full titles,
never truncated — so you can jump straight to any page. A single-page session simply reads Page 1/1 — title.
The dropdown appears reliably after a restart for every paginated format, including SVG, BMP, JPEG, GIF and PDF.
TXT pages and picture pages also have a New Pg button that adds the next page by hand — for pictures, a blank
picture ready to draw on (Part 4).
3.4 Deleting Pages — Continuity Guaranteed
Deleting a page never leaves a hole. The instant a page goes, the remaining pages of that format in that session
are renumbered contiguously 1..N — the gap is filled by the pages in front, and the pager, the
Page x/y label and the title dropdown are rebuilt in sync. Delete pages in any order (3rd, then 7th,
then 2nd) and you always end with a clean, continuous run.
If a format's last page is deleted, its container leaves the deck entirely — no empty ghost remains. If old experiments left orphaned records behind, press Cleanup once: it removes records whose files are gone and closes the numbering gaps in the same pass (§3.8).
On tiled pages (MIDI, WAV, URL)
Press Delete while a tiled page is on display and Kolate asks one clear question — “What should I delete?” — with two choices:
- Delete only the ticked tile(s) — exactly the tiles you have ticked (greyed out when nothing is ticked).
- Delete this specific page only — the tiles on this page and nothing else; other pages are untouched. This one asks you to tick “Yes, I'm sure”, and the OK button names the action (e.g. “Delete this page (12)”).
Page re-flow: after any deletion, later tiles are pulled up across page boundaries so pages 1…N−1 stay full at your per-page limit and only the last page is partial. A page emptied by deletion is removed entirely — from the deck, the dropdowns and the database. A “Deleting… please wait” overlay shows during longer deletes.
Back to contents3.5 Friendly Names — What You See vs What Kolate Stores
Inside the database every stored file is given a unique internal name so nothing can ever clash or be overwritten. You never need to see that. On every tile, header, dropdown and copy, Kolate shows a friendly name instead, resolved in this order:
- the name you registered for the item, else
- the row's Title, else
- only as a last resort, the stored file name.
The raw internal path appears only in a hover tooltip, never on the tile face. That is why a WAV tile reads “stored in CIMAdb ✔” rather than a long path, and why MIDI and URL tiles show the label you typed. Renaming a tile changes only the friendly name; the internal identity is untouched, so playback, ordering and portability keep working.
Back to contents3.6 Renaming Tiles and the Page Title
These are two different things:
- The page Title names the whole page. Right after a save you can change it from the title strip (Part 2 §2.4). At any later time, edit it in the MODIFY CURRENT ENTRY METADATA panel on the left — type into the T field and press UPDATE PAGE (or Enter). The Title dropdown in the container header then shows that title, and you can pick any page from it to jump there. The page's summary is changed the same way, in the Σ field just below T.
- Each tile's own name (a sub-title). Right after you save a WAV, MIDI or URL tile, its name box takes the cursor — type a name and press Enter. Later, right-click the tile's name field, type the new name and press OK. Editing a tile name never affects the page Title, and editing the page Title never disturbs the tile names.
T-field shortcuts: click the T field once to select all its text (so a new title replaces the old one in a single keystroke), and the ✕ button beside it clears it instantly.
Back to contents3.7 Automatic Titles and Summaries
Kolate titles every save for you, without stopping to ask, and then lets you change its choice from the title strip (Part 2 §2.4). This applies to TXT, RTF, HTML, PNG, BMP, JPEG, GIF, SVG, PDF and File Collections.
How the title is made
- Your base title. The title you set for the session — typed in the Title box, picked from its history, or given in the New Session dialog. It is kept across restarts. Kolate's own filling of the Title box while you navigate or recall does not change it.
- Kolate's suggestion, taken from the content:
- TXT, RTF and HTML — the first meaningful line, cut to at most 6 words and 48 characters at a word boundary, with trailing punctuation trimmed. RTF and HTML are read as plain text first, so a title never shows raw markup.
- PNG, BMP, JPEG and GIF — the file name (without its extension) when you copied a file; when you copied the picture itself, its format and size, such as “PNG 640x480”, plus the number of frames for an animation.
- SVG — the file name, else the drawing's own title, else “SVG” and its size.
- PDF — the file name, else the document's own title.
- File Collection — the first file's name plus “+N more”.
- The saved title is “BaseTitle_Suggestion” — the two joined with an underscore. If one of them is empty, or both are the same, only one is used. If both are empty, the title is the format and the date and time.
Repeated titles
Within one session and format, a title that already exists is numbered — the first is bare, then “ (2)”, “ (3)” — so pages stay distinct. Kolate tells you when this happens, in the title strip: “'X' already exists in this session - saved as 'X (2)'. Pick or type another title if you prefer.”
The automatic summary
If you leave the Summary box blank, Kolate writes one:
- text formats — the format in brackets (for example “[TXT]”) followed by the one or two meaningful lines after the title line, cut at the first full stop or 150 characters;
- pictures and other files — the format, file name, size and, for pictures, the dimensions (and frames);
- File Collections — the number of files and their first names.
The strip's Suggested and Previous buttons let you swap the summary afterwards (Part 2 §2.4).
WAV, MIDI and URL
Sound, MIDI and link tiles keep their own naming: each tile is named after its file (or, for a link, the label you type, else the web site's name), and you can rename it in the name box straight after the save. The first link on a URL page also brings up the title strip for the URL page, with the link's label as the suggestion.
Back to contents3.8 The Database Tools
All under Tools ▸ Database (Start Fresh and Cleanup are also on the command bar):
| Tool | What it does |
|---|---|
| Database Status… | Opens Database Migration Status: the store's schema history (Version, Migration Name, Applied, Applied Date), how many migrations are applied, the current schema version, and whether the database validates (“✓ Valid” or “✗ Issues detected”). Refresh re-reads it; Copy Status copies a text report you can send to support. |
| Cleanup Database… | Runs straight away, with no question. It checks every clip: removes rows whose files are missing (and closes the page-number gaps they leave), repairs older titles that show raw RTF source, fills in page numbers for older entries that had none, and compacts the database. The status line reports what it did; “Store is healthy” means nothing needed fixing — a good result, not a failure. |
| Database Location… | Points Kolate at the folder holding its complete data set (§3.10). |
| Merge Database… | Imports another computer's CIMAdb into this one (§3.9). |
| Start Fresh… | Clears the whole store so you can begin clean, with an optional full backup first (below). |
Start Fresh — step by step
Start Fresh asks three times before anything is removed:
- The summary (“Start Fresh - Kolate”) lists what will be cleared: the number of entries for each format and the total, all files in the store, and the grid assignments, search history and ticked tiles. It ends “Your activation is kept.” and asks whether to continue.
- The backup question (“Start Fresh - Back up first?”):
- Yes (recommended) — makes a full copy of the whole data folder beside it, named after the folder plus the date and time and “_from Start Fresh delete operation”. To restore it later, close Kolate and rename that copy back to CIMAdb.
- No — clears without a backup.
- Cancel — stops Start Fresh; nothing changes.
- The final confirmation, worded to match your choice — “A full backup will be made first, then the store will be cleared.” or “No backup will be made. This cannot be undone.”
Kolate then switches Auto-Save off, empties the database and the stored files, forgets the ticked tiles and the last session, and clears the deck, the grid and the metadata boxes. The status line confirms it and asks you to name a new session.
3.9 Merging Two Databases
Tools ▸ Database ▸ Merge Database… folds another computer's store into this one. Pick the other
cima.db (from a USB copy of that computer's CIMAdb folder) and:
- items and files are added here with fresh identities;
- exact duplicates are skipped;
- pages of a session that exists on both machines continue after your last page, in their original order;
- the source database is opened read-only and never changed.
If you pick this computer's own database by mistake, Kolate says so and asks you to pick the copy from the other computer. If the stored files are not beside the chosen database, Kolate warns that the records can merge but their files cannot be copied, and asks whether to continue. When it finishes, a summary shows the items imported, the duplicates skipped and the files copied.
Databases merged from several machines re-link their file paths automatically in the same pass (§3.10).
Back to contents3.10 Portability — Carry CIMAdb Anywhere
Everything you save lives inside the CIMAdb folder: the database and every copied file — URL sheets, sounds, MIDI files, images and File Collections are all copied into the store when saved. There are no links to files outside CIMAdb, so the whole folder is portable.
- Copy the entire CIMAdb folder to the other computer (a different user profile, drive or folder layout is fine), or to a USB stick or network share. Kolate does not move the data for you, so do this first.
- On that computer, choose Tools ▸ Database ▸ Database Location…. A folder browser opens: pick the folder that holds the complete data set (use Make New Folder to create one).
- Kolate saves the location and asks “Restart Kolate now?”. Answer Yes — Kolate restarts on the new location and re-links every stored file automatically.
Going back to the default: open Database Location…, cancel the folder browser, and answer Yes to “Return the database location to the DEFAULT?”.
Kolate re-links stored files to whichever computer and folder the store now sits in, so your collections look identical on the new machine, friendly names and all.
3.11 How Big Can It Get?
There is no limit on the number of sessions, nor on the number of pages a session may hold — both grow with your data. What you can set is how densely each page is packed: the number of PSA grid pages (36 slots each), how many tiles fit on a URL / sound / MIDI page, and the file-collection cap. Those are covered in Part 11 (Setup Limits); in the Unregistered edition they are fixed at 1 grid page, 12 tiles per page and 25 files (Part 1 §1.4). As a rule of thumb, values in the low tens keep the grids fast; very large per-page counts create very many tiles and slow the interface.
Back to contents3.12 My Profile — Carry Your Settings
Your profile holds your personal settings. It is kept in its own Kolate_Profile folder, outside the database, so it stays when the database is renamed, moved or started fresh. It holds:
- the last text colour and highlight used on RTF and HTML pages, and the recent colours (up to 12) shared by every colour picker;
- the Image Editor's last drawing colour and background colour;
- your New Pg blank-picture choice — size and white or transparent background;
- remembered printers and print settings, kept separately for TXT pages, RTF pages and A4 prints;
- My dictionary — the words you added to the spell checker.
The theme is not part of the profile; it is kept with Kolate's other settings in the data folder (§2.13).
The Tools ▸ My Profile menu
| Command | What it does |
|---|---|
| Export my profile… | Saves the whole profile, including your dictionary, as one .zip file — by default in Documents, named Kolate_Profile_ plus your Windows user name and the date. A toast confirms “Your profile was saved to …”. Use it to carry your settings to another PC or keep them with a backup. |
| Import a profile… | Loads a .zip made by Export. Kolate first asks “Replace your personal settings with the ones in this file?”. Everything in the profile is replaced — colours, printers, the New Pg choice and the dictionary. Your current profile is kept aside in a folder named Kolate_Profile_before_import_ plus the date and time, so nothing is lost, and your entries and pages are not touched. A toast confirms “Profile imported.” |
| My dictionary… | Opens the My dictionary window: see, add, find and remove the words that are never marked as spelling mistakes on TXT and RTF pages (Part 4). |
| Open the profile folder | Shows the Kolate_Profile folder in Explorer. |
Part 4 — Working with Each Format
Kolate is not just a viewer. Plain text, rich text and HTML are edited right inside their page, each with a full toolbar. Pictures (PNG, BMP, JPEG, GIF) open in the Kolate Image Editor, and SVG drawings open in the Kolate SVG Editor, which can also export a PNG. PDF is viewed with a zoom toolbar. This part documents every editing control, how Apply locks in a text change, how Kolate makes sure you never lose an edit, what each format puts back on the clipboard, how New Pg adds blank pages and pictures, the English (UK) spell checker with your own dictionary, and how Kolate remembers your printers.
4.1 View or Edit — What Each Format Allows
| Format | How you work with it | How an edit is saved |
|---|---|---|
| TXT | Editable in place with a grouped notepad toolbar, Find & Replace with Regex and Highlight all, a delimiter helper, spell check and a status line (§4.2). | Apply (§4.7) |
| RTF | Editable in place with a full word-processor toolbar — fonts, colours, styles, alignment, lists, hyperlinks, pictures, tables, spell check and a status line (§4.3). | Apply (§4.7) |
| HTML | Editable as the rendered page or as HTML source, with its own toolbar (§4.4). | Apply (§4.7) |
| PNG, BMP, JPEG, GIF | Viewed at size (GIF animates). Edit opens the Kolate Image Editor; GIF frames can be edited too (§4.5). New Pg adds a blank picture page (§4.10). | Save in the editor |
| SVG | Viewed with a zoom toolbar. Edit opens the Kolate SVG Editor, which also exports a PNG (§4.6). | Save in the editor |
| Viewed with a zoom toolbar and printed (§4.6). PDF is view-only. | — | |
| URL, WAV/MP3, MIDI, File Collection | Tiled subsystems with their own editors — covered in Parts 6, 7 and 8. | See those parts |
For TXT, RTF and HTML one rule holds: an edit is not permanent until you press Apply (§4.7). Until then the change is live on screen but not yet written to the store — and Kolate guards it for you if you try to leave (§4.8). Pictures and SVG work differently: their editors open in a separate window, and pressing Save there writes the change at once. In both editors Kolate always keeps the first original, so you can put it back.
Back to contents4.2 Editing Plain Text (TXT)
A TXT page is editable directly in the preview. Its toolbar sits on the page-title row of the TXT container and is arranged in groups, left to right: Edit | Find | Format | Text ▾ | Delimiter | New Pg | More ▾. If the container is too narrow to show every button, the ones that do not fit move into a » menu at the end of the row (“More commands (the row is too narrow to show them all)”), so nothing is ever cut off.
| Control | What it does |
|---|---|
| Undo / Redo | Undo the last edit (Ctrl+Z); redo the last undone edit (Ctrl+Y). |
| Find | Find text in this page (Ctrl+F). Opens the Find & Replace window (below). |
| Replace | Find and replace text in this page (Ctrl+H). |
| Go To | Go to a line number (Ctrl+G) through the “Go To Line” dialog. |
| Font | Opens the “Font” dialog: font family, “Size:”, “Style:” Bold / Italic / Underline and a preview (“AaBbYyZz 0123”). It changes how this page is displayed — plain text carries no formatting of its own. |
| Size | The displayed text size for this page: 8, 9, 10, 11, 12, 14, 16, 18, 20, 24, 28, 32, 36, 48 or 72. |
| Wrap | Word wrap on or off — long lines continue on the next line. |
| Text ▾ | Text tools: change case, sort / trim / de-duplicate lines, insert date and time (below). |
| Delimiter box, COL / ROW, Apply Delim | The delimiter helper — turns delimited text into columns or rows, and back (below). |
| New Pg | Creates the next TXT page through Save CB, then asks you to re-title it (§4.10). |
| More ▾ | “Word Wrap”, “Line Numbers”, “Spell check (English UK)”, “Character / Word Count…”, “Print Preview…”, “Print…” and “Page Setup…” (below). |
Wrap, font, size, line numbers, the delimiter, page setup and spell check are kept per page, with the page itself. The settings you used last become the starting point for new pages.
The Text ▾ menu
Each command acts on the selection. With nothing selected it acts on the page body below the title line — the title line is left alone, and the status line says “(page body - the title line is kept)”. Every command is a single undo step and lights Apply.
- Change case — “UPPER CASE”, “lower case”, “Title Case”, “Sentence case.”, “tOGGLE cASE”.
- Lines (whole lines) — “Sort A → Z”, “Sort Z → A”, “Sort by number (2 before 10)”, “Reverse order”, “Trim spaces at both ends”, “Remove duplicate lines”, “Remove empty lines”.
- Insert date / time — the submenu shows live examples of each format (UK style), for example 25/12/2026, 25/12/2026 14:30, 25 December 2026, Friday, 25 December 2026, 2026-12-25, 14:30, 14:30:05, and an ISO 8601 date-and-time.
The delimiter helper — turn delimited text into columns or rows
The delimiter box holds the delimiter: pick , (the default), ;, | or :, or type your own — the box text is the delimiter. Then:
- Tick COL (columns: replace the delimiter with a TAB) or ROW (rows: replace the delimiter with a new line). Only one can be ticked at a time.
- Press Apply Delim. It is enabled only while exactly one box is ticked. Every occurrence of the delimiter in the page body is replaced; the title line is left alone.
- The tick boxes clear after each use.
It is reversible. If the body no longer contains the delimiter and a change was applied earlier, ticking a box again and pressing Apply Delim reverses the last change, putting the old delimiter back. Ordinary Undo works as well.
The More ▾ menu
| Item | What it does |
|---|---|
| Word Wrap | The same switch as the Wrap button (ticked when on). |
| Line Numbers | Shows a line-number gutter beside the text (ticked when on). |
| Spell check (English UK) | Underlines misspelt words in red (off by default; see §4.11). |
| Character / Word Count… | A message with “Characters (with spaces)”, “Characters (no spaces)”, “Words” and “Lines”. |
| Print Preview… | An A4 preview window, “Print preview - Text page”, using the Page Setup orientation and margin. |
| Print… | Prints the whole page text, with the printer you used last time for TXT pages and this page’s own orientation (§4.12). |
| Page Setup… | “Orientation:” Portrait / Landscape, “Units:” mm / inch, and “Margin:” (20 mm by default). |
Find & Replace
Find or Replace opens the Find & Replace window. It stays open while you keep working in the page.
- Find: box with Find Next; Replace: box with Replace. Enter in the Find box is Find Next; Enter in the Replace box is Replace.
- Options: Match case, Whole word, Wrap around (ticked by default) and Regex, with Replace All beside them.
- Regex — use a regular expression, for example
\d+for numbers or^for the start of a line. In Replace,$1inserts group 1. - Highlight all — marks every match on the page. The marks clear when the text changes or the window closes.
- Advanced — tick “Interpret \ escapes in Find/Replace (e.g. \t, \r\n, \xA0)” to search for tabs, line breaks and other special characters. Buttons insert \r\n, \n, \r, \t, \0, \xA0, \x20, \f, \s and \v; each button’s tooltip names its character.
- Close closes the window.
The status line
Under the page a status line reads, for example: “Ln 3, Col 7 · 12 selected · 120 words · 640 characters · 14 lines · spell check en-GB”. Lines are counted as real lines, so a long line that wraps on screen still counts as one.
Back to contents4.3 Editing Rich Text (RTF)
An RTF page keeps its formatting and is edited in place. Its toolbar is arranged in groups: Edit | Find | Font | Character | Paragraph | Insert | New Pg | Tools. As with TXT, buttons that do not fit move into the » menu.
| Control | What it does |
|---|---|
| Undo / Redo | Step edits backward (Ctrl+Z) and forward (Ctrl+Y). |
| Find / Replace / Go To | Ctrl+F, Ctrl+H, Ctrl+G — as in TXT (Find & Replace below). |
| Font box | Font family for the selected text — every installed font; you can also type a name. |
| Size box | Font size of the selected text, in the current unit. mm sizes: 2, 2.5, 3, 3.5, 4, 4.5, 5, 6, 7, 8, 10, 12, 16, 20. pt sizes: 8, 9, 10, 11, 12, 14, 16, 18, 20, 24, 28, 36, 48, 72. |
| mm / pt | The font-size unit. mm is the default; click to switch to pt and back. |
| B / I / U / S | Bold (Ctrl+B), Italic (Ctrl+I), Underline (Ctrl+U) and Strikethrough. |
| x² / x₂ | Superscript (Ctrl+Shift+=) and Subscript (Ctrl+=). The text is also set to 70 % size. |
| Last text colour A / last highlight | One click applies the colour you used last to the selection again. They start as dark red text and yellow highlight, are shared with HTML pages, and are remembered after a restart. |
| Colour ▾ / Highlight ▾ | Text colour, or highlight (background) colour, for the selection: Black, Dark Grey, Grey, White, Red, Orange, Yellow, Green, Teal, Blue, Light Blue, Purple; Highlight adds “No highlight”; both end with “More colours…” (the Windows colour dialog). A colour chosen here also joins your Recent colours (§4.5). |
| Clear formatting | Returns the selection to plain text. |
| Format painter | Copies the selection’s format; then select the text to paint. It works once. The status line shows “format painter: select the text to paint” while it waits. |
| Styles ▾ | Paragraph style: “Heading 1” (20 pt, bold), “Heading 2” (16 pt), “Heading 3” (13 pt) or “Normal” (11 pt). |
| Align ▾ | “Left (Ctrl+L)”, “Centre (Ctrl+E)”, “Right (Ctrl+R)”, “Justified (Ctrl+J)”. |
| Bullets / 1. Numbering | Turn the selected paragraphs into a bulleted or numbered list. |
| Decrease / Increase indent | Move the selected paragraphs left or right. |
| Spacing ▾ | Line spacing of the selected paragraphs: “Single (1.0)”, “1.15”, “1.5”, “Double (2.0)”. |
| Insert ▾ | A hyperlink, picture, table or the date / time (below). |
| New Pg | Creates the next RTF page through Save CB, then asks you to re-title it (§4.10). |
| Count | Character / word / line count for this page (the same message as TXT). |
| Prints this page with its formatting and tables, using the printer you used last time for RTF pages (§4.12). | |
| More ▾ | “Spell check (English UK)” (off by default; §4.11) and “Print Preview…” (A4 portrait). |
The Insert ▾ menu
- Hyperlink… (Ctrl+K) — the “Insert hyperlink” dialog asks for the “Address (https://...):”. Select text first to make it the link; with nothing selected the address itself becomes the link text. A link must stay inside one paragraph, and the address must be a complete web address (for example https://kolate.co.uk). Ctrl+K inserts a hyperlink only while you are typing in the RTF page; elsewhere in Kolate it opens the command palette.
- Picture… — inserts a PNG, JPG, BMP or GIF picture. Wide pictures are scaled down.
- Table… — asks for “Rows x columns (e.g. 3x4):” (3x3 is offered). Up to 100 rows and 20 columns.
- Date / time — the same formats as the TXT Text ▾ menu.
Find & Replace and the status line
The RTF Find & Replace window has Match case, Whole word, Wrap around, Replace All, Advanced (escapes) and Close. It has no Regex and no Highlight all — those are TXT only. Under the page a status line reads, for example: “Paragraph 3 of 12 · 5 selected · 120 words · 640 characters · spell check en-GB”.
4.4 Editing HTML — Rendered Page and Source
HTML is unique: you can edit it two ways, and switch freely between them with the toggle button in the container. It reads ✏ Edit HTML source on the rendered page and ◀ Back to rendered page (amber) while you are in the source.
- Rendered page (WYSIWYG) — the page is shown exactly as a browser would draw it, and is directly editable: click into it and type, and use the toolbar to format.
- HTML source — a plain-text editor where you edit the markup by hand; press ◀ Back to rendered page and the page re-renders with your changes.
Edit either view, then press Apply to save it back to the page. Beside the toggle a hint reads “unsaved changes — press Apply to save”, or “editing HTML source”.
The HTML toolbar
| Control | What it does |
|---|---|
| Undo / Redo | Step edits backward and forward. |
| Find / Replace | The Find & Replace window: Match case, Whole word, Wrap around, Replace All, Advanced (escapes) and Close; Esc closes it. No Regex and no Highlight all. |
| Go To | Go to a line — here each paragraph, list item, heading or table row counts as one line. |
| Font box / Size box / mm·pt | Font family and size for the selected text — pick, or type and press Enter. The size unit switches between mm and pt, as in RTF. |
| B / I / U / S | Bold, Italic, Underline and Strikethrough. |
| Last text colour, Colour ▾, last highlight, Highlight ▾ | The same colours, “No highlight” and “More colours…” as RTF; the last-colour buttons are shared with RTF pages. |
| New Pg | Creates the next HTML page through Save CB, then asks you to re-title it (§4.10). |
| Count | Character / word / line count. |
| Prints the rendered page through the browser print dialog. |
The HTML toolbar has no headings or paragraph styles, alignment, lists, indent, Insert menu, spell check or print preview — use an RTF page when you need those.
4.5 Editing Pictures — the Kolate Image Editor (PNG, BMP, JPEG, GIF)
A picture page shows the picture at size inside the container; an animated GIF plays in the preview. At the top right of every picture page sits a small row of buttons:
| Button | What it does |
|---|---|
| New Pg | Adds the next page of this format as a blank picture, ready to draw on (§4.10). |
| ▾ | Chooses the size and background of the next blank picture (§4.10). |
| Edit | Opens this picture in the Kolate Image Editor: rotate, flip, crop, resize, adjust, draw — and, for a GIF, edit its frames. |
| Original | Appears once the picture has been edited. Puts back the picture as it was first saved (see “The original is always kept” below). |
If Edit cannot work for an entry it is greyed out, and its tooltip begins “Edit is not available for this entry” and gives the reason — the stored picture file is missing, the stored file is not of the page’s format, or the entry points to a picture outside Kolate’s store (an older save of a copied file). Kolate never edits your own files: copy the picture again and press Save CB to get an editable entry.
The editor window
The editor opens in its own window, titled “Kolate Image Editor - <entry title> (<FORMAT>)”, centred on Kolate. The picture sits on a grey checkerboard so transparent areas are easy to see. A status line at the bottom reads, for example, “PNG 800 x 600 px · frame 1 of 5, 100 ms · zoom 100 % · tool: pen · selection 120 x 80 at 10,20 · not saved”.
Top toolbar — the whole picture
| Control | What it does |
|---|---|
| Undo / Redo | Ctrl+Z / Ctrl+Y — up to 40 steps. |
| Rotate left / Rotate right | Turns the picture a quarter turn. |
| Flip left-right / Flip top-bottom | Mirrors the picture. |
| Crop (toggle), then Crop | Turn on Crop, drag a rectangle, then press the Crop button (“Apply the crop”). |
| Resize | A panel with “Width”, “Height”, “Keep proportions” (ticked), “Apply” and “Cancel”. 1 to 20000 pixels each side. Enter applies; Esc closes the panel. |
| Adjust | A panel with “Brightness” and “Contrast” sliders (−100 to +100) and a live preview, then “Apply” or “Cancel”. |
| Grey | Turns the picture greyscale. |
| All frames (GIF only) | Ticked: Adjust and Grey change every frame. Unticked: only the frame shown. |
| Fit / 100% / zoom out / zoom in | Fit to window, actual size, and zoom in steps. The range is 10 % to 3200 %; Fit never enlarges past 400 %. Ctrl + mouse wheel also zooms. The live “N %” readout follows. |
| Restore original | Shown when an original is kept — puts it back (see below). |
| Save / Cancel | Save overwrites the entry (Ctrl+S); Cancel closes without saving. |
Rotate, flip, crop and resize always change every frame of a GIF. Drawing tools change only the frame shown.
Second toolbar — drawing tools
| Tool or setting | What it does |
|---|---|
| Select | Drag a rectangle; then Cut, Copy, Paste or Delete it, or drag inside it to move it. Ctrl+A selects the whole picture. |
| Cut / Copy / Paste | Ctrl+X / Ctrl+C / Ctrl+V. Copy with nothing selected copies the whole frame, onto the Windows clipboard (with transparency). Paste takes the Windows clipboard first, then Kolate’s own last copy. Cut needs a selection. |
| Pen | A thin hard line, as wide as Size. |
| Brush | Soft round strokes, twice as wide as Size. |
| Eraser | PNG and GIF: makes pixels transparent — the stroke shows pink until it is placed. JPEG and BMP have no transparency, so the eraser paints the Background colour. |
| Fill | Click an area to flood it with the colour. Tolerance (15 % by default, 0–100 %) decides how alike the colours must be; 0 % means exactly the same. |
| Picker | Click to take a colour from the picture; it becomes the drawing colour (“colour picked: #RRGGBB”). |
| Line / Rect / Ellipse | Drag to draw. Hold Shift for 45-degree steps, a square or a circle. The outline is as wide as Size; tick Filled to fill rectangles and ellipses with the colour. |
| Text | Click, type, press Enter (Esc cancels). The text uses the drawing colour; the Text size box offers 10–96 px (24 by default) or a typed value. |
| Colour | The drawing colour — swatches or hex. It starts with the colour you used last time. |
| ⇄ | Swaps the drawing and background colours, so you can draw with the background colour. |
| Background | The background colour (white, or the one you used last). The eraser, Delete and Cut paint it on JPEG and BMP pictures. |
| Size | Pen, brush, eraser and outline size in pixels: 1, 2, 3 (default), 5, 8, 12, 16, 24, 32, 48, 64, or type a value up to 256. |
| JPEG quality (JPEG only) | Save quality, 10–100 (92 by default) — higher means a better picture and a bigger file. |
A pasted or moved piece floats: drag it into place, then press Enter, choose another tool or click outside it to place it. Esc cancels it — a cancelled move puts the piece back where it was. While a piece floats, the status line adds “floating picture: drag it, Enter places it, Esc cancels”.
Choosing colours
Clicking Colour or Background opens a colour pop-up (the SVG editor uses the same one):
- Recent — up to 12 colours you used recently, newest first. They are shared by every colour picker in Kolate and remembered after a restart (the row is hidden until you have used a colour).
- 30 preset swatches.
- Hex box with OK — type #RGB, #RRGGBB or #AARRGGBB and press Enter.
To pick a colour that is already in the picture, use the Picker tool.
GIF frames
For a GIF a frame strip runs along the bottom of the editor. Each thumbnail is captioned with its number and delay, for example “#1 · 100 ms”; click one to show that frame.
| Control | What it does |
|---|---|
| Previous / Next frame | Step through the frames. |
| Play / Stop | Play or stop the animation in the editor. |
| Duplicate / Delete | Duplicate this frame, or delete it. A GIF needs at least one frame, so the last one cannot be deleted. |
| Earlier / Later | Move the frame back or forward in the order. |
| Delay (ms), Set, Set all | Type a delay from 0 to 60000 milliseconds, then Set it for this frame or Set all for every frame. New frames start at 100 ms. |
A saved GIF loops endlessly and keeps each frame’s delay.
Keyboard
| Key | Action |
|---|---|
| Ctrl+Z / Ctrl+Y | Undo / redo |
| Ctrl+S | Save |
| Ctrl+C / Ctrl+X / Ctrl+V | Copy / cut / paste |
| Ctrl+A | Select all (Select tool) |
| Del | Clear the selection (Select tool) — transparent on PNG/GIF, Background colour on JPEG/BMP |
| Enter | Place a floating piece, or apply Resize while its panel is open |
| Esc | In turn: cancel a floating piece, close Resize, cancel Adjust, drop the current tool |
| Shift (while dragging) | Constrain Line, Rect and Ellipse |
| Ctrl + mouse wheel | Zoom |
None of these keys act while you are typing in a box.
Saving — and the original is always kept
- Press Save (or Ctrl+S). The picture is saved in its own format (JPEG at the chosen quality), the editor closes, and Kolate overwrites the entry at once — Apply is not involved. The content hash is refreshed, so duplicate detection stays truthful, and the preview is redrawn. The session, title and other details are not touched.
- A toast confirms, for example “Picture saved - 800 x 600, 5 frame(s). The original is kept”.
- The very first Save keeps a copy of the untouched picture. Later saves never replace it, so the kept original is always the picture as first saved.
To put the original back, either press Original on the picture page, or press Restore original inside the editor (which also discards any unsaved changes in the editor). Kolate asks “Put the ORIGINAL picture back?” — Yes restores it, and the toast reads “The original picture is back.” The original stays kept, so you can restore it again after later edits.
Cancel, or closing the window, with unsaved changes asks “Close the editor and lose your changes?”.
4.6 PDF and SVG — the Zoom Toolbar, the SVG Editor and Export to PNG
PDF and SVG previews carry a toolbar inside the container:
| Control | What it does |
|---|---|
| Zoom − / live % / + | Zoom out and in; the percentage tracks live (SVG: 25 % to 500 %). |
| 100% | Return to actual size. |
| Open ▸ | Launch the file in your default application. |
| Print… (PDF only) | Opens the full print dialog — page ranges, save-as-PDF, and so on. |
| Edit (SVG only) | Opens the Kolate SVG Editor (below). It is not shown when the SVG cannot be edited — for example when the entry points to a file outside Kolate’s store. |
| Original (SVG only) | Appears once the SVG has been edited; puts back the SVG as it was first saved (“The original SVG is back.”). |
Ctrl + mouse wheel zooms directly in the preview and the % readout follows it. Inside the PDF viewer, text selection and Ctrl+F search work as normal. PDF pages are view-only.
The Kolate SVG Editor
Edit opens a separate window, “Kolate SVG Editor - <title> (SVG)”. It edits the real SVG shapes, so the drawing stays a sharp vector. The toolbar runs: Undo, Redo, the tools, the colour and size controls, the arrange and view buttons, Source, then Export PNG, Restore original, Save and Cancel. A status line shows the size, zoom, tool and selection, and “not saved” while there are changes.
| Tool (key) | How to use it |
|---|---|
| Select (V) | Click to pick a shape, drag to move it, drag the handles to resize (Shift keeps proportions; Alt+click picks a shape inside a group). |
| Line (L) | Drag; Shift snaps to 45 degrees. |
| Rect (R) / Ellipse (E) | Drag; Shift makes a square or circle. |
| Pen (P) | Draw a freehand path. |
| Text (T) | Click to type, Enter to finish; double-click a text to change it. |
- Fill and Stroke (outline) — colours for new shapes and for the selected shape. They use the same colour pop-up as the image editor (Recent, swatches, Hex), plus “None (no paint)” for no fill or no outline.
- Width — outline width: 0.5, 1, 2 (default), 3, 4, 6, 8, 12, 16 or 24. Text size — 10 to 96 (24 by default).
- Front / Back bring the selected shape to the front or send it to the back; Duplicate (Ctrl+D) and Delete (Del) act on the selected shape.
- Fit (Ctrl+0), 100%, - and + zoom the view; Ctrl + mouse wheel zooms too. Pan with Space+drag or the middle mouse button.
- Source — switches to the SVG source as text. Edit it, then press Source again to see the drawing (the change is one undo step). If the text is not a valid SVG, the drawing is not changed and you stay in the source view so you can correct it.
Other keys (when the drawing has focus): Ctrl+Z undo; Ctrl+Y or Ctrl+Shift+Z redo; Ctrl+S save; Ctrl++ / Ctrl+- zoom; Del or Backspace delete; Esc deselect; arrow keys nudge the selection 1 px (Shift+arrow: 10 px).
Saving works exactly as in the image editor: Save overwrites the stored SVG at once (no Apply), the first original is always kept, and Restore original in the editor or Original on the page puts it back. Cancel with unsaved changes asks “Close the editor and lose your changes?”.
Export to PNG
Export PNG opens the Export to PNG dialog, which turns the drawing into a picture:
| Setting | What it does |
|---|---|
| Size (px) | Width x Height, starting at the drawing’s own size. “Keep proportions” is ticked by default. Each side 1 to 16384 pixels; a large picture shows a note of the memory it needs. |
| Scale (%) | Type a scale and the size is filled in for you. |
| DPI | 72, 96 (default), 150, 300, 600, or type 10–4800. It is written into the PNG as its print size — the pixels do not change. |
| Background | Transparent (default) or White. |
| Send to | New PNG entry in Kolate (default) — saved like any Save CB, with the session, page, title strip and duplicate check; the title is “<SVG title> (PNG)”. File... — a Save dialog for a .png file. Clipboard — the PNG, with transparency, ready to paste. |
Press Export (or Cancel). If you were in the source view, your source changes are applied first. If another program is holding the clipboard, Kolate says so — just try again.
4.7 Editing and APPLY — Locking In a State
Whenever the focused container holds unsaved TXT, RTF or HTML edits, the Apply button turns lime green. It returns to normal once you save, or when you focus a container that has nothing to save. Pressing Apply commits the whole state at once:
- The edited content is written back to the clip's file.
- Session, Category, Title, Importance and Summary are written to the clip's database row, using the same blank-preserving rules as Save CB (a blank field never wipes an existing value).
- The content hash refreshes, so duplicate detection stays truthful.
- The status line reports honestly — success only when the row really updated (for example “Applied: TXT content + metadata saved (N bytes)”).
After Apply, closing and reopening Kolate brings the edited content and the exact metadata back. That is the guarantee your sessions are built on.
4.8 Never Lose an Edit — the Commit-on-Leave Guard
If you start to leave a TXT, RTF or HTML page, switch session, or close Kolate while an edit is unsaved, Kolate follows the mode you choose in the small combo beside Apply:
| Mode | What happens to your unsaved edit |
|---|---|
| Auto-save (default) | The edit is committed automatically before you leave — a toast says “Changes saved to this page”. If it cannot be saved, the toast says “Could not save this page - staying so nothing is lost” and you stay on the page. |
| Ask | The “Unsaved changes” dialog asks “This page has unsaved changes. Save them before leaving?” with Save (the default), Discard or Cancel. Esc or closing the dialog counts as Cancel: you stay on the page with your edits. If Save fails, you stay on the page. |
| Off | No commit and no prompt — you leave immediately, and the unsaved edit is not written. |
When you close Kolate or switch session, a toast reports how many pages were saved first. The mode is kept with your database. The image and SVG editors do not use this guard; they ask their own question, “Close the editor and lose your changes?”.
4.9 Pasting Back Into Other Applications
Every copy-out restores the item in its native clipboard form, so the receiving application sees exactly what it expects:
| Format | What lands on the clipboard |
|---|---|
| TXT | Plain Unicode text. |
| RTF | Real rich text (CF_RTF) plus a plain-text companion — Word/WordPad paste with formatting, Notepad pastes clean text. |
| HTML | The exact CF_HTML packet plus extracted plain text. |
| PNG / BMP / JPEG / GIF | A real bitmap — paste straight into Paint, Word or an editor. |
| SVG | Three forms at once: image/svg+xml (Inkscape pastes the graphic), the XML source as text (code editors), and a file drop of the .svg (paste into Explorer). For a PNG of the drawing, use Export PNG › Clipboard (§4.6). |
| The registered Portable Document Format stream. | |
| WAV / MP3 / MIDI | A file drop of the sound file(s); the WAV and MIDI grids copy the checked tiles carrying their friendly on-screen names. |
| URL | The collection as text lines. |
| File Collection | A file drop of the collection's files. |
4.10 New Pg — Blank Pictures and Pages
New Pg adds the next page of a format without copying anything first.
TXT, RTF and HTML pages
Press New Pg on the toolbar. Kolate creates the next page through Save CB, then asks you to re-title it — the Title box shows “NEW PAGE RE-TITLE REQUIRED”. Type the new title and update the page as usual.
Picture pages (PNG, BMP, JPEG, GIF)
On a picture page, New Pg is the first button at the top right (it is there even when Edit is greyed out). One click adds the next page of this format as a blank picture, using your remembered size and background — at first, the same size as this picture (800 x 600 if that is unknown) on white. The same re-title step follows. Then press Edit on the new page to draw on it (§4.5).
The ▾ button beside it chooses the size and background. The choice is remembered for the next New Pg, for every picture format, and after a restart.
| Menu item | What it does |
|---|---|
| New page size (adds the page now) — choosing any size adds the page immediately and remembers the size. | |
| Same as this picture (W x H) | The size of the picture you are on. |
| 800 x 600 | A small general-purpose page. |
| 1280 x 720 (HD, 16:9) | HD widescreen. |
| 1920 x 1080 (Full HD, 16:9) | Full HD widescreen. |
| A4 portrait (1240 x 1754, 150 dpi) | An A4 sheet, upright. |
| A4 landscape (1754 x 1240, 150 dpi) | An A4 sheet, sideways. |
| Custom size... | Opens the “New page size” dialog (below). Once used it reads “Custom size (W x H)...”. |
| Background (remembered) — these only remember the choice; they do not add a page. | |
| White | A white blank picture (the default). |
| Transparent | A fully transparent blank picture. PNG and GIF only — on JPEG and BMP pages it is greyed out, because JPEG has no transparency. |
The New page size dialog asks for the “Width” and “Height” of the new blank picture, in pixels (16 to 4000). A live hint shows the printed size at 150 dpi in centimetres. Press Add page to add it, or Cancel.
4.11 Spell Check and My Dictionary
TXT and RTF pages can check spelling in English (UK). HTML pages have no spell check.
- On the page, open More ▾ and tick Spell check (English UK). It is off by default and is set per page — the choice is saved with the page. The status line then ends with “spell check en-GB”.
- Misspelt words get a red underline. Right-click one to see:
- up to six suggestions in bold (or “(no suggestions)”) — click one to use it;
- Add “word” to my dictionary — the toast says ““word” was added to your dictionary.” Every open page updates at once, and the word is never marked again on any page;
- Ignore “word” on this page — until Kolate closes;
- Cut, Copy, Paste and Select all;
- My dictionary…
The My dictionary window
Open it from the right-click menu or from Tools › My Profile › My dictionary…. Words you added are never marked as spelling mistakes, on every TXT and RTF page. They are kept in your profile, so they stay when the database is reset.
- New word box with Add (Enter works too). Type one word, without spaces.
- Find filters the list as you type.
- The word list allows several selections; Remove (or Del) removes the selected words.
- The footer shows how many words you have; Close closes the window.
Because the dictionary is part of your profile, Tools › My Profile › Export my profile… carries it to another PC along with your colours and printers.
4.12 Printing and Remembered Printers
Kolate prints in several ways, and for three of them it remembers the printer and settings you used last time — paper, copies, colour, two-sided and so on — each kept separately:
| How you print | What it prints | Printer remembered? |
|---|---|---|
| Tools › Output › Print Page (A4)… | The page in view as an A4 sheet; the orientation is picked for you and can be changed in the print dialog (Part 10 §10.4). | Yes — for A4 prints |
| TXT More ▾ › Print… | The whole page text, with the page’s own Portrait/Landscape from Page Setup. | Yes — for TXT pages |
| RTF Print | The page with its formatting and tables. | Yes — for RTF pages |
| HTML Print, PDF Print… | The rendered page or the PDF, through the browser print dialog. | No |
- The Windows print dialog opens already set to your last printer and settings for that kind of print. After you print, the new choice is remembered.
- For A4 prints, the A4 size and the automatic orientation are applied on top of the remembered settings; for TXT, the page’s own orientation wins.
- If the remembered printer is no longer installed, Windows’ default printer is used.
- Check the layout first with Print Preview… — in TXT under More ▾ (A4, using Page Setup) and in RTF under More ▾ (A4 portrait).
Part 5 — Classification, Generate-Page & Search
Once you have saved a lot, three tools help you make sense of it: colour skins and classifications to group tiles by eye and by name, Generate Page to turn a group into a self-contained page you can share, and Search to find anything anywhere in your store. Skins, classification and Generate apply to the tiled formats — URL, WAV/MP3 and MIDI (Parts 6–8); Search covers everything.
5.1 Colour Skins — Colour Your Tiles
On the URL, WAV and MIDI pages a strip of twelve colour swatches (in the classification area — the 🏷 ORGANISE zone on WAV and MIDI) lets you tint tiles so groups stand out at a glance. Tick the tiles you want, then click a swatch — the colour is applied to the ticked tiles and persists. The skin belongs to the item itself, so it travels with the media and comes back the same after a restart or on another machine.
5.2 Classification — Naming Groups of Tiles
A classification is a named group you assign to tiles (for example “Drums”, “References”, “To review”). Where a colour skin groups by eye, a classification groups by name — and it is what Generate Page builds from (§5.3).
- New creates a new classification name (the names are shared with the URL system).
- The classification box chooses the classification to work with; NONE means unclassified.
- The count box beside it shows how many tiles carry the selected classification within the selected Generate-page scope (§5.3). Click it to open the review window: one row per tile (Seq, Name, Tile, Page, Category, Session, Status), with ▲ / ▼ to reorder, Delete row, Undo delete, Preview output, Save & Close and Cancel.
- Delete deletes the selected classification name (not the page). Every tile using it, on all pages, reverts to NONE.
Grouping across the whole session
The Group button arranges all pages of the session — colours first (in swatch order), then your classification order, with ungrouped tiles last — so related items sit together no matter where they were saved. View the outcome in the Inspector (Part 9).
- Ctrl+click a swatch ticks a whole colour group at once.
- ☑ Tick class ticks every tile carrying the selected classification — on this page for WAV, on all pages for MIDI. (On the URL page the ⇅ and ☑ buttons show the icon only.)
- The Classification order window (the ⇅ Order button) lets you arrange the order of the classification names — that order is the grouping order Group uses after the colours. NONE stays pinned at the top of the list. Moves are saved immediately, and the window remembers its size and position.
5.3 Generate Page — Build a Stand-Alone Page
The Generate page button produces a self-contained, offline page containing every tile of a chosen classification, with the media files copied beside it — no link back to the database, so the folder is fully portable and works on any machine.
On WAV and MIDI these controls sit in the 📦 BUILD & EXPORT zone; on the URL page, in the Generate page group. Choose the scope, pick the classification, then press Generate page.
| Scope | What it includes |
|---|---|
| Current page | Only the tiles on this page. |
| All pages (default) | Every page of this format in the current session. |
| All sessions | Every session — Registered edition only (greyed out in the Unregistered edition). |
The other build controls
| Control | What it does |
|---|---|
| Remove class | Clears the selected classification from the tiles in the selected scope. The classification name itself is kept. |
| Generated-zip list | Each generated page is also zipped under its classification’s name; the list beside the scope shows these zips. |
| 📋 Copy zip (📋 on the URL page) | Copies the zip chosen in the list to the clipboard as a file — paste it as an e-mail attachment; the receiver unzips it and the page works stand-alone. (This is different from the container’s own 📋 copy button.) |
5.4 The Generated Page's Player
A generated sound/MIDI page opens in your browser with its own player. Each entry's title is your editable tile label, sanitised for the web (every run of spaces becomes an underscore); the internal date-and-GUID file name stays in the background.
The player toolbar
| Control | What it does |
|---|---|
| Auto-Play | Plays the sequence in order; toggles to Stop. |
| Pause / Continue | Pauses the current piece; pressing again continues to the end. Listening time never counts while paused. |
| Skip | Abandons the piece currently playing (and its remaining repeats) and moves to the next. |
| Mode | What happens when Auto-Play completes: Straight plays once and stops; Random plays a shuffled order and reshuffles to continue; Total repeat restarts the whole sequence. |
Per-row controls and timing
- Repeat (0–24 per row) — the piece plays that many extra times before Auto-Play advances (0 = single play). It is read at the end of each pass, so changing it while a piece plays takes effect immediately, and the browser remembers it.
- Duration / Left / Time — the row's length, a live countdown while playing, and accumulated listening time.
- Time Left (above the table) — the overall remaining time: the current piece's remainder, plus its remaining repeats, plus every queued piece × (1 + its Repeat). It updates live and the instant any Repeat selector changes.
5.5 Search — Everything, Everywhere
Type a keyword in the Keyword (Session / Category / Title / Comments / Contents) box of the SEARCH card and press 🔍 Search (or Enter). Kolate looks in the fields you tick — Session, Title, Category, Summary and Contents. Contents is the text content of every page where text exists:
- TXT, RTF and HTML page text;
- URL sheets — every link, label and description;
- the tile labels of the WAV/MP3 sound grid;
- the tile labels of the MIDI grid.
A match anywhere brings the whole entry back.
Scope and filters
The Scope box chooses All Sessions or Current Session Only. In the Unregistered edition “All Sessions” is greyed out and the search is locked to the current session — so select or create a session first; the Registered edition chooses freely. These narrow things further:
- From / To — a date range, each with an optional time (hh:mm:ss);
- Whole word and Regex (regular expression);
- Require ALL selected fields (AND) — the keyword must match in every ticked field, not just one.
5.6 Reading and Walking the Findings
Findings appear in a combined view so you can read them at a glance:
- SEARCH RESULTS shows the total number of entries found, between ▲ UP and DOWN ▼, with an info line below.
- The large red box at the bottom lists every finding in order — number, format, session, title and which field matched — with the current entry marked ►.
- The S / C / T boxes show the current entry's Session, Category and Title.
- A small info area shows the matched field and a snippet of text around the match.
Walking through the results
| Control | What it does |
|---|---|
| ▲ UP / DOWN ▼ | Step through the entries — every view area follows along. |
| Select | Brings the current entry's page up in its format container, exactly as if you had navigated there yourself. |
| SHOW ticked (then Select) | Also opens the detailed preview window, with Prev/Next, Assign to GRID (PSA), Recall to First CCC, Copy to Clipboard and Open. |
| Clear | Empties every search field and every result area in one press. |
5.7 The Find Scan — Searching by Walking the Pages
Separate from the store-wide Search, each format container has a 🔍 Scan that walks the pages of the current format looking for your keyword. Reveal it with the container's navigation cycle (the V button steps the pager through Jump, Auto-advance and Scan; Part 2 §2.8).
- Enter one or more keywords with AND / OR matching.
- The scan moves quickly through non-matching pages and dwells on hits, so you see each match in place.
- A Pause (seconds) setting controls how long it lingers on each hit.
Use Search when you want a list of everything that matches across the store; use Scan when you want to watch the matches appear page by page within one format.
Back to contentsPart 6 — URL Collections
URLs are a full subsystem in Kolate: a tile grid of links you can label, classify, score, play in a controlled window, and export as a self-contained web page. This part covers the URL grid and its cells, the URL editor, the 18-metric URL Score Calculator, the page toolbar with its classification and housekeeping tools, playing links inside Kolate, and the generated link page. Classification and colour skins work as described in Part 5; the Inspector is Part 9.
6.1 Saving URLs and the URL Grid
Copy a link and press Save CB, or press Add URL... on the URL page to enter one by hand. URLs are stored in session pages, a fixed number of tiles per page (set in Setup Limits, Part 11). Each cell holds:
- the link itself;
- a friendly label — right-click to rename it;
- a position (Seq) box;
- a green Classification box (Part 5).
6.2 The URL Editor
Add URL... (or editing an existing cell) opens the URL editor, where you set everything about a link:
| Field | What it is |
|---|---|
| URL | The address itself. |
| Label | The friendly name shown on the tile. |
| Title / Category / Summary | Metadata carried with the link (searchable — Part 5). |
| Seq | Its position/order on the page. |
| Duration (s) | A dwell time, in seconds, stored with this link. |
| Playlist | Groups the link into a named playlist. |
| Classification | The named group this link belongs to. |
| CALC | Opens the URL Score Calculator for this link (§6.3). |
| OK / Cancel | Save or discard your changes. |
6.3 The URL Score Calculator (CALC)
The URL Score Calculator rates a website against 18 industry metrics, grouped into three sections — T (Technical & SEO), E (Engagement) and C (Conversion & Outcomes). For each metric you enter a Measured value (or Pass/Fail), optionally override the Threshold (a sensible Default is shown), and tick Use to include it. Press Compute and Kolate scores each section: a metric earns 1 point when the measured value meets its threshold — ≥for “higher is better”, ≤for “lower is better”, or a straight Pass.
| Section | Metric | Default threshold |
|---|---|---|
| T — Technical & SEO | Page Load Speed (LCP) | < 2.5 s |
| Core Web Vitals | Pass | |
| Mobile-Friendly | Pass | |
| Domain Authority | ≥ 30 | |
| Indexed Pages | ≥ 50 | |
| Referring Domains | ≥ 20 | |
| E — Engagement | Bounce Rate | ≤ 55% |
| Session Duration | ≥ 90 s | |
| Pages / Session | ≥ 1.8 | |
| Click-Through Rate (CTR) | ≥ 2% | |
| Returning Visitors | ≥ 25% | |
| Scroll Depth (75%) | ≥ 60% | |
| C — Conversion & Outcomes | Conversion Rate | ≥ 2% |
| Total Conversions | ≥ 50 / month | |
| Cost per Acquisition (CPA) | ≤ £20 | |
| Average Order Value (AOV) | ≥ £25 | |
| Return on Investment (ROI) | ≥ 150% | |
| Lifetime Value (LTV) | ≥ £100 |
Reset restores the standard thresholds. Use this as a quick, consistent scorecard when you are comparing or evaluating sites you have saved.
6.4 The URL Toolbar — Classification and Housekeeping
The URL page's toolbar has a header row of page actions, then three groups: Playlist: (§6.5), Classification and Generate page. Classification and grouping work as on the other tiled formats (Part 5).
Header row
| Control | What it does |
|---|---|
| Add URL... | Opens the URL editor for a new link (§6.2). |
| Save All | Saves the current grid. |
| Open All | Opens every URL on this page in the browser. When there are many, it asks first. |
| Copy Selected | Copies the ticked links, from any page, to the clipboard as text: one line per link, with the label, a tab and then the address (just the address when a link has no label). |
| Delete Selected | Removes the ticked links. |
Classification group
| Control | What it does |
|---|---|
| Colour swatches | Apply a colour skin to the ticked cells (Part 5). |
| ∅ | The NULL colour: removes the colour skin from the ticked cells, back to the plain look. It does not change their classification. |
| New / classification box / Delete | Create a classification name (shared across URL, audio and MIDI), choose the one to work with, or delete the selected one (every tile using it reverts to NONE). |
| Count box | Shows how many tiles carry the selected classification. Click it to review the list (Part 5). |
| ⇅ | Arranges the order of the classification names. |
| ☑ | Ticks every tile carrying the selected classification. |
| Group | Groups the tiles by colour, then by classification order (Part 5). |
Generate page group
| Control | What it does |
|---|---|
| Current page / All pages / All sessions | The scope for Generate page and Remove class. All sessions is for registered Kolate. |
| Generate page | Builds the standalone link page (§6.6) for the selected classification. It is saved in Kolate's Exports folder and opened in your browser, and its zip appears in the list beside 📋. |
| Generated-zip list / 📋 | Pick a generated page's zip from the list, then press 📋 to copy that zip to the clipboard as a file — ready to paste as an e-mail attachment. |
| Remove class | Clears the selected classification from the tiles in the chosen scope. The classification name itself is kept. |
6.5 Playing URLs Inside Kolate — the Playlist
You can step through links without generating a page. The Playlist: group plays the ticked cells' links in sequence:
| Control | What it does |
|---|---|
| Start / Stop | Start or stop the playlist. |
| Prev / Next | Jump back or forward one link. |
| Cycle | When ticked, the playlist starts again from the first link after the last. |
| Auto-advance | When ticked, moves on to the next link after Duration (s) seconds (default 30), so a set of links plays like a slideshow. |
| Seq: | Shows the order in which the ticked cells will play. |
6.6 The Generated Link Page
Generate page builds a static snapshot that is fully independent of Kolate — a folder you can keep, email or host. Kolate opens it in your browser when it is ready, and its zip is listed beside 📋 on the toolbar (§6.4). On the page, each row lets you:
- Open the link in a controlled player window — the page itself never disappears, and opening another row closes the previous player;
- Copy the URL;
- see accumulated watch Time;
- set an Order (remembered by the browser) and re-arrange by Order or by dragging;
- Auto-Play with a per-row dwell;
- Delete a row, with Undo and a warning if you close with changes.
Part 7 — Sound (WAV/MP3) & the Sound Studio · 7A — The WAV Page
Introducing Sound and the Sound Studio
Sound is the richest subsystem in Kolate. A WAV or MP3 you save does not just sit in a list — it lands as a tile in a grid that is really a small mixer: every tile has its own volume, pan, mute, solo and timing, and you can play many together in sync. That is the WAV page, and it is what this Part 7A covers.
Behind any single tile sits the Sound Studio — a deep, non-destructive audio editor you open from the tile itself. It gives you level and dynamics control (gain, headroom, normalize, limiter, compressor), a full parametric EQ, phase alignment, fades and trims on a waveform, named sections, live meters and scopes, a real-time spectrum analyzer, recallable presets, and a layout you can rearrange to suit how you work. Nothing you do there changes the original file — edits are baked into playback and into anything you export, so the source is always safe. The Studio follows Kolate's Light or Dark theme.
How Part 7 is organised:
- 7A — The WAV page (this part): the five toolbar zones, the tile mixer, playing sounds together, master level, dual-ear listening, save/load, export and the generated sound page.
- 7B — The Studio core: opening the Studio, presets, the static/dynamic performance mode, the meters, goniometer, phase scope and spectrum analyzer, and the waveform & timeline.
- 7C — Studio DSP: the limiter, parametric EQ, compressor, phase alignment and routing, and how live audition (rendered in the background) lets you hear each change.
- 7D — Studio working tools: adjustment points and notes, named sections (with precision editing, looping, cut/insert and zoom), the safety Advisor, the customizable Studio layout, first-launch machine calibration, and the Studio's keys and undo.
You do not need the Studio for everyday use — the WAV page alone lets you collect, label, mix and share sounds. Reach for the Studio when you want to shape a single sound precisely.
7A.1 The WAV Page at a Glance — the Five Zones
Audio lands in a tile grid, a fixed number of tiles per page (Setup Limits, Part 11). Along the top sits the page toolbar, grouped into five labelled zones. Each zone is a framed box with a coloured heading, and the row wraps onto a second line on narrow windows, so nothing falls off the page.
| Zone | What is in it |
|---|---|
| ▶ PLAY | ▶ Play selected, ⏯ Pause / Resume, ■ Stop, and dual-ear listening: L | R ears, ⇄ Swap ears and Mono mix (Σ) (§7A.3, §7A.5). |
| 🎚 MIX | Master volume, Headroom, Output and the Auto rig (§7A.4). |
| 🏷 ORGANISE (classification) | The colour swatches and ∅; New, the classification box, the count box and Delete; ⇅ Order, ☑ Tick class and Group (Part 5). |
| 📦 BUILD & EXPORT | Current page / All pages / All sessions, Generate page, Remove class, the generated-zip list with 📋 Copy zip, Export., Save Grid and Load Grid (§7A.4, §7A.6, §7A.7). |
| 🛠 TOOLS | Channel test and Tap (record test) (§7A.4, §7A.5), and the ? button. |
The “?” zone legend
Press ? at the right-hand end of the toolbar (in the 🛠 TOOLS zone) for a pop-up titled “The WAV / MP3 page, zone by zone”, with a one-line summary of each zone. Click anywhere else to close it.
Tile labels are part of the search index (Part 5) — name your sounds and you will always find them again.
Back to contents7A.2 A Single Sound Tile
Each tile is one sound, with its own controls:
| Control | What it does |
|---|---|
| Label | The tile's friendly name (searchable). Right-click to rename. |
| Play / Pause / Stop | Play this sound; Pause and press again to resume; Stop. |
| Vol | This sound's volume (linear 0–1; the default is 0.80). |
| Pan | Left–right balance (−1.00 left … +1.00 right). |
| Mute | Silences this sound without changing its volume. |
| Solo | Marks this sound so “Play only the soloed sounds” plays just the soloed set. |
| Offset (ms) | Delays this sound's start by the given milliseconds — used to line sounds up in time. |
| Duplicate | Copies this sound into the next free slot. |
| Clear | Empties this tile. |
| Classification box | The named group this sound belongs to (Part 5). |
| Tick box | Includes this sound in ▶ Play selected and Export. |
| ⚙ (Studio) | The small gear button at the tile's top right opens this tile's Sound Studio — Gain, Headroom, Normalize, Limiter, Fades, EQ and more (§7A.8, Parts 7B–7D). |
7A.3 Playing Several Sounds Together
The WAV page is a mixer, so sounds play in sync. The controls are in the ▶ PLAY zone:
- Tick the sounds you want (or solo some of them).
- Press ▶ Play selected — the ticked sounds play together as one mix (the page mix).
- While it plays, each tile's Mute and Solo take effect live: mute drops one sound, solo drops everything except the soloed set.
- Press ⏯ Pause / Resume to pause the whole mix; press it again to carry on from the same place.
- Press ■ Stop to stop every playing sound.
Each sound's Volume, Pan and Offset shape its place in the mix, so you can balance several sounds, pan them across the stereo field, and nudge their timing until they line up.
Back to contents7A.4 Master Volume, Headroom, Output and Export
| Control | What it does |
|---|---|
| Master volume (🎚 MIX) | The overall output level for the whole page mix. |
| Headroom (🎚 MIX) | The safety margin before the limiter (0.05–1.00). It holds the mix below full scale so combined sounds do not clip — lower it if a dense mix distorts. |
| Output (🎚 MIX) | The audio backend: WaveOut (the safe default) or WASAPI (can give lower latency). |
| Export. (📦 BUILD & EXPORT) | Mixes the ticked sounds into one WAV file you choose (the default name is Kolate_Mixdown.wav). The page stays usable while it renders; the button reads ⏳ Exporting… until it is done, then a “Mix-down saved” notice names the file. |
| Tap (record test) (🛠 TOOLS) | A diagnostic: when ticked, writes the first 20 seconds of playback to a file in Kolate's data folder, for troubleshooting. |
Auto rig — automated level sweeps
Tick Auto rig in the 🎚 MIX zone to show a second line of controls for level sweeps. It can step Master volume (Volume +) and Headroom (Headroom +) by a set step at a set interval while a sound plays, with Arm, ▶ Auto (it reads ■ Stop while running) and ⟲ Reverse. Each step is logged with a timestamp, which is useful when recording a controlled level ramp. Leave Auto rig off for ordinary listening.
Back to contents7A.5 Dual-Ear Listening (L | R ears)
Kolate can send one sound to your left ear and another to your right, for direct A/B and stereo-placement work. These controls are in the ▶ PLAY zone:
| Control | What it does |
|---|---|
| L | R ears | Tick exactly two tiles, then press. The lower tile number plays into the Left ear, the other into the Right, together. Mute/Solo are overridden for this play. |
| ⇄ Swap ears | Exchanges which sound feeds which ear — live, without restarting the play. It is greyed out until a pair is playing. |
| Mono mix (Σ) | On by default. Each file's left and right are summed to mono before it is panned, so the whole of each sound reaches its ear. Turn it off for a plain balance pan: a stereo file sent hard left then plays only its own left channel. It changes a running dual-ear play live, and the setting persists. |
In the 🛠 TOOLS zone, Channel test is a diagnostic that measures, in the background, how many sounds this computer can mix at once in real time. The result goes to the status bar and the log. It is a report only — it never limits playback.
L ← name [meter] ♪ [meter] name → R — with live level meters for each ear, so you can see the
sound as well as hear it. It appears while playing or paused and hides when you stop.7A.6 Save Grid / Load Grid
Your mix is part of the page. In the 📦 BUILD & EXPORT zone, Save Grid writes the current tile
grid (order, names, colours) to the page's sheet. Load Grid opens a saved audio sheet (*.json)
and restores it. Because the state persists, closing and reopening Kolate brings your mix back as you left it — and a
change you make just before leaving the WAV page is saved straight away.
7A.7 Copying Sounds Out & the Generated Sound Page
Copy checked tiles as files
The header 📋 button (on the pane's title bar) copies the checked tiles to the clipboard as real sound files carrying their friendly on-screen labels — never internal storage names. Tick the tiles you want, press 📋, and paste them anywhere outside Kolate with names that make sense.
Generate a stand-alone sound page
Generate page (📦 BUILD & EXPORT) builds a self-contained offline page for the selected classification that plays anywhere with no database attachment — the sound files are copied beside the page, and the result is zipped under its classification's name in Kolate's Generated_WAV folder. Choose the scope first: Current page, All pages of the current session (the default), or All sessions (registered Kolate only).
Remove class clears the selected classification from the tiles in the chosen scope; the classification name itself is kept.
Send a generated page — 📋 Copy zip
Pick a generated page in the zip list beside it, then press 📋 Copy zip. The zip is copied to the clipboard as a file — paste it as an e-mail attachment; the receiver unzips it and the page works on its own. Do not confuse this button with the header 📋, which copies the checked tiles themselves.
On the generated page
Each row plays in the page's single player (starting another row stops the previous), shows the sound's own Duration and accumulated listening Time, and carries Order / Delete / Undo. Auto-Play follows the Order sequence and advances the moment each sound ends — the interval is each sound's own length. (The player toolbar is documented in full in Part 5 §5.4.)
7A.8 Opening the Sound Studio
Every tile has a small gear (⚙) button at its top right: the Studio button. Press it to open that sound in the Sound Studio, where you can shape it precisely — gain and headroom, normalize, limiter, compressor, parametric EQ, phase alignment, fades and trims, named sections, meters and scopes, and recallable presets. The window opens straight away, even for a long recording. The edit is non-destructive: the original file is never changed, and your settings travel with the tile.
To compare the Studio settings of every tile on a page side by side, use Sound Studio View from the WAV Inspector (Part 9 §9.6).
Part 7 — Sound (WAV/MP3) & the Sound Studio · 7B — The Studio Core
This part covers the Sound Studio's foundations: how you open and audition it, the preset library, the Dynamic/Static performance mode that keeps it responsive on long files, and every live visual display — the meters, goniometer, phase scope, spectrum analyzer and the waveform with its transport. The DSP controls themselves (limiter, EQ, compressor, phase alignment) are Part 7C, and the working tools (adjustment points, sections, Advisor, layout, keys and undo) are Part 7D.
7B.1 Opening the Studio and the Window
Open the Studio from any sound tile's gear (⚙) button (Part 7A §7A.8). The window titled Sound Studio is a vertical stack of blocks — visual displays and control groups. Along the top, beside the tile's name and a status line, are ⚙ Layout and ? Help. The play and commit buttons sit in a row at the bottom right:
| Control | What it does |
|---|---|
| ▶ Audition / ⏹ Stop | ▶ Audition plays the sound with your current edited settings — Gain, EQ, Limiter drive, Normalize, Fades and Trim are re-rendered on every press, so you hear everything before you commit. ⏹ Stop stops it (the same as ■ in the transport row). (The tile's own Play button plays the saved settings — the Studio always previews what you are editing.) While a render is being prepared, the button reads ⏳ Rendering… (Part 7C §7C.9). |
| Reset defaults | Returns every control to its default value, after asking first. The button then reads ↶ Undo reset; press it to bring your previous settings back. Sections and adjustment points are not affected, and nothing is saved until you press Save. |
| Cancel | Closes without keeping this session's edits (also Esc, or the window's ✕). The tile goes back to its saved sound. Adjustment points are always kept. Anything you already Applied stays applied. |
| Apply | Commits the current settings to the tile and keeps the Studio open. The tile updates at once. Pressing Cancel after Apply keeps what you applied. |
| Save | Commits the settings to the tile and closes the Studio (also Ctrl+S). |
| ? Help | Opens the Sound Studio help sheet. It sits beside the Studio while you work. |
| ⚙ Layout | Opens the layout editor to rearrange the blocks (Part 7D §7D.7). |
The Studio also answers to Space (play / pause) and Ctrl+Z (undo the last section or mark change). All four keys, and what ↶ Undo covers, are in Part 7D §7D.9.
Opening a long recording
The window opens straight away. On a long recording the waveform panel may show Drawing the waveform… for a moment while the picture is prepared in the background — you can start working at once.
Light and Dark, and the window size
The Studio and its helper windows (Advisor, Sections, the section zoom, Adjustment notes, Studio Layout, Sound Studio View and the name prompt) follow Kolate's Light or Dark theme, taking the current theme when they open. The picture panels — waveform, meters, scopes and curves — stay dark in both themes so the traces are easy to read.
The Studio widens itself to show every adjustment-point button (Part 7D §7D.1), but never beyond the screen it is on. The size you set by hand is remembered.
Closing the Studio — by Cancel, Save, Esc or the ✕ — also closes its companion windows: Notes, Sections, Help, the Advisor and the section zoom (Stretch) window.
7B.2 Presets — a Global Library
A preset is a complete, named set of Studio settings. The presets row gives you a dropdown of saved presets plus Save preset, Save as… and Delete preset:
- Pick a preset from the dropdown to recall its whole settings at once.
- Save preset overwrites the preset currently selected, or creates it if the name you typed is new.
- Save as… saves the current settings as a new named preset. It asks for a name in a small box titled Save preset as: OK stays greyed out until you type a name; Enter = OK, Esc = Cancel.
- Delete preset removes the selected preset from the library, after asking “Delete preset “<name>”?”.
The library is global — presets you save are available in the Studio for every sound, so a good starting point (say a gentle limiter or a vocal EQ) is one click away on any tile. A preset holds the sound settings only; it never stores adjustment points, sections or the number of point buttons.
Back to contents7B.3 Dynamic vs Static — the Performance Mode
Most Studio controls (gain, EQ, limiter, fades and so on) are rendered into the audio, so hearing a change means re-rendering the sound. Renders run in the background, so the window never freezes, but on a very long sample a render can take a moment. The Dyn / Stat toggle in the presets row lets you choose how that behaves:
| Mode | Behaviour |
|---|---|
| Dynamic | Every change re-renders and is heard live — best for short samples and strong machines. |
| Static | Changes do not re-render or auto-play while you work. Make several adjustments freely, then press ▶ or an adjustment point to hear them. This is the mode for long samples and low-spec machines. |
Hover over the toggle and its tooltip tells you which mode you are in and what clicking will switch to.
Which mode the Studio starts in
- The first-launch machine calibration picks the default: High-spec starts Dynamic, otherwise Static (Part 7D §7D.8).
- While no mode has been remembered yet, a recording longer than five minutes opens in Static on any machine, whatever the calibration says — so a slider move never sets off a long render.
- The mode you use is remembered for next time.
7B.4 The Visual Displays — Overview
The Studio shows you what you are hearing. Every visual panel has a small ▾ / ▸ button in its header that collapses it to a thin bar or expands it again, and each panel remembers its state between visits — so you can hide the displays you are not using and keep the window compact. The live displays are:
- Output meters, correlation and goniometer (§7B.5);
- Phase scope (§7B.6);
- Spectrum analyzer — on the EQ panel (§7B.7);
- Limiter, EQ and compressor curves — with their controls in Part 7C;
- Waveform & timeline (§7B.8).
All of them come alive while you Audition, freeze when you pause, and clear when you stop. They keep painting while a render is being prepared in the background. In both Light and Dark themes these picture panels stay dark.
Back to contents7B.5 Output Meters, Correlation and Goniometer
The top strip shows the health of the output while you audition:
- L / R meters — peak and RMS level bars for each channel, on a
0 / −12 / −24 / −48dB scale, so you can see how hot the signal is and how much dynamic range it has. - Correlation (Corr.) — a number from +1.00 (left and right the same: mono-compatible) through 0 (unrelated, wide stereo) to −1.00 (they cancel each other — a phase problem).
- Goniometer — each dot is one output sample plotted as its (L, R) value rotated 45°. Read the shape: a vertical smear = mono / in-phase; a round cloud = wide stereo; a horizontal smear = out-of-phase (mono-cancelling).
7B.6 The Phase Scope
The Phase Scope draws a reference cycle together with the signal, so you can see the phase relationship between the channels directly. It is the companion display for the Phase Alignment controls (Part 7C): as you invert polarity or nudge the phase delay, the scope shows the result live during audition.
Back to contents7B.7 The Spectrum Analyzer
Laid over the EQ curve is a live, real-time spectrum analyzer — a translucent teal shape showing the output level across the audible range, from 20 Hz to 20 kHz. It reads the signal after the whole processing chain, so EQ and compressor moves show up in it immediately: boost a band and its region rises; a pure 1 kHz test tone spikes exactly on the “1k” gridline. It shares the EQ's log-frequency axis, so you can line a boost or cut up against what you are hearing. (The EQ controls it sits on are documented in Part 7C.)
Back to contents7B.8 The Waveform and Transport
The Waveform & Timeline panel draws the sound so you can edit it by eye:
- A stereo file shows two lanes — left over right; a mono file shows one.
- Trimmed regions at the start/end are shaded red; fade curves are drawn in;
- Draggable handles set the trim start, trim end, fade-in end and fade-out start directly on the wave;
- a cyan playhead tracks playback, and clicking the wave seeks to that point.
On a long recording the panel may read Drawing the waveform… for a moment after the window opens. Clicking the wave, marks and loops land at the right place even with the ⟲ Section scope on.
The transport bar
| Button | What it does |
|---|---|
| ⏮ / ⏭ | Jump to the start / just before the end of the playable material. |
| ◀◀ / ▶▶ | Step back / forward one second. |
| ▶ Play / Pause | Also Space. The first press renders the current edited settings (the same as Audition); further presses pause and resume. |
| ■ Stop | Stops; the position returns to the start and the render stays loaded. It also cancels a render that is still being prepared. |
The Position readout shows current / total −remaining as
mm:ss.mmm — the current material time, the full file length, and the time left in the playable region.
Part 7 — Sound (WAV/MP3) & the Sound Studio · 7C — Studio DSP
These are the controls that shape the sound: level and placement, dynamics (limiter, normalize), time shaping (fades and trims), a full parametric EQ, a compressor, phase alignment and routing — each paired with a live curve you can drag. The window, meters and waveform they sit among are Part 7B; the working tools around them are Part 7D.
7C.1 The Processing Chain and the Controls
The Studio processes the sound in a fixed order, so the controls make sense as a chain:
Every analog control is a hybrid: a label, a slider, a number box and ▲/▼ step arrows. The number box is the source of truth — type an exact value, nudge it with the arrows, or drag the slider; the three stay in sync. Where a control has a curve, the slider track and the curve dot share a colour, so you can always tell which slider drives which point.
Hover over any control, ▲/▼ arrow or slider for a short explanation. Hold a ▲/▼ arrow down to keep stepping; or click a slider and use the arrow keys for small steps.
7C.2 Level & Placement
| Control | What it does |
|---|---|
| Volume | The tile's playback level (linear). Applied live. |
| Gain (dB) | A precise level adjustment in decibels, baked into the render (clamped to a safe ±24 dB). |
| Pan | Left–right placement (−1 … +1). Applied live. |
| Headroom | Holds the baked output below full scale so the chain does not clip. |
7C.3 Dynamics — Normalize and the Limiter
| Control | What it does |
|---|---|
| Normalize + Target peak | When enabled, scales the sound so its loudest point reaches the target peak (0.10–1.00). Runs early in the chain. |
| Limiter + Limiter drive | A soft (tanh) limiter that tames peaks. A drive of 1.0 is effectively bypass; higher drives limit harder. |
The limiter curve
The Limiter Curve panel draws the limiter's transfer shape — input level across, output level up — with a straight unity diagonal for reference. As you raise the drive the curve bends over, showing how hard peaks are being rounded off. When the limiter is unticked the curve greys out and reads “limiter off”.
Back to contents7C.4 Time Shaping — Fades and Trims
The Time Shaping (ms) group gives you exact numbers for the shape you can also drag on the waveform (Part 7B §7B.8):
| Control | What it does |
|---|---|
| Offset | Delays the sound's start, in milliseconds (live). |
| Fade in / Fade out | The length of the fade at the start / end. |
| Trim start / Trim end | How much to cut from the start / end. These are clamped to the file length so a fade or trim can never be longer than the audio. |
7C.5 Parametric EQ
Tick EQ enabled to switch on the whole EQ stage. It is a five-filter parametric EQ, each filter colour-matched to its dot on the response curve. Q is how wide a filter is: a low Q is broad and gentle, a high Q narrow and sharp.
| Filter | Controls |
|---|---|
| Low shelf | Low gain, Low freq, Low Q. |
| Mid peak (bell) | Mid gain, Mid freq, Mid Q (Q sets the bell's width). |
| High shelf | High gain, High freq, High Q. |
| High-pass (HP) | Tick High-pass, then set HP freq and HP Q — removes lows below the corner. |
| Low-pass (LP) | Tick Low-pass, then set LP freq and LP Q — removes highs above the corner. |
The EQ response curve
The curve shows the combined response of all five filters on a log-frequency axis from 20 Hz to 20 kHz, ±12 dB. The three band dots drag in both axes — sideways changes frequency, up/down changes gain — and the HP/LP square handles drag sideways to set their corner. The live spectrum analyzer (Part 7B §7B.7) sits under the same curve, so you can line a boost or cut up against the actual sound.
7C.6 Compressor
Tick Comp enabled to switch on the compressor, which sits between the EQ and the limiter. Its five controls are colour-matched to the curves:
| Control | What it does |
|---|---|
| Threshold | The level (dBFS) where compression begins — the red dot on the curve. |
| Ratio | How strongly level above the threshold is reduced (4 = every 4 dB over comes out as 1 dB over); the teal slope is 1/Ratio. |
| Attack | How quickly it clamps down once the signal crosses the threshold. |
| Release | How quickly it lets go afterwards. |
| Make-up | Make-up gain (dB): turns the whole sound back up after the compressor has turned the loud parts down — it lifts the green curve. |
The compressor curves
Two displays make the settings visible: a transfer curve (input vs output, with the draggable red threshold dot, the teal post-threshold slope, and the green make-up lift) and an envelope strip that shows the amber attack and violet release in true time proportion, so you can see how fast the compressor reacts.
7C.7 Phase Alignment
| Control | What it does |
|---|---|
| Invert polarity (Ø 180°) | Flips the signal's polarity — useful when two related sounds partly cancel. |
| Phase delay (smp) | A tiny delay, in samples at 48 kHz, to line this tile up in time with another recording of the same sound. |
Watch the Phase Scope (Part 7B §7B.6) and the goniometer while you adjust these — a mono-cancelling pair tightens up as you invert or nudge the delay.
Back to contents7C.8 Routing
The Routing group carries the tile's Mute and Solo inside the Studio, mirroring the same controls on the WAV page (Part 7A). They apply live, so you can drop this sound in and out while you audition it against the others.
Back to contents7C.9 Live Audition — Hearing Your Changes
Because most of the chain is baked (§7C.1), the Studio re-renders the sound so you can hear a change. In Dynamic mode, when an audition is playing, moving a baked control triggers a brief automatic re-audition shortly after you stop moving it, and playback carries on from the same spot, so you hear the difference in place without pressing anything. The live controls — Volume, Pan, Mute, Solo, Offset — take effect instantly and never trigger a re-render.
Rendering in the background
Every render — ▶ Audition, the transport ▶, a point click, a section seek, loop or pre-roll, and the automatic re-audition — runs in the background, so the Studio never freezes:
- While a render is being prepared, ▶ Audition reads ⏳ Rendering… and the mouse pointer shows the busy arrow. The controls still move and the meters still paint.
- Pressing ▶ again does not start a second render — the one on its way plays when it is ready. A seek, pre-roll or loop you ask for meanwhile waits and runs once it is ready.
- A newer render replaces an older one that has not finished.
- ⏹ Stop (or ■) cancels a render still being prepared, and so does closing the Studio.
- Repeat renders of the same sound are faster, because only the effects are worked out again.
Part 7 — Sound (WAV/MP3) & the Sound Studio · 7D — Studio Working Tools
The final Studio part covers the tools that help you work: mark the exact spots you want to fix, jot notes against each one, carve the sound into named sections you can loop and export, get advice on what is safe to adjust next, arrange the Studio to suit you, understand the one-time calibration that tunes it to your machine, and use the Studio's keys and undo.
7D.1 Adjustment Points — Marking Spots to Fix
While a sound plays you often hear a spot that needs work. Adjustment points let you mark that spot and come straight back to it. Two transport buttons create them:
- ● Mark — drops a point at the current spot and the music carries on.
- ⏸ + Mark — stops the music at this spot and creates a point there, so you can make the adjustment without hindrance.
Each point becomes a numbered mini-button on the presets row. Clicking a point button follows a simple three-step contract:
- First click — play from that point.
- Second click — snap the timeline to the point and pause there.
- Third click — continue (in Static mode, any pending changes render first, then play resumes from the point).
As playback nears the next point, the position readout warns you in colour: Yellow ≤ 3 s Violet ≤ 2 s White ≤ 1 s then back to normal.
7D.2 Adjustment Notes
The ✎ button opens a persistent notes window where you record what needs doing at each point — “too boomy here”, “de-ess”, “trim the tail”. The notes are kept with the sound and stay until you clear them, so you can close Kolate and pick the work up later exactly where you left it. The window sits beside the Studio and remembers its size and position between visits.
Back to contents7D.3 Named Sections
A section is a named region of the sound you can revisit, loop and export. Create them on the waveform (Shift-drag a region, or + Section for a default one; − Last removes the most recent). ↶ Undo (or Ctrl+Z) reverses the last + Section, − Last or ● Marks → Sections, up to 30 steps (§7D.9). Press ✎ Sections… to open the Sections window and work with them as a list — rename, jump to, loop, reorder, duplicate, split and export. It sits beside the Studio while the material plays. Each row carries:
| Per-row control | What it does |
|---|---|
| Name + time range | An editable name and the section's start/end. |
| In / Out | Set the section's start / end to the current playhead. |
| ▶ (three-click) | Play from · snap and pause · continue — the same contract as an adjustment point. |
| ⟳ Loop | Loops the section (amber while looping). |
| ↑ / ↓ | Reorder the section in the list. |
| ✕ | Delete the section. |
The bottom bar adds +Add, Dup, Split ▶ (split at the playhead), Save This and Save All. Save Sections on the Studio's section bar exports each region as its own new sound tile, so a long recording becomes a set of tidy clips — the original is never changed.
How the new tiles are named
- Save Sections (Studio) names each new tile after its section — or, if the section has no name, after the source and the time — without asking. It then reports how many sections were saved. If some could not be saved, the page may be full: move to an empty page and try again.
- Save This and Save All (Sections window) ask you to confirm a name for each tile first, in a box titled Name this tile before saving, filled in with the section's name. Type the name and press Enter, or Esc to skip that tile (“save cancelled.”). OK stays greyed out while the box is empty.
- Section names may contain any characters; ones Windows does not allow in file names are replaced with
_in the saved file name.
Saved format
The Preserve source format checkbox on the section bar decides the format of saved sections (and of Cut and Insert, §7D.5). Off (the default): 16-bit PCM at 48 kHz, Kolate's standard mix format. On: the source file's own sample rate and bit depth.
Saving a section renders it in the background; the status line counts up “rendering… n%” and the window ignores clicks until the render finishes.
7D.4 Precision Section Editing
On a long file, a single pixel of drag can be hundreds of milliseconds, so sections can be set to the millisecond:
- Type exact In/Out as
h:mm:ss.mmm, or nudge with ◀ ▶ by ±1 ms (Ctrl ±10, Shift ±100) or the mouse wheel. - ⛓ prev (weld) sets a section's start to the previous section's end, so the two share one boundary — no gap, no overlap — and edges magnetically snap to nearby marks as you drag.
- ⏸ Stop-arm makes playback pause dead on the mark, for checking a boundary by ear.
- ⇥In / ⇥Out audition the edges with a short pre-roll, stopping exactly on the edge.
- Start bit / End bit move every section's start / end slightly inward when it is saved, to allow for your reaction time (0 = off). They are on the Studio's section bar as well as in the Sections window.
- A zoom view lets you inspect and set a boundary at higher resolution when the ear and nudge alone are not enough.
7D.5 Cut and Insert
Sections can be turned into edits, all producing a new tile and never touching the source:
| Action | What it does |
|---|---|
| ✂ Cut | Removes the section and joins the ends with an equal-power crossfade. |
| +→ Start | Inserts the section at the start of the track. |
| +→ End | Inserts the section at the end of the track. |
| ● Marks → Sections | Turns the points you made with ● Mark into sections (each point is a start, its end is the next point, the last runs to the end of the media). The marks are used up; ↶ Undo brings them back. |
7D.6 The Advisor
The Advisor (its button sits on the timeline bar) is a guide to what is safe to adjust next. It colours each of 16 parameters:
- Green safe to adjust now, Yellow adjust with care, Red best left for now;
- each with its last-safe value and a suggested value.
It is advisory only — it never blocks a control, it just colours the guidance. The window is titled Adjustment order & safety and has two tabs. On the Edit order & limits tab you can reorder the workflow (▲ ▼) and retune each parameter's safe range and suggested value; Reset to defaults puts back the standard-practice values. The window sits beside the Studio and remembers its position.
Back to contents7D.7 The Studio Layout Editor
Everyone works differently, so the Studio's blocks are rearrangeable. The ⚙ Layout button opens the layout editor, where each visual panel and control group is a block you can move and resize:
- Change a block's width in sixths of the row, and move it up or down.
- Pair / Unpair to stack two blocks in one column, or split them again.
- Start from a preset — Compact visuals, Visuals first or Two-column workbench — or the classic Default, and use Undo / Redo while you experiment.
The arrangement you accept becomes the actual Studio view. It is global for this machine (so your muscle memory holds across sounds) and persists between runs, and the default arrangement is always available as a fallback.
7D.8 First-Launch Machine Calibration
The first time Kolate runs, it measures your computer with a short benchmark that mimics the Studio's real workload (re-rendering audio), and rates the machine Low, Medium or High. That rating picks the Studio's initial performance mode:
| Rating | Initial Studio mode |
|---|---|
| High | Dynamic — changes re-render immediately. |
| Low / Medium | Static — you render on demand, so control nudges stay responsive. |
Kolate never keeps you waiting: it carries on as normal, shows one message that calibration is in progress and a second reporting the result (Part 1 §1.2). Your own choice of mode inside the Studio (Part 7B §7B.3) overrides the default afterwards, and the result is remembered. While no mode has been remembered yet, a recording longer than five minutes starts in Static whatever the rating.
Back to contents7D.9 Studio Keys and Undo
Keys
| Key | What it does |
|---|---|
| Space | Play / pause — the same as the transport ▶. Not while you are typing in a box or a dropdown is open. |
| Esc | Cancel: closes the Studio without saving. If a dropdown is open, Esc just closes the list. Esc also works while you are typing in a box, so it closes the Studio from there too. |
| Ctrl+S | Save and close — works even while you are typing. |
| Ctrl+Z | Undo the last section or mark change (below). While you are typing in a box, it undoes the typing instead. |
The small name prompts (Save as… for presets, and naming a section tile) use Enter = OK and Esc = Cancel.
↶ Undo
The ↶ Undo button sits on the section bar between − Last and Save Sections. It is greyed out until there is something to undo, and its tooltip names the step it will undo — for example “Undo “− Last” (Ctrl+Z)”.
- It undoes exactly three actions: + Section, − Last and ● Marks → Sections.
- Each undo puts back both the sections and the adjustment points as they were, so after ● Marks → Sections it brings your marks back.
- Up to 30 steps are kept. The status line shows “undone: …”, or “nothing to undo.”
- It does not undo dragging section edges on the wave, edits in the Sections window, or changes to the sound controls.
Reset defaults and Undo reset
Reset defaults has its own undo. It asks first (“Put every setting in this Studio back to its default?”; No is the default answer). After Yes the button reads ↶ Undo reset — press it to bring your settings back. Reset never touches sections or adjustment points, and nothing is saved until you press Save.
Closing = Cancel
Closing the Studio with the window's ✕ (or Esc) behaves exactly like Cancel: Volume, Pan, Mute, Solo and Offset go back to the tile's saved values, so what you hear matches the tile again. Adjustment points are kept, any render in progress is cancelled, and the Studio's companion windows close with it.
Part 8 — MIDI
MIDI (.mid) is a first-class format in Kolate: a tile grid of sequences you can label,
classify, edit instrument-by-instrument, play through your own player, and — the powerful part — render to WAV so all
the sound tools in Part 7 become available. This part covers the grid and tiles, the instruments editor, playing,
the whole render-to-WAV workflow (including a stereo render and the re-render cache), and the generated MIDI page.
Classification and skins work as in Part 5; the Inspector is Part 9.
8.1 The MIDI Grid
Drop or copy a .mid file and Save CB stores it; or press Add MIDI… (📁 ITEMS zone) to add one or
more files (you can also drag-drop files anywhere onto the grid). Tiles hold a Play button, an editable label (searchable — Part 5), a green
classification box and per-file instrument editing.
The toolbar zones
The MIDI toolbar is grouped into labelled zones that wrap onto a second line on narrow windows. Press ? for a pop-up titled “The MIDI page, zone by zone” with a one-line summary of each; click anywhere else to close it.
| Zone | What is in it |
|---|---|
| 📁 ITEMS | Add MIDI… adds one or more .mid files to this session; 🗑 Delete selected removes every ticked MIDI — file and database row — after asking. |
| ▶ PLAY | ▶ Play selected and the Player: chooser (§8.4). |
| 🎧 RENDER | Render 2 → L|R and ⇄ Swap L/R (§8.6). |
| 🏷 ORGANISE (classification) | Colour swatches and ∅, New, the classification box, the count box, Delete, ⇅ Order, ☑ Tick class and Group — as on the WAV page (Part 5). On MIDI, ☑ Tick class ticks every MIDI carrying the selected classification on all pages. |
| 📦 BUILD & EXPORT | Current page / All pages / All sessions, Generate page (§8.8), Remove class, and the generated-zip list with 📋 Copy zip. |
| 🛠 TOOLS | The ? button. |
Above the zones, in the header row, sit the Rendered → chooser and Stay on MIDI (§8.5) and
◀ Prev / Page n/N / Next ▶. The header 📋 still copies the checked tiles as real
.mid files named by their friendly labels (ticks are remembered across pages, so you can gather from
several pages and copy together).
Generate page builds for this page, every page of the session, or all sessions (registered Kolate), zipped under the classification's name in the Generated_MIDI folder. Pick a zip in the list and press 📋 Copy zip to copy it to the clipboard as a file, ready to attach to an e-mail.
8.2 A MIDI Tile
Each tile's buttons are grouped by job:
| Button | What it does |
|---|---|
| Play | Hands this file to your chosen external Player (§8.4). |
| File | File actions for this MIDI. |
| 🎹 (instrument icon) | Opens the MIDI Instruments editor for this file (§8.3). |
| Info | Shows details about the sequence. |
| Render (💾) | Renders this MIDI to WAV, to the destination you set once in “Rendered →” (§8.5). |
| ↻ Re-render | Clears this file's cached render so the next Generate re-renders just this one (§8.7). |
| Delete | Removes the tile (file and row), after asking. |
The tile's label is editable (right-click / Edit-name) and searchable; its classification box and colour skin work as on the other tiled formats (Part 5).
Back to contents8.3 Editing Instruments per File
The 🎹 instrument icon on the tile opens the MIDI Instruments dialog, which lists the file's melodic channels with their instrument names (🎵). For each you can:
- On — include or exclude that channel;
- Isolate — solo a group: when any channel is isolated, only the isolated channels sound.
You can also pick a different General MIDI instrument (Program 1–128) for each channel. A second list, Channel 10 — Percussion (note → drum sound), lets you switch each drum sound On or off, or remap it to a different sound; choosing a different sound remaps every occurrence of it (the tooltip shows how many times it is used).
Press Apply to file to write the instrument changes (programs and drum remaps) into the .mid file itself, or Close. The On and Isolate switches are only remembered by Kolate and do not change the file; if only they changed, the status reads “Toggles saved. No instrument changes to write.” Turning instruments off (or isolating some) changes both what you hear on Play and what gets baked when you render to WAV — so you can, for example, render just the drums, or a version without the lead line. If the file has no melodic channels, the dialog says so.
This dialog keeps a light background in both the Light and Dark themes.
8.4 Playing MIDI
MIDI plays through an external application, chosen in the Player: box in the ▶ PLAY zone: System
default, Windows Media Player or Open with… (choose). Windows Media Player plays MIDI out of the
box; VLC needs a SoundFont (.sf2) for MIDI. A tile's Play hands that one file to the player.
8.5 Rendering MIDI to WAV
Rendering turns a MIDI sequence into an audio file using Kolate's built-in synth, so every WAV tool — the mixer, dual-ear, the whole Sound Studio — becomes available. You set the destination once, then render as many files as you like.
Set the destination (once)
The Rendered → chooser in the grid header decides where every render goes, and remembers your choice:
| Rendered → | Where the WAV goes |
|---|---|
| Save to a location… | Writes the WAV to a folder you pick. |
| Send to Kolate WAV pages | Adds the WAV straight into your WAV grid as a new tile, labelled “<name> (render)”. |
Render
- Press a tile's Render (💾). Kolate synthesises the audio (honouring your instrument toggles from §8.3).
- The WAV is delivered to the destination above. The original MIDI tile is never changed — rendering is a one-way trip.
8.6 Stereo Render (Render 2 → L|R)
To place two sequences hard left and right in one file, tick exactly two MIDIs and press Render 2 → L|R in the 🎧 RENDER zone (it is available only when exactly two are ticked):
- The first ticked MIDI becomes the Left channel, the second the Right;
- the result is a single stereo WAV tile, labelled to show the pairing;
- ⇄ Swap L/R, beside it, exchanges which MIDI is Left and which is Right (the choice is remembered).
From there, open the stereo tile in the Sound Studio (Part 7) for dual-ear listening, phase work and the rest.
Back to contents8.7 The Re-render Cache (↻)
When you Generate page for MIDI, Kolate renders each sequence to WAV once and caches that render, so building the same page again is near-instant. If you change a file's instruments (§8.3) — or a cached render ever sounds wrong — press the tile's ↻ Re-render to clear just that file's cache. The next Generate then re-renders only that one file, not the whole page.
Back to contents8.8 The Generated MIDI Page
Generate page copies the .mid files, with their original names, beside a self-contained page
for the selected classification. On it, each row's Open
hands the file to your default player, with Order, Delete / Undo and re-arrange just like the other
generated pages (Part 5 §5.4).
.mid inline, so the
generated page says so plainly and works through your operating system's player instead. Back in Kolate, Recall
restores a MIDI to the clipboard as a real file-drop, ready to paste anywhere.Part 9 — The Inspectors
A grid shows you one page at a time. The Inspectors let you see and manage items across every page of a format at once — ideal for finding, selecting, renaming and reordering when your material has grown across many pages. There are two: one for the tiled formats (WAV, MIDI, URL) and a one-dimensional Page Inspector for the non-tiled formats (TXT, RTF, HTML, images, PDF, SVG). For WAV there is also Sound Studio View, which lays out the Studio settings of a whole page side by side.
9.1 Two Inspectors, One Job
Both Inspectors solve the same problem — working across pages — but suit different material. Both open from the one blue Inspector button on the command bar, which opens the Inspector for the maximized format:
| Inspector | For |
|---|---|
| Tiled-format Inspector | WAV / MIDI / URL — many tiles per page. Maximize the WAV, MIDI or URL pane and press the command bar's Inspector button (§9.2). |
| 1-D Page Inspector | TXT / RTF / HTML / images / PDF / SVG — one item per page. Maximize the format and press the command bar's Inspector button (§9.5). |
If nothing is maximized, the status line reads “1-D Inspector: maximize a format first (TXT, RTF, HTML, ...).” For a tiled format whose pane is not open, it asks you to open or maximize its pane first. The WAV, MIDI and URL pages no longer have Inspector buttons of their own.
9.2 The Tiled-Format Inspector (WAV / MIDI / URL)
Maximize the WAV, MIDI or URL pane and press the command bar's Inspector button. The window is titled Pages With Tiles Inspector, followed by the format.
Choosing pages
Along the top, Pages: has a tick box for every page. All and None tick or untick them all, and Show selected pages lists just the ticked pages below.
One row per page
Each listed page is one row:
| Part of the row | What it does |
|---|---|
| Title box + Apply | Edit the page's title and press its Apply. The title writes through to the page's sheet, its database row and the container's title dropdown in real time. |
| ▲ / ▼ | Reorder (move up / down). |
| Numbered tile cells | One cell per tile on that page. Click cells to pick tiles for the bottom-bar actions (below). |
| Row buttons | WAV and MIDI: U update the selected tile's name, P play the ticked sounds
(on MIDI one score at a time), A pause, S stop, C clear the ticks and stop. URL: U update the selected link's label, Open open the ticked links (or the clicked one) in the browser, Copy copy them to the clipboard (label, tab, address — one per line), Close close the browser windows opened from here, Clear clear the ticks. |
The bottom bar
The bar along the bottom carries SS View (WAV only, §9.6), List (§9.4), Swap, Replace, Delete, Insert with a Duplicate tick box, L|R (MIDI only), and Apply, Refresh and Close. The hint beside them explains how to pick tiles: click a tile to choose the source (orange), then a second tile as the destination (green). The second tile clicked is always the destination of the first.
9.3 Selecting Across Pages — Tick All / Untick All
The Inspector's biggest job is selection across pages. You can tick tiles on page 3, page 12 and page 20, then act on exactly that set with ▶ Play selected, Export., 📋 or (for WAV) the L | R ears pairing — without hunting page to page.
Tick All and Untick All are in the List window (§9.4) and apply across every page at once. On a large store this runs in the background with a progress toast (“Ticking… page k of P”), so the window never looks frozen, and finishes with a short summary.
Back to contents9.4 The List Window — Show All and Close All
Press List on the Inspector's bottom bar to open the List window. It shows every label of one page as an editable box: type a new label and press Enter (or the row's U) to rename the tile. The window remembers its size and position.
- Show All opens one consolidated window listing the tiles of every page together, scrollable — handy for a whole-session overview and for ticking across the lot.
- Close All closes the per-page label windows in one press.
9.5 The 1-D Page Inspector (Non-Tiled Formats)
The non-tiled formats store one item per page, so their Inspector is one-dimensional. Open it from the command bar's Inspector button while a non-tiled format is maximized. It shows two synchronised views:
| View | What it shows |
|---|---|
| Left — title list | A scrollable checkbox list of pages, each reading [☐] Page N — title. Its width is set by a Max Width chooser so long titles fit. |
| Right — page grid | A numeric grid with one cell per real page (unused positions are never drawn), laid out at your chosen Max Horizontal number of columns. |
The two views stay in step: tick a page on the left or click its cell on the right and the other follows. From here you get the same across-all-pages overview and selection that the tiled formats enjoy. Double-click a page to open its content in a separate window, where you can check it — and edit its title and press Apply — without leaving the Inspector. Several of these windows can be open at once.
9.6 Sound Studio View (SS View)
Sound Studio View lets you compare the Sound Studio settings (Part 7B–7D) of every tile on a page, side by side, in one editable table.
- Maximize the WAV pane and press the command bar's Inspector button.
- Press SS View on the Inspector's bottom bar. A window titled Sound Studio View opens.
- Each tile of the page is a row, and each Studio setting is a column: Vol, Gain, Pan, Head, Lim, Drive, Nrm, Target, Offset, FadeIn, FadeOut, TrimS, TrimE, EQ, Low, LowF, LowQ, Mid, MidF, MidQ, High, HighF, HighQ, HP, HPf, HPq, LP, LPf, LPq, Cmp, Thr, Ratio, Atk, Rel, MkUp, Mute and Solo. Hover over a column heading to see whether it is (live) or (baked).
- Type a value, or use the ▲/▼ arrows that appear in the box you are editing.
- Use ◀ PREV, the page dropdown and NEXT ▶ to switch pages.
Every valid edit is saved immediately, pushed to a playing tile in real time, and shows in that tile's own Sound Studio. Live columns (such as Vol, Pan, Offset, Mute and Solo) change what you hear straight away; baked ones are heard on the next play.
Part 10 — Power Tools
Beyond the everyday loop, Kolate ships a handful of power tools: a log manager for diagnostics, test checkpoints and media health, an A4 print, a heads-up multi-copy collector, and Ext Functions — a way to run your own programs on whatever clip is focused. The data tools (Data Plotter, Statistics and Data Collation) share the same menu and are described in Part 12. Most tools live under Tools ▸ Output; Manage Logs is on the bottom toggle row and the Ext Functions runner is at the bottom-right.
10.1 Where the Power Tools Live
The Tools ▸ Output menu holds, in this order, Data Plotter…, Data Collation…, Statistics…, Print Page (A4)… and Multi-Copy (HUD)…. The other two power tools sit at the bottom of the main window.
| Tool | Where |
|---|---|
| Manage Logs | The Manage Logs button on the bottom toggle row (§10.2). |
| Data Plotter | Tools ▸ Output ▸ Data Plotter… — see Part 12. |
| Data Collation | Tools ▸ Output ▸ Data Collation… — see Part 12. |
| Statistics | Tools ▸ Output ▸ Statistics… — see Part 12. |
| Print Page (A4) | Tools ▸ Output ▸ Print Page (A4)… (§10.4). |
| Multi-Copy HUD | Tools ▸ Output ▸ Multi-Copy (HUD)… (§10.5). |
| Ext Functions | The Ext Functions dropdown and RUN FUNCTION button at the bottom-right (§10.6). |
10.2 Manage Logs
The Manage Logs — Kolate window (“Save, search, organize, and review logging data”) is where you handle the diagnostic log (Part 1 §1.3): save and rotate it, check it contains the events you expect, keep test checkpoints of the database, and audit the media store. Along the bottom are Help (a one-page reminder of each section), Close, and Apply, which saves your preferences and refreshes the lists.
Logging Preferences
| Option | What it does |
|---|---|
| Enable logging on Kolate startup | A safety net: at each start Kolate asks “Logging auto-start is on. Progress with LOGGING ACTIVE for this session?” Yes logs this session; No leaves logging off and turns this option off; Cancel leaves logging off this time but keeps the option. Logging still starts off unless you say yes. |
| Log the startup transition (loading → ready) — no prompt | Logs from the very first moment of start-up, without asking, so the load-up sequence (which otherwise runs before you could switch logging on) is captured. When ticked it overrides the option above. |
Current Log Actions — save, checkpoint and rotate
A Description you type is folded into the saved file name. The tick box Zip (compress) the log before saving to the data store / copying as a file is on by default.
| Button | What it does |
|---|---|
| 1a Save as .zip, start fresh log | Saves the log as a timestamped .zip (always
zipped) with your description in the name, then deletes it and starts a fresh log — the classic rotate. |
| 1b Save as .zip, continue log | Saves a .zip checkpoint of the log so far
and carries on with the same log — nothing is deleted. |
| 2 Copy as file to clipboard, then delete | Puts the log on the clipboard as a file
(.zip or .log, per the Zip tick box), then deletes it and starts fresh. |
| 3 Copy log text to clipboard, then delete | Puts the log's text on the clipboard, then deletes it and starts fresh. |
| 4 Delete without saving | Asks “Delete the current log without saving anything?”, then deletes it and starts fresh. |
| Open current log file | Opens cima.log in your default viewer. Nothing is
deleted. |
Search / Grep Verification
A quick way to confirm the log contains the events a test routine expects.
- Type an expected substring and press Run Search. Kolate scans the current log once and fills the results table: Expected substring, Found (Yes / Missing) and Last match time (local time).
- Quick searches are ready-made buttons for the checks you run often. Edit… lets you change the list (it is saved); Restore Defaults brings back the built-in set.
- Find Missing runs every quick search plus the text you typed in one pass and tints the rows that were not found red — “Find Missing: N substring(s) NOT found — those rows are tinted red.”
- Open Full Log opens the whole log for reading.
Saved Logs / Timeline
A table of your saved logs — Date / Time, Description, Type, Session, Status, Size. Filter it by description and by a From / To date range, and order it Latest First or Oldest First. The buttons act on the selected log:
| Button | What it does |
|---|---|
| Copy | Puts the saved log on the clipboard as a file. |
| Restore | Makes the saved log the current log. The log you had is archived first (its name ends
_before_restore.zip), so nothing is lost. |
| Rename | Gives the saved log a new name. |
| Export… | Saves a copy wherever you choose. |
| Clear | Deletes the selected saved log. With nothing selected it offers to delete all saved logs, after asking. |
Backup & Recovery (for test repeatability)
| Button | What it does |
|---|---|
| Backup Database | Zips the whole data folder into CIMAdb_backup_<date-time>.zip,
beside the folder. |
| Restore Checkpoint | Unpacks a backup into a separate CIMAdb_RESTORED_<date-time>
folder (your live data is not touched) and shows the four steps to swap it in: close Kolate, rename the current
CIMAdb, rename the unpacked folder to CIMAdb, start Kolate. |
| Open Data Folder | Opens the data folder in Explorer. |
| Audit Media (expect zero) | Counts tiles whose media file lies outside the data store — so the store would not be complete if you carried it to another computer. It reports how many sheets it scanned, how many files are inside, how many outside files could be copied in, and how many are missing. A healthy, portable store shows zero outside. |
| Repair Media (one-off) | Copies those outside files into the store and points the tiles at the copies. Each sheet is backed up first, and the original files are copied, never moved. |
Logging Events
A timestamped list of what happened in this session — useful alongside the log itself.
%APPDATA%\CIMAdb) on this computer, and Manage Logs works in that folder — even if you moved the store
with Database Location (§11.7). If your store lives somewhere else, back it up by copying its folder (or with Start
Fresh's backup, Part 3 §3.8) rather than with Backup Database.10.3 Data Tools — moved to Part 12
The Data Plotter now lives with the other data tools — see Part 12. Part 12 covers the Data Plotter, Statistics and Data Collation, all opened from Tools ▸ Output.
Back to contents10.4 Print Page (A4)
Tools ▸ Output ▸ Print Page (A4)… prints the page currently in view as an A4 sheet.
- Open the format page you want to print, so it is the page in view. (Otherwise Kolate says “Open a format page first, then use Print Page (A4).”)
- Choose Tools ▸ Output ▸ Print Page (A4)…. The standard Windows print dialog opens.
- Check the printer and settings, then print. The job appears in the print queue as “Kolate <FORMAT> — <session> — Page N”.
- Fits the sheet. Kolate renders the page to an image (150 DPI, on white, with a small margin) and scales it to fit A4, so nothing is clipped and your live view is never disturbed. Transparent areas print white.
- Orientation chosen for you. Wide pages default to Landscape, tall ones to Portrait. You can still change it, and any other setting, in the print dialog.
- Remembers your printer. The dialog opens with the printer and settings you used last time for A4 prints — paper, copies, colour, duplex and so on — with A4 and the automatic orientation applied on top. If that printer is no longer installed, Windows' default printer is used. Whatever you choose is remembered for next time.
- The TXT and RTF pages' own Print buttons keep their own separate memories, so each kind can use a different printer. These memories are part of your profile (§11.8), so they survive Start Fresh and travel with Export my profile.
10.5 The Multi-Copy HUD
Tools ▸ Output ▸ Multi-Copy (HUD)… opens a small floating window that gathers everything you copy into one
growing list, ready to paste out as a single block. It shows a live count (“N items • M chars”) and
offers:
| Option | What it does |
|---|---|
| Append (A→Z) | Keeps collecting copies in order. |
| De-duplicate exact items | Skips a copy that exactly matches one already gathered. |
| Ignore items shorter than | Drops trivially short snippets (you set the length). |
| Delimiter | What joins the items — \t, \n, \r\n or any separator you type. |
| Placement | Where a new item is added in the assembled list. |
Use it to build a list, a set of cells, or a multi-line note by copying pieces one at a time from anywhere.
Back to contents10.6 Ext Functions — Run Your Own Programs
Ext Functions lets any program or script of yours act on the item currently focused in Kolate — no plug-in system, no configuration files. A “function” is simply a runnable file sitting in one folder.
Setting a function up — three steps
- Open Kolate's data folder (by default
%APPDATA%\CIMAdb, or wherever Tools ▸ Database ▸ Database Location points). Inside it is a folder namedExtFunctions; Kolate creates it on first run together with a working example,wordcount.bat. - Drop your program or script into that folder. Accepted kinds:
.exe,.bat,.cmd,.ps1(PowerShell),.py(Python —python.exeor thepylauncher must be installed). - Back in Kolate the file appears in the Ext Functions dropdown at the bottom-right (the list refreshes when you press RUN FUNCTION with nothing selected).
Running a function
- Click the container of the item you want to work on — that makes it the focused clip.
- Pick the function in the dropdown and press RUN FUNCTION.
- Kolate launches your program and passes the focused clip's file path as the first argument (
%1in a batch file,$args[0]in PowerShell,sys.argv[1]in Python). If nothing is focused the argument is empty — write your script to cope with that.
The working directory is the ExtFunctions folder, so relative paths in your script resolve there, and
the status line confirms what was launched and with which file. If the runner is not visible, press F11
until the VIEW button reads VIEW 5/5.
wordcount.bat echoes the focused file's path and its line
count, then pauses so you can read the output. Copy it, rename it, and replace its body with your own commands —
anything that accepts a file path as its first argument instantly becomes a Kolate function: converters, uploaders,
image tools, your own Python analysis, and so on.Part 11 — Security & Administration
This part covers the settings that protect and shape your Kolate: encrypting the database behind a passphrase, editions and activation, the capacity limits, Production Mode, how long messages stay on screen, the Duplicates window, where the store lives, your personal profile, where to find Start Fresh and backups, carrying your work on a USB stick, and — in plain language — how your data is protected and the simple habits that keep it safe.
11.1 Protecting the Store with a Passphrase
Tools ▸ Protection ▸ Protect the store (passphrase)… opens Kolate - encrypt the store. It encrypts your whole store at rest with AES-256: the database and every stored file, so nothing in it can be read without the passphrase (or the recovery key).
Turning protection on
- Enter a passphrase of at least 6 characters, twice. (If the two do not match, Kolate says so.)
- Leave Remember on this computer (open without asking here) ticked — the default — if you want this computer to open the store without asking. Untick it to be asked every time.
- Press Enable encryption.
- Kolate shows your recovery key. This is the only way to open your data if you forget the passphrase. Press Copy or Save to file... (or write it down), keep it somewhere safe, then press I've saved it.
- Close and reopen Kolate. On that start the database is rewritten as an encrypted file, and a small window Kolate - encrypting your stored files shows how many of your stored files have been encrypted so far. This happens once; with a large store it can take a few minutes. Do not switch the computer off or unplug the drive while it runs. If it is interrupted anyway, nothing is lost: the next start simply carries on where it stopped.
Living with it
- When the store needs unlocking, Kolate - unlock the store asks for the passphrase. Press Unlock, or choose I have a recovery key instead. Exit Kolate leaves without opening the store.
- A wrong passphrase shows “Wrong passphrase (attempt n of 5).” After five wrong attempts Kolate closes.
- Remember on this computer opens the store silently on this computer only. A copy carried to another computer still asks for the passphrase.
- With protection on, the window offers Change passphrase (enter the current one first) and Remove protection. Changing it with Remember unticked also forgets the saved key on this computer. Removing protection decrypts the database and all stored files the next time you close and reopen Kolate (the same progress window shows decrypting your stored files). Protection is only switched off once every file has been decrypted successfully.
- If encryption cannot be started for any reason, Kolate closes to protect your data and tells you your data is unchanged.
- You work exactly as before: pages open, play, preview, edit, copy and recall just the same. When another program has to open a stored file (a media player, your web browser, a file pasted into Explorer), Kolate gives it a temporary readable copy in a private folder on this computer and deletes that folder when Kolate closes.
11.2 Editions and Activation
Kolate runs as the free Unregistered edition until you activate the Registered edition with a licence. The step-by-step is in Part 1 §1.4; in short:
- Choose Help ▸ Enter Pass Code… — the Kolate Activation window opens. (The yellow “Kolate Unregistered User Id = …” banner shows your User Id but is not a button.)
- Press Copy beside Kolate Identifier and send that one line to support. The Email box is optional.
- The licence comes from the publisher — a long code, and/or a
.kolateliclicence file. Paste the code into Kolate Licence (Paste or Ctrl + V; line breaks from the e-mail do not matter), or press Open file…, or drag the file onto the window. - When the line under the box turns green — “Valid licence for this computer.” — press OK. Kolate confirms “This computer has been activated for Kolate.” and the larger limits are available at once; no restart is needed.
A few administration points:
- Activation is per computer: the licence you receive works only for this User Id on this computer. If the line under the box says “This licence was issued for another computer.” or “…for another User Id”, send support the Kolate Identifier shown on this computer.
- The activation is kept on this computer, outside the database, so it survives Start Fresh, a database wipe, renaming or clearing the CIMAdb folder, and Database Location changes — you never re-enter the licence on the same computer. It does not travel with a copied CIMAdb folder.
- There is nothing for you to run: the licence is digitally signed by the publisher and Kolate only checks it.
- Upgrading from Kolate 1: a Kolate 1 passcode is not accepted. After the upgrade the computer shows as Unregistered; pasting the old passcode explains this. Send your Kolate Identifier to support for a Kolate 2 licence.
What the Registered edition unlocks — every session in the Session list, the “All Sessions” search scope, “all sessions” on Generate Page and on the WAV, MIDI and URL pages, Production Mode, and the larger capacity limits below — is summarised in Part 1 §1.4.
Back to contents11.3 Setup Limits — Capacity
Tools ▸ Preferences ▸ Setup Limits… opens Kolate Setup — Limits (“Set Kolate's capacity limits”), which controls how densely the grids are packed. Sessions, and pages per session, are unlimited. There are five settings, each a dropdown, and the edition decides how far they go:
| Setting | Unregistered (fixed) | Registered |
|---|---|---|
| PSA grid pages (36 slots each) | 1 | 1 to 20 (up to 720 slots); default 1 |
| URLs per URL page | 12 | 1 to 40; default 12 |
| Sounds per WAV/MP3 page | 12 | 1 to 40; default 12 |
| MIDIs per MIDI page | 12 | 1 to 40; default 12 |
| Files per File-Collection entry | 25 | 1 to 50; default 25 |
- In the Unregistered edition each dropdown is locked on its fixed value (1, 12, 12, 12, 25), and a red note explains that activating Kolate (Help ▸ Enter Pass Code…) unlocks the ranges up to 20 / 40 / 40 / 40 / 50.
- In the Registered edition you pick each value yourself. Restore defaults sets 1, 12, 12, 12, 25 again.
- Press Save. Kolate confirms “Limits saved. Some changes (grid size, per-page counts) take full effect after a restart.”
This form also appears once on first run (Part 1 §1.2).
11.4 Production Mode
Tools ▸ Preferences ▸ Production Mode is a tickable item kept from earlier versions of Kolate (Registered edition only; in the Unregistered edition it is greyed out).
- In Kolate 2 it no longer changes how many tiles a page holds. The tiles per page — URLs, sounds and MIDIs — are set in Setup Limits (§11.3), whatever this switch says. Use Setup Limits to change capacity.
- Ticking or unticking it saves the choice at once; Kolate then offers to restart. Answering Yes restarts Kolate now; No keeps working, and the setting applies from the next start.
11.5 Toast Duration
Tools ▸ Preferences ▸ Toast Duration… sets the minimum number of seconds every toast message stays on screen. The default is 3 seconds.
- Choose Tools ▸ Preferences ▸ Toast Duration….
- Type a whole number from 1 to 30 and press OK. (A blank or out-of-range value is ignored and the setting is unchanged.)
- Kolate confirms “Toasts will now stay at least N second(s).”
Raise it if messages vanish before you finish reading them; lower it if you prefer them to clear quickly. Each kind of message has its own usual time — about 3 s for success, 4 s for information, 6 s for warnings and 8 s for errors — and is never shown for less than your minimum.
- Toasts appear at the bottom-right of the active Kolate window; up to 3 are on screen at once, the newest at the bottom.
- Point at a toast to hold it; click it (or its ×) to close it.
- Missed one? The notification bell at the right of the menu row, or View ▸ Notifications, lists the messages from this session (Part 2 §2.12).
- The setting is kept in the data folder, so it travels with CIMAdb and survives Start Fresh.
11.6 The Duplicates Window
The SD (Show Duplicates) button in the SAVE • RECALL • NAVIGATE card (Part 2 §2.4) opens Show Duplicates — Kolate for the last saved entry. It finds every copy of that content by content hash across the whole database — not just the current session.
- The top line shows the count: “Duplicates found: N” with the format, title and Id of the last entry.
- Each duplicate is shown as “Duplicate i of N (newest = 1)” with its Session, Title and Page, Format and Id, Created date and file path.
- ◀ Prev and Next ▶ step through them; Last duplicate shows the newest one in the window; Close closes it.
- If there are none, it says “No duplicates of the last entry were found.”
It pairs with the Allow duplicates option (Part 2 §2.4): leave that unticked and Kolate blocks exact repeats at save time — the SAVE NOTICE bar says “Not saved - exact duplicate of entry n” — or tick it to keep them, then use this window to review what you have.
Back to contents11.7 Database Location
Tools ▸ Database ▸ Database Location… chooses the folder Kolate uses for its whole data set — the database,
the stored files, sheets, classifications and exports. The default is %APPDATA%\CIMAdb.
- Copy your data first if you want to keep it. Kolate does not move the data for you: close Kolate and copy (or move) your existing data folder to the new place before you point Kolate at it.
- Choose Tools ▸ Database ▸ Database Location…. A folder browser opens; pick the folder (use Make New Folder to create one).
- Kolate confirms “Database location saved: <folder>” and asks “Restart Kolate now?”. Answer Yes — Kolate restarts and uses the new location.
Going back to the default. Open Database Location…, cancel the folder browser, and answer Yes to “No folder chosen. Return the database location to the DEFAULT?”.
11.8 My Profile — Your Personal Settings
Your personal settings (recent colours, remembered printers, New Pg size and background, My dictionary) live in a profile kept on this computer, outside the database, so they survive a database move or Start Fresh. Export, import and the profile folder are on Tools ▸ My Profile — see §3.12 for the full description.
Back to contents11.9 Start Fresh and Backups
Tools ▸ Database ▸ Start Fresh… (also the Start Fresh button on the command bar) clears the whole store — every entry and stored file — after showing a per-format summary. It first asks whether to back up: Yes (recommended) copies the whole data folder beside it, so you can restore by renaming the copy back to CIMAdb; No clears without a backup; Cancel stops. Your activation, your profile and your theme are kept. The full description, with the other database tools, is in Part 3 §3.8.
For repeatable tests, Manage Logs also offers Backup Database and Restore Checkpoint (§10.2).
Back to contents11.10 Carrying Your Work on a USB Stick — Safely
Many people finish work at home, copy it onto a USB stick, and carry on at the office (or the other way round). A USB stick is small and easy to lose, so this section shows, step by step, how to set things up so that if the stick is lost or stolen, nobody who finds it can read your data. You do not need to know anything about data protection to follow it: the set-up takes about 20 minutes once, and after that each journey is three simple habits.
The idea in one picture: two locks
Think of the USB stick as a bag with your folder inside it.
| Lock | What it locks | Who provides it |
|---|---|---|
| Lock 1 — the whole stick | Everything on the stick: the Kolate database and every picture, sound, PDF, MIDI file and file collection you saved, plus anything else you put on the stick. | Windows (BitLocker To Go), or a USB stick with built-in encryption. |
| Lock 2 — Kolate's passphrase | Your whole Kolate store: the database (titles, summaries, sessions, classifications, text entries) and every stored picture, sound, PDF, MIDI file and file collection. | Kolate — Tools ▸ Protection ▸ Protect the store (passphrase)… (§11.1). |
What a finder could see
| How the stick was set up | If it is lost or stolen |
|---|---|
| Lock 1 and Lock 2 (recommended) | Nothing readable. Without your passwords the stick is just scrambled data. |
| Lock 1 only | Nothing readable without the stick's password. |
| Lock 2 only | Your pages, pictures, sounds, documents and database are unreadable. A finder can see that a Kolate folder is there, the names and dates of the files, and a few settings (window layout, theme, options) — but not their contents. |
| No locks | Everything can be read by anyone who plugs the stick in. |
Part A — set-up, once (at home)
- Choose the stick. Use a good-quality USB 3 stick with plenty of free space (at least twice the size of your CIMAdb folder). Keep it only for Kolate if you can.
- Turn on Lock 1 — encrypt the whole stick with BitLocker To Go.
- Plug the stick in and open File Explorer (Windows+E) ▸ This PC.
- Right-click the USB drive and choose Turn on BitLocker.
- Tick Use a password to unlock the drive and type a strong password twice (see “Good passwords” below).
- Save the recovery key when asked — to your Microsoft account, to a file on your computer (not on the stick), or print it. Keep it somewhere safe at home. It is the only way in if you forget the password.
- Choose Encrypt entire drive, then Compatible mode (best for a stick used on more than one computer), and press Start encrypting. Wait until Windows says it has finished before you unplug the stick.
- Put your data on the stick. Close Kolate first (File ▸ Exit), so nothing is half-written. Kolate's data
lives in one folder, CIMAdb — by default in
%APPDATA%\CIMAdb(type that into File Explorer's address bar to open it). Copy the whole CIMAdb folder onto the stick, for example toE:\CIMAdb. - Tell Kolate to work from the stick. Start Kolate, choose Tools ▸ Database ▸ Database Location…, pick the CIMAdb folder on the stick, and answer Yes to restart (§11.7). From now on Kolate reads and saves straight on the stick, so there is only ever one up-to-date copy of your work.
- Turn on Lock 2 — Kolate's passphrase. Choose Tools ▸ Protection ▸ Protect the store
(passphrase)…, type a passphrase twice and press Enable encryption (full details in §11.1).
- Save the recovery key Kolate shows you (Copy or Save to file…, then I've saved it) — again, somewhere safe at home, never on the stick.
- Remember on this computer means this computer opens the store without asking. Leave it ticked only on your own computers that have their own Windows password. On a shared or borrowed computer, untick it.
- Close Kolate and open it again: the database and all stored files are rewritten in encrypted form (a progress window shows how far it is — leave the stick plugged in until it has finished).
- Set up the other computer. Install Kolate there too. Activation belongs to each computer and does not travel on the stick, so activate that copy as well (§1.4). If you want your colours, printers and personal dictionary there too, use My Profile ▸ Export my profile… here and Import a profile… there (§3.12).
Part B — every journey
| When | What to do |
|---|---|
| Leaving | 1. Close Kolate (File ▸ Exit) and wait until its window has gone. 2. Click the Safely Remove Hardware icon in the taskbar (bottom right) and choose the stick — or right-click the drive in File Explorer and choose Eject. 3. Unplug the stick when Windows says it is safe. As soon as it is unplugged, Lock 1 is closed again automatically. |
| On the way | Keep the stick on you (a pocket or a zipped bag, not loose in a car). Never keep a note of the passwords with it. |
| Arriving | 1. Plug the stick in and type the stick's password when Windows asks (Lock 1). 2. Start Kolate. If it was set up as in Part A it opens straight from the stick; it asks for the passphrase (Lock 2) unless you ticked Remember on this computer there. 3. If the stick has a different drive letter on this computer, or Kolate cannot find your data, choose Tools ▸ Database ▸ Database Location…, pick the CIMAdb folder on the stick and answer Yes to restart. |
| Finishing | Same as Leaving: close Kolate, eject, unplug. |
Good passwords and passphrases
- Use three or four unrelated words, for example “copper-lantern-river-71” (do not use this one). Longer is stronger; Kolate needs at least 6 characters, but aim for 15 or more.
- Use different ones for Lock 1 and Lock 2, and do not reuse your email or bank password.
- A password manager is a safe place to keep them. Never write them on the stick, its label or its case.
- Typing Kolate's passphrase wrongly five times closes Kolate. Nothing is lost — start Kolate again and take your time.
Keep a backup — a lost stick should cost you nothing
The locks stop strangers reading your data, but they do not bring it back. Keep a second copy at home: once a week
(or after an important session), close Kolate and copy the CIMAdb folder from the stick to a folder on your home
computer or an external drive, for example Documents\Kolate backups\CIMAdb 2026-11-08. Because the
database and the stored files inside are still encrypted, the backup is protected by Lock 2 as well. To use a backup, copy it to a
new stick and point Database Location… at it.
If the stick is lost or stolen
- Don't panic. With both locks on, whoever finds it cannot read your work.
- Take a new stick, turn on Lock 1 (Part A, step 2) and copy your latest backup onto it.
- On each computer, use Database Location… to point Kolate at the new stick.
- If you think someone may know your passwords, give the new stick a new password, and in Kolate use Tools ▸ Protection ▸ Protect the store (passphrase)… ▸ Change passphrase.
- If your organisation has a data-protection or IT-security contact, tell them, as their rules may require.
If BitLocker is not available on your computer
Turning BitLocker on needs Windows 10 Pro, Enterprise or Education. On Windows 10 Home you can still open a stick that was encrypted on a Pro computer, but you cannot encrypt one. Two good alternatives:
- A hardware-encrypted USB stick — it has its own keypad or password and encrypts everything inside itself, so it works on any computer.
- Ask your IT department: many organisations supply encrypted sticks and require them for work data.
Quick checklist
| Once | Every journey |
|---|---|
| ☐ Stick encrypted with BitLocker To Go (Lock 1) ☐ CIMAdb copied to the stick ☐ Database Location set to the stick on both computers ☐ Kolate passphrase on (Lock 2) ☐ Both recovery keys saved at home, not on the stick ☐ Kolate installed and activated on both computers |
☐ Close Kolate ☐ Eject, then unplug ☐ Stick on you, passwords not with it ☐ Unlock the stick, then start Kolate ☐ Weekly backup at home |
11.11 How Your Data Is Protected
This section explains, without technical words, what Kolate does to keep your information private, what you control, and what is left to Windows and to you. Read it once; you will then know exactly where you stand.
1. Your data stays on your computer
Kolate is a local program. Everything you save is kept in one folder, CIMAdb, on your computer (or on the USB stick you chose, §11.10). Kolate does not upload your pages, does not keep an online account of your work, and needs no internet connection to work. Nobody at Kolate can see your data.
2. Nothing is recorded unless you ask
The diagnostic log starts OFF every time (§1.3). Crash reports hold only the error, never your page contents.
3. With a passphrase, everything you saved is locked
Turn protection on once (Tools ▸ Protection ▸ Protect the store (passphrase)…, §11.1) and Kolate encrypts your store. Encrypting means scrambling the data with a secret key so that it looks like random noise to anyone without that key. Kolate uses AES-256, the same standard banks and governments use.
| Part of your store | Without a passphrase | With a passphrase |
|---|---|---|
| Database — titles, summaries, sessions, classifications, text entries | Readable by anyone who opens the folder | Encrypted |
| Stored files — pictures, sounds, PDFs, MIDI, SVG, HTML, RTF and text pages, URL lists, file collections | Readable | Encrypted |
| Recycle Bin, Auto-Copied texts, saved Data Plotter sets, search history, classifications | Readable | Encrypted |
| Settings — window positions, theme, options, short drop-down histories | Readable | Readable (Kolate needs them before it can ask for the passphrase; they contain no page contents) |
| File and folder names and dates | Visible | Visible (the contents are not) |
4. How the keys work — in everyday terms
- Your passphrase is like the key to a safe. Kolate never stores it; it only stores a scrambled “lock” that your passphrase opens. A wrong passphrase simply does not open it, and after five wrong tries Kolate closes.
- The recovery key is the spare key you are given once, when you switch protection on. It opens the store if you forget the passphrase. Nobody else has a copy — not even Kolate's makers. Lose both the passphrase and the recovery key and the data cannot be opened by anyone. That is what makes it safe.
- Remember on this computer lets this computer open the store without asking. The remembered key is itself locked by Windows to your Windows sign-in on this computer, so it is useless if the folder is copied elsewhere. It does mean that anyone who can sign in to your Windows account here can open Kolate, so your Windows password matters (§11.12).
5. While you work
Once unlocked, Kolate works exactly as before. When another program must open one of your stored files — a media
player, your web browser, a file you paste into Explorer — Kolate hands it a temporary readable copy kept in a private
folder on this computer (%LOCALAPPDATA%\CIMA\open). That folder is deleted when Kolate closes, and any
leftovers from a crash or power cut are removed the next time Kolate starts. Files you deliberately export or
paste outside Kolate are ordinary files: they are yours to keep or delete.
6. What Kolate cannot protect
- An unlocked computer. If someone uses your computer while Kolate is open, or while you are signed in, they see what you see. Lock the screen when you step away (Windows+L).
- The Windows clipboard itself. Whatever you copy is, for a moment, on the Windows clipboard, and Windows may keep its own history (Windows+V) or sync it to your other devices. §11.12 shows how to turn that off.
- Copies made before protection. Backups or copies of the CIMAdb folder made before you turned protection on are not encrypted. Delete them, or replace them with a new backup.
- The diagnostic log (cima.log), if you switch logging on, is plain text. Switch it off when you have finished reporting a problem and delete the log from Manage Logs.
- Viruses and spyware. Encryption protects data at rest; it cannot stop a program that is already spying on your computer while you work. Keep Windows Security switched on and up to date.
11.12 Keeping Your Data Safe — a Beginner's Guide
You do not need to be good with computers to keep your data safe. Follow the steps below once (about half an hour), then keep the everyday habits. Each step says why it matters.
Part A — set up, once
- Give Windows a password or PIN. Why: it is the front door to everything on the computer, including
Kolate's “Remember on this computer”.
Start ▸ Settings ▸ Accounts ▸ Sign-in options ▸ set a PIN or Password. Then, on the same page, set Require sign-in to When PC wakes up from sleep. - Make the screen lock itself. Why: a computer left open is an open door.
Settings ▸ Personalisation ▸ Lock screen ▸ Screen timeout settings: choose 5–10 minutes. Get used to pressing Windows+L whenever you leave your desk. - Switch on Kolate's passphrase. Why: it encrypts your whole store, so a copied or stolen CIMAdb
folder is unreadable.
In Kolate: Tools ▸ Protection ▸ Protect the store (passphrase)…, type a passphrase twice, press Enable encryption, save the recovery key (next step), then close and reopen Kolate and let the progress window finish (§11.1). - Keep the recovery key somewhere safe — away from the computer. Why: it is your only way back in if
you forget the passphrase.
Good places: printed and kept with your important papers at home; in a password manager; on a separate USB stick kept at home. Bad places: a file on the desktop, an email to yourself, the same USB stick as your data, a sticky note on the screen. - Encrypt the whole computer or drive (if you can). Why: it protects everything on the disk if the
laptop is lost — not only Kolate.
Windows 10 Pro: Control Panel ▸ System and Security ▸ BitLocker Drive Encryption ▸ Turn on BitLocker and save its recovery key safely. Many laptops with Windows 10 Home show Device encryption under Settings ▸ Update & Security instead. For a USB stick, see §11.10. - Turn off clipboard history and sync (recommended). Why: Kolate already keeps what you want to keep;
Windows' own clipboard history and cloud sync would keep extra copies of everything you copy.
Settings ▸ System ▸ Clipboard ▸ switch Clipboard history and Sync across devices off. - Keep Windows and your protection up to date. Why: updates close the holes criminals use.
Settings ▸ Update & Security ▸ Windows Update ▸ Check for updates. Under Windows Security, make sure Virus & threat protection and Firewall show green ticks. - Tidy up old, unprotected copies. Why: a backup made before you set a passphrase is still readable.
Look for old copies of the CIMAdb folder (and old Start Fresh backups) made before protection, make a new backup (Part C), then delete the old ones.
Part B — good passphrases, made easy
- Use a short sentence or three to four random words, e.g. “purple-kettle-harbour-58” (do not use this one). Long and memorable beats short and complicated. Kolate needs at least 6 characters; aim for 15 or more.
- One password, one place. Never reuse your email, bank or Windows password for Kolate or for a USB stick.
- Avoid names, birthdays, pet names, football teams, “password”, “123456” or keyboard patterns.
- A password manager (for example the one built into your web browser, or a dedicated app) can remember them all for you behind one strong master password.
- Never tell anyone your passphrase — not a colleague, not “support”. Kolate's makers will never ask for it, and do not need it to help you.
- Think someone has seen it? Change it: Tools ▸ Protection ▸ Protect the store (passphrase)… ▸ Change passphrase. It takes a second and your data stays as it is.
Part C — backups: protection against loss
Encryption keeps strangers out; a backup keeps your work if a disk fails, a stick is lost or a file is deleted by mistake. Use the simple 3-2-1 rule: 3 copies of your data, on 2 different devices, with 1 kept somewhere else (another room, building or a trusted relative).
- Close Kolate (File ▸ Exit).
- Open the CIMAdb folder (Tools ▸ Database ▸ Database Location shows where it is) and copy the whole folder to
an external drive, naming the copy with the date, e.g.
CIMAdb 2026-11-09. - Do this weekly, and after any important session. With protection on, your backup is encrypted too — you need the same passphrase or recovery key to open it.
- Every few months, check a backup really works: point Database Location at a copy, open Kolate, look at a few pages, then point it back.
Part D — everyday habits
| Habit | Why |
|---|---|
| Press Windows+L when you leave the computer | Nobody can use your open Kolate or your Windows account |
| Untick Remember on this computer on shared or borrowed computers | Kolate then asks for the passphrase every time |
| Close Kolate before you shut down, travel or unplug a drive | Everything is saved and the temporary working copies are removed |
| Be careful where you paste | Whatever you paste into an email, chat or website leaves the protection of Kolate |
| Do not open unexpected attachments or links | Most attacks start with a convincing email |
| Switch logging off after reporting a problem | The diagnostic log is plain text (§1.3) |
| Keep the backup routine | Encryption stops reading; only backups stop losing |
If something goes wrong
- I forgot the passphrase.
- Start Kolate, choose I have a recovery key instead and type the recovery key. Then set a new passphrase with Change passphrase.
- I lost both the passphrase and the recovery key.
- The encrypted store cannot be opened by anyone — that is the protection working. Restore an older backup whose passphrase you still know, or start a new store.
- My laptop or USB stick was lost or stolen.
- With protection on, the finder cannot read your Kolate data. Change your Windows password and your Kolate passphrase on your other computers, restore from your backup (§11.10), and tell your organisation's IT or data-protection contact if the data belongs to work.
- The encryption window was interrupted (power cut, drive unplugged).
- Start Kolate again. It carries on where it stopped; every file is checked before it is replaced, so nothing is lost.
Quick checklist
| Once | Regularly |
|---|---|
| ☐ Windows password / PIN and screen lock ☐ Kolate passphrase switched on ☐ Recovery key saved away from the computer ☐ BitLocker / Device encryption on (if available) ☐ Windows clipboard history and sync off ☐ Old unprotected copies deleted |
☐ Windows+L when leaving ☐ Windows updates installed ☐ Weekly backup of CIMAdb ☐ Logging off when not needed ☐ Passphrase changed if anyone may have seen it |
Part 12 — Data: Plotter, Statistics and Data Collation
Kolate has three tools for numbers you have measured: the Data Plotter for a quick graph, Statistics for summary figures, charts and plain-words explanations, and Data Collation for bringing instrument logs together (freezers, incubators, fridges and so on), checking them and writing a report a colleague can follow. All three are on the Tools ▸ Output menu, and they can hand data to one another.
12.1 Three Data Tools — Which to Use
| Tool | Menu | Use it when you want to… |
|---|---|---|
| Data Plotter | Tools ▸ Output ▸ Data Plotter... | See a graph of a table on the clipboard or a logger file quickly: zoom in, read values, fit a curve. |
| Statistics | Tools ▸ Output ▸ Statistics... | Get summary figures (mean, median, spread…), percentiles, histogram, bar, pie and box charts, regression, correlation and trend — every result explained in plain words — and save charts or a report page into Kolate. |
| Data Collation | Tools ▸ Output ▸ Data Collation... | Work with time-based instrument logs — freezers, incubators, fridges, cold rooms, any data logger: check them, set aside readings that cannot be used (with a reason), compare probes or instruments, and write a report for others. |
The tools connect: the Plotter has Send to Statistics and Send to Data Collation; Statistics has Open in Data Plotter; each log in Data Collation has Open in Data Plotter, and Data Collation can take the log open in the Plotter (From the Data Plotter).
12.2 The Data Plotter
The Universal Data Plotter turns a data file, or a table you have copied, into a graph. It reads logger and
text files (.m70, .csv, .txt, .tsv, .dat, .log)
and remembers its size, position and your last folder.
The toolbar
| Control | What it does |
|---|---|
| Data file: | The file to plot. Type a path, or pick from the drop-down of recent files (up to 24). |
| Browse… (Ctrl+O) | Choose a file. |
| Load / Reload | Read the file in the Data file: box (again). |
| Plot from Clipboard (Ctrl+Shift+V) | Plot a table you have copied (for example cells from Excel). See “Named and kept” below. |
| Saved: | The tables you have plotted from the clipboard, newest first. Choose one to plot it again. |
| Plot: | Separate panels (one panel per channel) or Overlay selected (the ticked channels on one graph). |
| Zoom In / Zoom Out | Zoom the horizontal (time or X) axis. |
| Y In / Y Out / Y Fit | Zoom the vertical axis; Y Fit goes back to automatic vertical scaling but keeps the time window you are looking at. |
| Fit / Reset | Show everything again on both axes. |
| Grid: | A Show tick box and a grid colour. |
| Save Graph PNG… (Ctrl+S) | Save the graph as a picture. |
| Export Parsed CSV… | Save every row as read by the Plotter, as a clean CSV file (UTF-8). |
| Send to Statistics | Open the plotted data in Statistics (§12.3). |
| Send to Data Collation | Add the plotted data as a new log in Data Collation (§12.4). |
While a button's work is running, the button greys out and the wait cursor shows; a second click in that time is ignored.
The three tabs
- Graph — the plot, with a time scrollbar for long series.
- Data Preview — the table as read (the first 500 rows; the export holds every row).
- Diagnostics — what the Plotter found in the file and any warnings.
The left panel
- Detected file — what kind of file was found and its range.
- Detected measurement channels — one line per channel with its colour and name, and “n values” under it. Tick the channels to show; All, None and Auto (Kolate's own choice) help. If a column was left out automatically, the reason is shown: “identifier/metadata column”, “only x% of rows are numeric” or “sequence/index-like column”.
- Curve fit • interpolate / extrapolate — see below.
Mouse and keys on the graph
| Action | Result |
|---|---|
| Mouse wheel | Zoom the horizontal axis. |
| Shift + wheel | Zoom the vertical axis. |
| Left-drag | Draw a box to zoom into (both axes; works in Overlay too). |
| Right-drag | Pan. |
| Hover | Read the values under the pointer. |
| Click | Copy that row to the clipboard (or, on a fitted line, read the fit — see below). |
| Double-click | Fit everything back into view. |
Tables without a time column
A file does not need a time column. If none is found, the Plotter reads it as a plain X–Y table (for example temperature against resistance): the first column that is mostly numbers becomes the X axis and the other number columns become series; if there is no such column, X is the row number. Rows are sorted by X. Detected file then shows “Mode: X-Y numeric (no time column)”, and Data Preview and the export name the first column after the X axis instead of “Timestamp”.
Cells such as an empty cell, na, n/a, nan, null, none, missing, -- or *** are treated as missing. Values that look like an instrument's “out of range” code are flagged in Diagnostics but never removed — they are plotted unchanged so you can decide.
Plot from Clipboard — named and kept
- Copy a table (cells from Excel, or a Tab- or comma-separated table).
- Press Plot from Clipboard. The Name this data box asks “Give this data a name so you can recall it later:” (the suggested name is “Clipboard” with the date and time).
- Press Save & Plot. (Cancel plots and saves nothing.)
Every table plotted this way is kept, because data thrown away as “temporary” is often the data needed later. The Saved: list shows them as “Name (date time)”. They are kept with your Kolate data, so they travel with a portable store, and Statistics sees the same list (“Shared with the Data Plotter:”, §12.3).
Curve fit — interpolate and extrapolate
The Curve fit • interpolate / extrapolate panel fits a line or curve to one channel and lets you read values from it.
- Visibility: tick boxes Data line, Data points, Fit line and Prediction band (all on at first).
- Series: the channel to fit. Model: Auto (best fit), Polynomial, Exponential, Logarithmic or Power. Order: 1 to 6 (Polynomial only; lower for small data sets). Conf %: the confidence level of the band (95 at first).
- Extrapolate if fit ≥ [75] % — Kolate only predicts outside the measured range when the fit is at least this good.
- Press Fit / Update. The panel shows the model, its equation, “Fit R² = …% adjusted R² = …% (n = …)” and the data's X range, and the fitted line and its band are drawn. Auto tries each model the data allows and keeps the one with the best adjusted R².
- Some models need positive numbers — for example “Exponential fit needs all y-values > 0.” — and say so.
- For a time series, X is counted in seconds from the first reading.
Type a value in Evaluate X: and press Evaluate:
- Inside the data — “Interpolated at X = …”, the value, and its prediction interval (the range one new reading would be expected to fall in).
- Outside the data, fit too weak — “Extrapolation blocked…”, in red. Lower the threshold or improve the fit.
- Outside the data, fit good enough — “EXTRAPOLATED beyond the data range…”, the value, its interval and a “Certainty ≈ x%” figure, in red with “treat with caution”. The certainty is only a convenience label: it is near 100 % when the interval is narrow compared with the value and falls as the interval widens. The interval itself is the real answer, and it widens the further you go outside the data.
Clicking on the fitted line reads the equation at that exact X, marks the point and copies “X = …” and the value (separated by a Tab) to the clipboard. Clicking a data point that is not on the line copies that row, as before.
Sending data on
- Send to Statistics opens Statistics (or brings the open one forward) with the plotted data as a table; the first column is “Time” (or the X axis name).
- Send to Data Collation adds the plotted data as a new log to the open study, or opens Data Collation with it.
- With nothing loaded you are asked to load or paste data first.
12.3 Statistics
Tools ▸ Output ▸ Statistics... opens Kolate Statistics. Put a table in on the left; the results appear on the right, each one with what it means in plain words.
Getting your data in
Type or paste into the data box: one value per line, or columns separated by Tab, comma or semicolon. A first row of names is recognised. Results update a moment after you stop typing.
| Button | What it does |
|---|---|
| Paste | Replaces the data box with the table or list of numbers on the clipboard. |
| Open file… | Opens a .csv, .tsv, .txt or Data Plotter .m70 file (up to 20 MB). |
| Sample data | Loads a small example (sales by region) so you can try every tab. |
| Clear | Empties the data box. |
| Shared with the Data Plotter: | The tables kept by the Plotter (or by Keep). Choose one to load it. |
| Keep | Adds this table to the shared list, so either tool can find it again. The same table is never kept twice. |
| Open in Data Plotter | Keeps the table and plots it in the Data Plotter. |
The line under the box says how the table was read, for example how many rows and columns, the separator, and how many number columns and text columns there are. A column counts as numbers when at least 80 % of its filled cells are numbers (a leading £, $ or € or a trailing % is fine). Text columns are used as categories for the bar and pie charts. Cells that are not numbers are counted and reported, never silently dropped.
The tabs
Ten tab buttons run across the right side: Summary, Percentiles, Histogram, Box plot, Bar chart, Pie chart, Regression, Correlation, Trend and Report. On Summary, Percentiles, Histogram, Box plot and Trend, Numbers from picks the number column to use.
| Tab | What you get |
|---|---|
| Summary | A table “Measure | Value | What it means”: Count (n) — including how many empty or non-number cells were left out — Mean, Median, Mode, Minimum, Maximum, Range, Sum, Standard deviation (sample, and whole population), Variance, lower and upper quartiles, Interquartile range, Coefficient of variation, Skewness, Kurtosis (excess), Standard error of the mean, and the 95 % confidence interval of the mean. Copy results copies Summary and Percentiles as a table for Excel. |
| Percentiles | The 5th, 10th, 25th, 50th, 75th, 90th and 95th percentiles, each with “x % of the values are below…”. Type any Percentile (0–100), or use What percentile is the value to go the other way. |
| Histogram | How the values are spread. Set Bins (1–50) or press Auto; Bell curve (normal) draws the matching normal curve over it. The line under the chart names the busiest bin. |
| Box plot | Median, middle half and whiskers, with outliers marked by the usual 1.5 × IQR rule, and any value more than 3 standard deviations from the mean listed by row. Compare every number column draws one box per column on the same scale. |
| Bar chart | Group by any column (or compare the means of every number column), with Bar length = Number of rows, Sum or Mean of a number column. |
| Pie chart | Slices from and Slice size, as for the bar chart. At most 8 slices; slices under 3 % are grouped as “Other”. A pie needs a positive total — otherwise use the bar chart. |
| Regression | A straight line through X (explains) and Y (to predict). The table gives the equation, slope, intercept, correlation (r), R², pairs used, the p-value of the slope (below 0.05: a relationship this clear would rarely happen by chance) and the typical error of a prediction. Chart: Points and fitted line, Predicted against actual (points on the dashed line were predicted exactly) or Residuals (errors) (errors scattered evenly around 0 mean a straight line suits the data; a curve or funnel shape means it does not). Predict Y for X = gives a value with its 95 % range, and warns when X is outside the measured range. |
| Correlation | r for every pair of number columns: +1 = rise together, −1 = one rises as the other falls, 0 = no straight-line link. Shading shows strength (blue positive, red negative), and “Strongest first:” describes up to six pairs in words (“a weak”, “a moderate”, “a strong”…). Copy table copies the r values. A strong correlation does not prove that one causes the other. |
| Trend | The values in order with a moving average (type how many values to average over, or leave it empty for automatic). The line under the chart compares the first and second halves and says “rising”, “falling” or “about level”. |
| Report | The results you tick as one tidy page with its charts (in light colours so it prints well) — see below. |
Charts and reports into Kolate
Every chart tab has three buttons: Copy chart (as a picture), Save PNG… (named after the chart's title) and Save into Kolate, which saves the chart as a picture entry in the current session.
On the Report tab:
- Type a Report title (it starts as “Statistics of” and the column name).
- Tick what to include: Summary, Percentiles, Histogram, Box plot (ticked at first), Bar chart, Pie chart, Regression, Correlation table, Trend.
- Press Save into Kolate (an HTML page entry in the current session), Save HTML file…, or Copy report (to paste into Word, an e-mail or Kolate).
12.4 Data Collation — Overview and the Seven Steps
Tools ▸ Output ▸ Data Collation... opens Kolate Data Collation. It is for logs that run over time — the probes, data loggers and instruments in freezers, incubators, fridges, cold rooms, water baths, light sources and so on. Kolate lines the logs up, sets aside the readings that cannot be used (and says why), works out the figures that matter with honest confidence intervals, and writes a report a colleague can follow without having been there.
The window
- Top: the study's name (it is also the report's title), a line such as “2 logs · 4 channels · start to end”, and the buttons New study, Open study…, Save study and Save as….
- Left — the step bar: seven numbered buttons, each with a short hint. Steps 2–7 stay greyed until at least one log has been imported; steps you have passed show a ✓. You can go back to any step at any time.
- Bottom: ← Back and Next: step → (on the last step it becomes Save the study), and a status line.
| # | Step | What you do there |
|---|---|---|
| 1 | Import | Bring the logs in (§12.5). |
| 2 | Organise | Say what each log and channel is: instrument, probe position, set-point and limits (§12.6). |
| 3 | Validate | Set aside readings that cannot be used, each with a reason (§12.7). |
| 4 | Collate | Line the logs up, choose which channels to compare, see the events (§12.8). |
| 5 | Analyse | Figures and findings (§12.9). |
| 6 | Visualise | Charts (§12.10). |
| 7 | Present | A report for others (§12.11). |
Try an example first
The Import page offers three example studies made from made-up data. Open one and press Next to walk through all seven steps:
- Freezer without a fan: top vs bottom — two probes in a −20 °C freezer for 3 days.
- Two CO₂ incubators compared — temperature, CO₂ and humidity in two incubators on the same day, with door openings and recovery.
- A fridge over a weekend — one probe, 60 hours, one door left open, time in range.
Studies are saved as .kstudy files
- Save study (Ctrl+S) saves everything — the logs, your choices, exclusions and reasons,
comparisons and report texts — as one
.kstudyfile, in Documents\Kolate Studies unless you choose another folder. - The file carries a copy of every log's data, so the study opens the same way on another PC, or after the original log files have been moved. The results are worked out again when it opens.
- Open study… (Ctrl+O), or drop a
.kstudyfile on the window. An opened study starts at Organise. - If you close, start a new study or open another with unsaved changes, Kolate asks whether to save first.
Keys
| Keys | Action |
|---|---|
| Ctrl+S / Ctrl+O | Save study / Open study |
| Ctrl+Page Down / Ctrl+Page Up | Next step / previous step |
| Wheel / drag / double-click on a chart | Zoom / zoom to a stretch (in Validate: choose a stretch to set aside) / show everything |
For all shortcuts, see Part 13.
12.5 Step 1 — Import
With an empty study, the Import page offers four ways in:
| Button | What it takes |
|---|---|
| Add log files… | .csv, .txt, .tsv, Vaisala .m70, .dat, .log — several at once. You can also drop files on the window. |
| Paste a table | Cells copied from Excel: a time column and number columns. |
| From the Data Plotter | The log open in the Data Plotter now. |
| Open a saved study… | A .kstudy file, as you left it. |
- A log needs at least 10 rows.
- For Vaisala MI70 (
.m70) files, the channel names are read from the file itself (the order depends on which probes were plugged in). - If two logs have the same name, the second gets “(2)”, and so on. The first log you import names a new study.
Kolate's first guesses
On import Kolate fills in what it can tell — you check and correct it in Organise:
- Kind of instrument, from the file name (words such as “freezer”, “-20”, “incubator”, “CO2”, “fridge”, “cold room”, “ULT”) or, failing that, from the readings (for example a median below −8 °C suggests a freezer; between 30 and 45 °C an incubator; a CO₂ channel an incubator). If nothing fits it uses “Any logger (general)”.
- Location, from a room code in the file name.
- Probe position, from a channel name containing top, bottom, middle, front, rear, left, right, door, upper or lower.
- The usual set-point and limits for that kind of instrument, for every channel.
The list of logs
Once there are logs, the page lists them under “Logs in this study”. Each card shows the name and where it came from, the number of rows, how often a reading was taken, the start, end and duration, one chip per channel, and any notes found in the file. Each card has Open in Data Plotter (shows the log, without the set-aside readings) and Remove (takes the log out of the study; the file itself is not touched). You can add more logs at any time, from several instruments and days.
Back to contents12.6 Step 2 — Organise
Here you say what each log is. The set-point and limits you enter are what the results are judged against; leave them empty to describe a channel without judging it.
For each log
| Field | Meaning |
|---|---|
| Name | The name used everywhere — tables, charts, the report. |
| Group / condition | How logs are compared. Logs with the same group are pooled as one condition; different groups are set side by side. For example: Incubator A, Before service, Shelf 3. |
| Instrument | What was measured — the instrument or room, with its asset number if it has one. |
| Location | Room, bench or site. |
| Kind | The kind of instrument. It gives the usual set-point and limits, how fast it should recover after a door opening, and the optional instrument check (§12.9). Usual limits puts that kind's usual values back into every channel. |
| Notes | Anything a reader needs to know: how the probes were placed, what was stored, what happened during the log. Notes go into the report. |
For each channel
| Column | Meaning |
|---|---|
| Use | Untick to leave this channel out of everything. |
| Channel | The name (hover to see the name in the file). |
| Probe position | Where the probe sat: top, bottom, rear left, shelf 3, in a water bottle… |
| Measures | Temperature, speed, gas level, humidity, pressure, flow, light output or value. It decides the checks (humidity cannot exceed 100 %) and the smallest change that counts as an event. |
| Unit | °C, %, rpm… |
| Set-point | What the instrument is set to (37, 5.0, −20…). Empty = none. |
| Low limit / High limit | The lowest / highest acceptable reading. Empty = no limit on that side. |
| Event at ± | A change this far from the normal level counts as an event (such as a door opening). Empty = Kolate decides from the noise. |
| Readings | The lowest to highest reading, for reference. |
Numbers may use a comma or a point. A box that is not a number turns red, and Kolate warns if a low limit is not below the high limit.
Kinds and their usual values
| Kind | Usual set-point (low to high limit) | Should recover within |
|---|---|---|
| Thermal cycler (PCR) - probe pairs | none (probes judged against each other at each hold) | 15 min |
| Incubator (37 °C, CO₂) | Temperature 37 (36.5 to 37.5) °C; CO₂ 5 (4.5 to 5.5) %; Humidity no set-point, low limit 85 % | 15 min |
| Fridge / cold room (2 to 8 °C) | 5 (2 to 8) °C | 15 min |
| Freezer (-20 °C) | −20 (−30 to −15) °C | 30 min |
| Ultra-low freezer (-80 °C) | −80 (−90 to −70) °C | 45 min |
| Centrifuge run | chamber temperature 4 (2 to 8) °C | 15 min |
| Light source (lamp / LED / laser) | none | 15 min |
| Pump (flow / pressure) | none | 15 min |
| Any logger (general) | none | 15 min |
Humidity in a CO₂ incubator is not controlled to a set-point, so it only gets a lower limit.
12.7 Step 3 — Validate
Kolate checks every reading. On the left, “What the checks found” lists each log's issues, worst first (or “No problems found in this log.”). On the right is a chart of the chosen Log, with its set-point and limit lines; Whole log (or a double-click) shows all of it. Click an issue to zoom the chart to it.
Status words
| Word | Meaning |
|---|---|
| INVALID | The readings cannot be right — for example humidity above 100 % or below 0, a gas level below 0, a temperature below absolute zero, a negative speed. |
| CHECK | Worth a look before you trust it. |
| NOTE | For information. |
What is checked
| Check | What it means | Set aside at first? |
|---|---|---|
| Repeated or backwards time stamps | Two readings share a time, or the clock went back (a daylight-saving change, two logs joined). | No |
| The logger stopped | Gaps with no readings. Nothing is known about those times; they are not filled in. | No |
| A short log | Under an hour: trends and cycles are not judged. | No |
| Empty readings | Rows with no value for a channel; they are left out. | No |
| Settling at the start | The first readings, before the probe reached its working range — they describe the probe warming up or cooling down, not the instrument. Checked per channel, because humidity often settles hours after temperature. | Yes |
| Probe taken out at the end | At the end the readings move away and do not come back: the probe was removed or the logger stopped. | Yes |
| Impossible readings | See INVALID above. Humidity just above 100 % usually means water condensed on a probe colder than the air when it was first put in. | Yes |
| Single-reading spikes | A reading far from both of its neighbours — usually electrical noise or a loose connection. | Yes |
| Flat line | Exactly the same value for an hour or more while the channel varies elsewhere — a stuck sensor or frozen logger. | No |
Setting readings aside
- Where a check suggests an exclusion, its Set aside box is ticked as soon as it is found. Untick it to keep those readings. Your choice is remembered when the checks run again.
- Set-aside readings are left out of every figure but kept, and listed in the report with their reason. On the chart they show hatched grey; a suggestion you chose to keep shows as an amber band marked “kept”.
To set aside a stretch yourself (a door left open, a probe that was moved…):
- Drag across the chart over the stretch.
- In the box that appears, choose every channel or one channel, and a reason: Door open / loading samples, Probe moved or handled, Probe out of position, Sensor fault, Instrument maintenance or defrost, Power cut, or Other — I'll type it (then type the reason; it is required, because it goes into the report).
- Press Set aside. The stretch is listed under “Set aside by you”, where you can untick it or press ✕ to use the readings again.
12.8 Step 4 — Collate
The Line the logs up page has four parts.
When each log ran
A timeline of every log. Logs that overlap in time can be compared reading by reading; others are compared by their steady levels. Grey = set aside, amber marks = events.
Comparisons
The pairs of channels set side by side in Analyse and Visualise. Kolate suggests them: within one log, channels that measure the same thing in the same unit (for example top vs bottom); across logs, the same quantity in each (for example incubator A vs B).
- Each pair shows how it is compared (“reading by reading”, “steady levels”, or “not enough readings”).
- Type an allowed difference in the ± box (for example ±0.5 °C between two shelves) to have the pair judged; leave it empty to describe it only.
- Add a pair with Compare [channel] with [channel] Add; remove one with ✕. Only channels with the same unit can be compared.
- Once you edit the list it is yours; Suggest again replaces it with Kolate's suggestion.
Events found
An event is a channel leaving its normal level by more than its threshold (set in Organise, or worked out from the noise). Channels of one log moving together count as one event, such as a door opening; it is back to normal when every channel is back within its threshold. The table shows each event's start, whether it was a drop or a rise, the furthest value, how long until back to normal (or “not back by the end”) and the slowest channel.
The collated data as tables
- Save tidy table (CSV)… — one row per reading (log, group, location, channel, position, unit, time, value, and whether it was used or why it was set aside): the layout Excel pivot tables, R, Python and Prism read directly.
- Save summary (CSV)… — one row per channel with the figures of the Analyse step.
- Save events (CSV)… — one row per channel per event.
- Copy summary — the summary as a table to paste into Excel.
The files are saved in Documents\Kolate Studies unless you choose another folder.
12.9 Step 5 — Analyse
In short
A few plain sentences: how many logs and channels, how long, how much was set aside, then either “Everything judged is within its set-point and limits.” or the main points, and what is within specification.
What the data shows
The findings, most important first. Click one to see it on the chart (Visualise, Over time, zoomed to the stretch). Each has a status word:
| Word | Meaning |
|---|---|
| OUT OF LIMITS | Serious: the channel runs outside its limits, or is too often outside them. |
| LOOK | Worth checking — for example it runs clearly off its set-point, drifts towards a limit, was slow to recover after a door opening, or two probes differ by more than allowed. |
| OK | Within specification — for example it holds its set-point. |
| NOTE | Information — a steady level with nothing to judge against, a compressor or heater cycle, door openings that recovered in time. |
When a level is off, the finding suggests what to check — for CO₂, both the incubator's own sensor calibration and the reference meter's compensation settings; for temperature, a calibrated probe and the probe position.
Figures per channel
A table with, for each channel: the valid readings (set aside in brackets), the Steady level ± 95 % CI (the mean with the events left out), SD, set-point, Offset (steady level − set-point), time In range, min to max, Trend (per day, or over the log for short logs), Cycle (period and half-swing) and the number of events. With a set-point and limits, Steady level and Offset are shaded green (OK) or red (OUT OF LIMITS).
Comparisons
For each pair from Collate: A − B with its 95 % CI, the 5th–95th percentile range of the difference (reading-by-reading pairs), a test result (for example “p = 0.03” or “p < 0.001”) and whether it goes beyond the allowed difference.
Instrument check (optional)
Press Run the instrument check for the engineer's checks of the instrument kind chosen in Organise — for example storage excursions and defrost cycles for a freezer, door openings and recovery for an incubator, probe pairs at each hold for a thermal cycler, run speed and braking for a centrifuge, warm-up and stability for a light source, pulsation for a pump — run on the validated readings. Each log gets an overall result and up to eight findings, using the engineer's words:
| Word | Meaning |
|---|---|
| FAIL | Does not meet the check. |
| CHECK | Needs a closer look. |
| PASS | Meets the check. |
| INFO | For information. |
The check is off until you run it (or tick it in the report). Hide the instrument check hides it again.
Click ▸ How these figures are worked out (click again to hide it); it explains every method in a paragraph; the same text goes into the report.
12.10 Step 6 — Visualise
On the left, Show lists every channel (grouped by log, with its colour) with All and None. Options: Time of day (one clock) or Hours from each log's start (to lay logs from different days over each other), Show set-aside readings (grey) and Shade events.
| View | What it shows |
|---|---|
| Over time | The readings over time. Grey = set aside, amber = events, dotted = set-point, dashed red = limits. |
| Events overlaid | Every event from its own start (in minutes), as the change from the normal level. Where a line comes back inside the dotted threshold, conditions are back to normal — a quick way to compare recovery times. |
| Distributions | One box per channel: box = middle half, whiskers = 5th to 95th percentile, ◆ = steady level, dotted = set-point, red = limits. |
| Differences | A − B reading by reading for each comparison of logs taken at the same time. Dotted = no difference, dashed red = the allowed difference. |
Move the pointer over a chart to read every trace at that time. Wheel = zoom, drag = zoom to a stretch, double-click = everything. Copy picture copies the chart to paste into Word, PowerPoint or an e-mail; Save picture… saves it as a PNG.
12.11 Step 7 — Present
The report is written for someone who was not there: what was measured and how, what was set aside and why, the figures, the pictures and the conclusion. You fill in a few boxes; everything else comes from the steps before.
- Title (also the study's name) and Prepared by (your name and team).
- Purpose - the question this study answers, for example “Does freezer F-07 hold -20 °C from top to bottom?”
- Conclusion — your own words. Left empty, Kolate's summary is used; Start from Kolate's summary copies it into the box for you to edit.
- Include — tick boxes for each part: In short + findings, Data and methods, Validation, Figures per channel, Comparisons, Events, the four pictures, and Instrument check (the only one not ticked at first).
Share it
| Button | What it does |
|---|---|
| Open in my browser | Opens the report in your Windows default browser. To make a PDF, choose Print → Save as PDF there. |
| Save as web page… | Saves an .html file that opens in any browser (Word can open it too). |
| Save into Kolate | Saves the report as an HTML page entry in the current session, like Save CB (the session and title must be ready). |
| Copy report | To paste into Word, Outlook or Kolate. |
| Save the study | Saves the .kstudy file. |
The report holds, in order: the title and “Prepared by” line; In short; What the data shows; Purpose; Data and methods (logs, channels with their set-points, limits and event thresholds, your notes, how the figures are worked out); Validation (what was set aside, why, and whether Kolate's check or the analyst decided; anything flagged but kept); Figures per channel; Comparisons; Events; the pictures; the Conclusion; and the Instrument check if ticked. The footer states that the readings themselves were not changed.
12.12 A Worked Example — a −20 °C Freezer with Two Probes
The situation. A −20 °C freezer has no fan, so the air is not stirred and the top and bottom can sit at different temperatures. A logger with two probes ran for several days: Temperature 1 on the top shelf and Temperature 2 at the bottom. The question: does the freezer hold −20 °C, and how far apart are top and bottom?
- Import. Press Add log files… and choose the logger file (or drop it on the window). Check the card: the number of rows, the reading interval and the two channels.
- Organise. Check Kind is Freezer (-20 °C) — choose it first if Kolate guessed otherwise, because choosing a kind resets the limits. Each channel then has set-point −20 and limits −30 to −15 °C; change these if your own specification differs. Set Probe position to “top” for Temperature 1 and “bottom” for Temperature 2 (Kolate cannot tell this from those names). Fill in Instrument (with the asset number), Location and Notes (for example: no fan; probes on the top and bottom shelves; what was stored).
- Validate. Read what the checks found. If the first readings are flagged as settling (the probes cooling down after being put in), they are set aside — keep that ticked. If you know the door was opened to load samples, drag across that stretch and choose Door open / loading samples; for a defrost, Instrument maintenance or defrost.
- Collate. Kolate suggests comparing Temperature 1 with Temperature 2, reading by reading. If you have an acceptance figure for the top-to-bottom difference, type it in the ± box; otherwise leave it empty to describe the difference only.
- Analyse. Read In short and the findings: whether each probe holds its set-point, how much of the time it was in range, any compressor cycle, door openings and recovery, and how much warmer or colder the top is than the bottom. Use the Steady level ± 95 % CI and the Comparisons table for the numbers.
- Visualise. Over time shows both probes against the set-point and limits; Differences shows top minus bottom through the whole log; Distributions sets the two probes side by side.
- Present. Fill in Prepared by, the Purpose (“Is the −20 °C freezer without a fan even from top to bottom, and does it hold its set-point?”) and your Conclusion. Press Open in my browser to read it through, then Save into Kolate or Save as web page…, and Save the study so the work, with its data, can be reopened anywhere.
A CO₂ incubator, briefly
A CO₂ incubator is set to 37.0 °C and 5.0 % CO₂; its humidity is not controlled to a set-point but is usually above 90 %, and dips when the door is opened.
- Import the log with its temperature, CO₂ and humidity channels.
- Organise: choose the Kind Incubator (37 °C, CO₂). Temperature gets 37 (36.5 to 37.5) °C, CO₂ gets 5 (4.5 to 5.5) %, and humidity gets only a low limit of 85 %. Check that each channel's Measures and Unit are right.
- Validate: humidity often settles hours after temperature, so its settling stretch may be longer; readings just above 100 % RH at the start usually mean condensation on a cold probe and are set aside as impossible.
- Collate and Analyse: door openings appear as events where every channel dropped together. The finding says how many there were and how quickly conditions came back to normal, and flags LOOK if recovery took longer than 15 minutes or did not happen. If CO₂ runs off its set-point, check both the incubator's sensor and your reference meter's settings.
- Visualise: Events overlaid lays every door opening over the others so you can compare recovery times at a glance. To compare two incubators, import both logs and give them different Group names.
Part 13 — Reference
A quick-reference part: every keyboard shortcut, the mouse and gesture shortcuts, the full menu map, the format colour legend, and a glossary of the terms used throughout this manual.
13.1 Keyboard Shortcuts
Help ▸ Keyboard Shortcuts… shows the main shortcuts on one sheet inside Kolate (Esc closes it). The tables below are the complete list, grouped by where they work. Editor shortcuts do not act while you are typing in one of the editor's own boxes.
Everywhere in the main window
| Key | Action |
|---|---|
| Ctrl + K or Ctrl + Shift + P | Open the command palette — find and run any command by typing part of its name. Inside an RTF page Ctrl + K inserts a hyperlink instead, so use Ctrl + Shift + P there. |
| F1 | Open the User Guide, or bring it to the front if it is already open (Part 1 §1.5). |
| F9 | Switch OPEN mode between OPEN: Embedded and OPEN: External (Part 2 §2.9). |
| F11 | Step through the five VIEW states — VIEW 5/5 (everything), 1/5, 2/5, 3/5, 4/5 — the same as the VIEW button (Part 2 §2.11). |
| Alt + Page Up / Alt + Page Down | Show a newer / older archive set in the PSA grid. |
| Ctrl + B | In the Session box: insert the bullet separator “ • ”. |
| Enter | Commit the current field: in the Session box, start or resume the typed session; in the T box of MODIFY CURRENT ENTRY METADATA, the same as UPDATE PAGE; in the search Keyword box, run the search. |
| Esc | Close the title strip, the command palette or the shortcuts sheet. |
After a save — title strip and quick-name boxes
| Key | Action |
|---|---|
| Enter (in “3 Own title…”) | Apply your own title. Esc closes the strip and keeps the saved title. |
| Enter (in Summary) | Apply the summary. Shift + Enter starts a new line; Esc puts back the saved text. |
| Enter (WAV / MIDI quick-name box) | Keep the name typed for the tile just saved. |
| Enter / Esc (URL label box) | Keep the label / cancel it. |
Command palette, dialogs and message boxes
| Key | Action |
|---|---|
| ↑ / ↓, Enter, Esc | In the command palette: choose a command, run it, close the palette. |
| Enter | In a dialog or message box: the default button. |
| Esc | In a dialog or message box: Cancel (or No / OK). |
| Ctrl + C | In a message box: copy the message text. |
Text pages (TXT, RTF, HTML)
| Key | Action |
|---|---|
| Ctrl + Z / Ctrl + Y | Undo / Redo (TXT, RTF; Ctrl + Z also on HTML pages). |
| Ctrl + F / Ctrl + H | Find / Find and Replace (TXT, RTF). On HTML pages use the toolbar's Find and Replace buttons. |
| Ctrl + G | Go to a line number (TXT, RTF). |
| Enter (Find / Replace box) | Find Next / Replace. Esc closes the HTML Find & Replace bar. |
| Ctrl + B / I / U | Bold / Italic / Underline (RTF and HTML). |
RTF pages only
| Key | Action |
|---|---|
| Ctrl + Shift + = | Superscript. |
| Ctrl + = | Subscript. |
| Ctrl + L / E / R / J | Align left / centre / right / justified. |
| Ctrl + K (in the page) | Insert a hyperlink. |
PDF viewer and My dictionary
| Key | Action |
|---|---|
| Ctrl + F | Find text inside the PDF viewer (Part 4 §4.6). |
| Enter / Del | In My dictionary: add the typed word / remove the selected words (§11.8). |
Image editor (PNG, BMP, JPEG, GIF)
| Key | Action |
|---|---|
| Ctrl + Z / Ctrl + Y | Undo / Redo. |
| Ctrl + S | Save (overwrites the entry; the first original is kept). |
| Ctrl + C / X / V | Copy / Cut / Paste. |
| Ctrl + A | Select the whole picture (Select tool). |
| Del | Clear the selection (Select tool). |
| Enter | Place a pasted (floating) piece, or apply Resize while its panel is open. |
| Esc | Step back, one thing at a time: cancel the floating piece, close Resize, cancel Adjust, then drop the current tool. |
| Shift (while dragging) | Constrain Line, Rect and Ellipse. |
| Ctrl + mouse wheel | Zoom, 10 % to 3200 %. |
SVG editor
| Key | Action |
|---|---|
| V L R E P T | Select, Line, Rectangle, Ellipse, Pen, Text tool (when the drawing has focus). |
| Ctrl + Z | Undo. |
| Ctrl + Y or Ctrl + Shift + Z | Redo. |
| Ctrl + D | Duplicate the selected shape. |
| Del or Backspace | Delete the selected shape. |
| Arrow keys | Nudge 1 px (Shift + arrow = 10 px). |
| Esc | Deselect. |
| Ctrl + S | Save. |
| Ctrl + 0 / Ctrl + + / Ctrl + - | Fit / Zoom in / Zoom out. |
| Enter (Text tool) | Finish the text. |
Sound Studio
| Key | Action |
|---|---|
| Space | Play / pause (not while typing in a box). |
| Ctrl + S | Save the Studio's settings and close. |
| Ctrl + Z | Undo the last + Section, − Last or ● Marks → Sections (up to 30 steps; not while typing in a box). |
| Esc | Close without saving — the same as Cancel (Part 7B §7B.1). |
| Enter / Esc | In a name prompt (Save preset as, Name this tile before saving): OK / Cancel. |
Data tools (Part 12)
| Key | Action |
|---|---|
| Ctrl + O | Data Plotter: Browse… for a data file. Data Collation: open a study. |
| Ctrl + S | Data Plotter: Save Graph PNG…. Data Collation: save the study. |
| Ctrl + Shift + V | Data Plotter: Plot from Clipboard. |
| Ctrl + Page Down / Ctrl + Page Up | Data Collation: next step / previous step. |
Statistics has no keyboard shortcuts of its own.
Back to contents13.2 Mouse & Gesture Shortcuts
The mouse wheel — scrolls anywhere
| Gesture | Action |
|---|---|
| Mouse wheel anywhere in the deck | Scrolls the innermost area under the pointer that can still move up or down. At its end the wheel passes outwards (the page text, then the container…). Over parts that cannot scroll up or down, it moves the deck of containers sideways. |
| Shift + mouse wheel | The same, sideways. |
| Ctrl + mouse wheel | Zoom in previews and editors that zoom — the PDF / SVG viewer (Part 4 §4.6), the image and SVG editors. |
Main window
| Gesture | Action |
|---|---|
| Click a filled PSA slot | Recall that item instantly (Part 2 §2.6). |
| Click a card header | Open or close that card of the Control Panel; Kolate remembers which cards are open. |
| Right-click a tile's name | Rename the tile (Part 3 §3.6). |
| Double-click the activity counter | Reset that format's copy/action count (Part 2 §2.10). |
| Ctrl + click a colour swatch | Tick a whole colour group of tiles (Part 5 §5.2). |
| Point at a toast / click it | Hold it on screen / close it (§11.5). |
| Click the bell | Open this session's notifications; Ctrl or Shift + click picks several rows to clear. |
| Double-click a command in the palette | Run it. |
| Right-click a word with a red underline | Spelling suggestions, Add to my dictionary, Ignore on this page (TXT and RTF). |
Sound Studio
| Gesture | Action |
|---|---|
| Shift + drag on the waveform | Create a section (Part 7D §7D.3). |
| Click the waveform | Seek playback to that point (Part 7B §7B.8). |
| Drag a waveform handle | Set a trim or fade edge (Part 7B §7B.8). |
| Drag an EQ dot | Change a band's frequency and gain (Part 7C §7C.5). |
Editors and data tools
| Gesture | Action |
|---|---|
| SVG editor: Space + drag, or the middle button | Pan the drawing. |
| SVG editor: Shift while drawing or resizing | Snap a line to 45°, draw a square or circle, keep proportions. |
| SVG editor: Alt + click | Pick a shape inside a group. |
| Data Plotter: wheel / Shift + wheel | Zoom the X axis / the Y axis. |
| Data Plotter: left-drag / right-drag | Zoom to a box / pan. |
| Data Plotter: click / double-click | Copy that row / fit the whole graph. |
| Data Collation charts: wheel / drag / double-click | Zoom / zoom to a stretch (in Validate: select a stretch to set aside) / show the whole log. |
13.3 The Menu Map
| Menu | Items |
|---|---|
| File | Exit. |
| Tools ▸ Sessions | New Session… · Rename / Merge Sessions… (Part 3). |
| Tools ▸ Database | Database Status… · Cleanup Database… · Database Location… · Merge Database… · Start Fresh… (Part 3 §3.8–§3.10, §11.7, §11.9). |
| Tools ▸ My Profile | Export my profile… · Import a profile… · My dictionary… · Open the profile folder (§11.8). |
| Tools ▸ Protection | Protect the store (passphrase)… (§11.1). |
| Tools ▸ Output | Data Plotter… · Data Collation… · Statistics… (Part 12) · Print Page (A4)… (§10.4) · Multi-Copy (HUD)… (§10.5). |
| Tools ▸ Preferences | Setup Limits… · Toast Duration… · Production Mode (§11.3–§11.5). |
| View | Toggle Compact Mode (F11) — steps through the VIEW states · Theme ▸ Light / Dark · Notifications · Command Palette… (Ctrl+K). |
| Help | Kolate — Complete User Guide (F1) · Keyboard Shortcuts… · Command Palette… (Ctrl+K) · Enter Pass Code… (opens Kolate Activation, §11.2) · About Kolate (product name and version, 2.0.0). |
| Bell (right end of the menu row) | This session's notifications — the same list as View ▸ Notifications. |
Everyday actions live on the command bar and the format-container headers, not in the menus (Part 2). The command palette (Ctrl + K) finds any menu item or visible button by name.
Back to contents13.4 Format Colour Legend
Every format has one signature colour, used on tiles, grid slots and buttons throughout Kolate:
13.5 Glossary
- Session
- A named grouping of everything you save; Kolate shows one at a time (Part 3).
- Page
- A numbered slice of a session for one format; deleting one never leaves a gap (Part 3).
- Slot
- One of the 36 lettered positions (0–9, A–Z) on a PSA grid page (Part 2).
- Tile
- One item on a tiled page (a sound, a link, a MIDI), with its own controls (Parts 6–8).
- Clip / Entry
- A single saved item and its database row of metadata.
- Store (CIMAdb)
- The one portable folder holding the database and every copied file (Part 3).
- Save CB
- The action that captures the current clipboard content into the store (Part 2).
- Recall / Recall CB
- Putting a stored item back on the clipboard in its native form (Part 2).
- Round trip
- Kolate's core promise: a recalled item pastes identically to the original (Part 1).
- PSA grid
- The coloured Page/Slot/Assign shortcut grid above the format containers (Part 2).
- Format container
- A live preview for one format, with its own header and page pager (Part 2).
- VIEW states
- Five layouts of the main window, from everything (VIEW 5/5) to the deck alone; F11 steps through them (Part 2 §2.11).
- Theme
- Light or Dark colours for the whole application, chosen in View ▸ Theme; the change is instant and remembered (Part 2).
- Command palette
- A search box (Ctrl + K) that finds and runs any menu command or visible button by typing part of its name (Part 2).
- Toast
- A short message card at the bottom-right of the window that clears itself; up to three at once (§11.5).
- Notification bell
- The bell at the right end of the menu row; its red number counts unread messages, and clicking it lists this session's messages (Part 2 §2.12).
- SAVE NOTICE
- The coloured bar under Prev / Next that says why a save did or did not happen — for example a blocked duplicate (Part 2 §2.4).
- Title strip
- The small “Saved as:” strip that appears after a save, offering 1 your base title, 2 Kolate's suggestion, or 3 your own title, plus a summary to apply. It closes itself if left alone (Part 2 §2.4).
- Base title
- The title you set for the session (typed, picked, or given in New Session); Kolate joins it with its suggestion to make the saved title (Part 3 §3.7).
- Auto-title
- The title Kolate builds from your base title and a suggestion taken from the content; you can change it in the title strip (Part 3 §3.7).
- Friendly name
- The readable name shown on screen instead of the internal file identifier (Part 3).
- New Pg
- The button that adds the next page of a format — a blank text page, or a blank picture on picture pages (Part 4).
- Image editor / SVG editor
- Kolate's own editors for pictures (PNG, BMP, JPEG, GIF) and SVG drawings, opened with Edit; they save with their own Save button (Part 4).
- Original
- The picture or SVG as it was first saved; Kolate keeps it so Original / Restore original can put it back after any edit (Part 4).
- Undo
- Reverses recent changes: Ctrl + Z on text pages and in the image and SVG editors; in the Sound Studio, ↶ Undo (or Ctrl + Z) reverses section and mark changes, and ↶ Undo reset brings back settings after Reset defaults (Parts 4 and 7).
- My dictionary
- Your own list of words the spell checker accepts on TXT and RTF pages; kept in your profile (§11.8).
- My Profile
- Your personal settings — last colours, remembered printers, New Pg picture size, My dictionary — kept on this computer outside the database, with Export and Import (§11.8).
- Classification
- A named group you assign to tiles; what Generate Page builds from (Part 5).
- Colour skin
- A colour tint applied to tiles that travels with the item (Part 5).
- Generate Page
- Building a self-contained, portable page from a classification (Part 5).
- Zone
- A labelled, framed group of controls on the WAV / MP3 and MIDI page toolbars (for example ▶ PLAY, 🎚 MIX, 🏷 ORGANISE); the ? button explains each zone (Parts 7A and 8).
- Inspector
- A window for managing items across every page at once, opened from the command bar for the maximised format (Part 9).
- Sound Studio
- The per-tile, non-destructive audio editor (Part 7).
- Adjustment point
- A marked spot in a sound to return to, with optional notes (Part 7D).
- Section
- A named region of a sound you can loop, edit and export (Part 7D).
- Preset
- A saved, named set of Sound Studio settings, shared across tiles (Part 7B).
- Dynamic / Static mode
- Whether the Studio re-renders on every change or on demand (Part 7B).
- Data Plotter
- The tool that graphs logger data files or a pasted table (Part 12).
- Statistics
- The tool that summarises a table — mean, median, spread, percentiles and charts — with every result explained in plain words (Part 12).
- Data Collation
- The step-by-step tool that brings time-based logger records together — import, organise, validate, collate, analyse, visualise and present them as a report (Part 12).
- Study (.kstudy)
- A Data Collation file holding the whole study, including a copy of every log's data, so it opens the same way on another PC (Part 12).
- Passphrase / Recovery key
- The secret that unlocks an encrypted store, and the one-time key that opens it if the passphrase is forgotten (§11.1).
- Registered / Unregistered
- The activated and free editions of Kolate (Part 1 §1.4, §11.2).
- Kolate Identifier
- The one line in the Kolate Activation window — your User Id and support token — that you send to support to request a licence (§11.2).
- Licence (.kolatelic)
- What the publisher sends back to activate this computer: a long code and/or a
.kolatelicfile. A Kolate 1 passcode is not a licence (§11.2).