User manual
Scratch
Generated from the capability catalog.
1. Temporary notes
Scratch keeps a short stack of temporary notes, called slips. Open it, type, leave. Keep anything important somewhere else.


2. Slips
Notes live as files in a folder. The default folder is notes under the app's local directory. Options > Notes folder shows the folder, and Change points it somewhere else, such as a synced folder. A slip is a note Scratch keeps in that folder. Its file name is a date stamp, yyyy_mm_dd_, followed by a short form of its first line: A to Z become lowercase, a to z and 0 to 9 stay, a run of spaces, tabs, hyphens, or _ characters becomes one _, and every other character is dropped, including accented letters and other non-ASCII text. The short form stops when it reaches 40 bytes, and a trailing _ is trimmed. Every character it keeps is one byte, so that is also 40 characters. A first line of Trip to Oslo, 2026! gives trip_to_oslo_2026. A slip whose first line has none of those characters is named note, and a name already in use gets _2, _3, and so on. A file you open from somewhere else stays where it is. A slip holds 64 KB, and the stack holds 48 with the newest on top. When another slip will not fit, Scratch names the oldest slip that is not kept and asks to pack it. The empty page is not that slip. If every slip is kept, Scratch says so and packs nothing. Packing it runs the action that needed the room.


3. Notes folder for one note
From a command line, scratch -new -notes:<dir> makes the note in that folder instead and prints ok new with the slip's name. Without -new, Scratch ignores -notes: and uses the folder set in Options.
4. The stack
Ctrl+N makes a note. From a command line, scratch -new makes that same note and exits. New from clipboard, on the File menu, puts the clipboard text on top of the stack and leaves the open page alone. An empty clipboard does nothing. Duplicate copies the open page into a new slip and selects that copy. An opened file is copied into a slip and the file stays as it is. An empty page is left alone. The empty page stays at the top of the Active list. A full stack stays full. Alt+Up and Alt+Down move through the stack. New window opens another view of the same stack. File has New note, New from clipboard, Duplicate, New window, Save, Archive, Delete, Save as, Options, User manual, and Quit.


5. Save and close keys
Ctrl+S saves the note, and Ctrl+W archives it. The File menu shows both keys, beside Save and Archive.


6. Saving
Scratch writes a slip to its file as you type, so a slip never needs Ctrl+S. The status bar says Slip. Edits to an opened file go to a separate dlt_ file in the notes folder, and the file itself changes only when you save it. The status bar says File, and the row says Edited while that dlt_ is there. Scratch keeps those edits for the next time you open the file. A slip does not grow a Saved badge.


7. Archive
Archive on the File menu or a slip's context menu packs that slip into Archive. Delete removes the slip's file. Archiving an opened file takes it off the list and leaves the file on disk as it was.
8. Sidebar
The sidebar has two panes: Active notes on top and Archive at the bottom, each with its own scroll bar. Archive starts as one toolbar row at the bottom; opening it expands to about half the sidebar (drag the splitter to resize; Scratch remembers the height). Year and month groups inside Archive start closed. Click an Archive row to view it; the packed copy stays until you edit. Age uses the file's last edit time. Right-click an Active slip for Archive and Delete. Opened system files leave the sidebar without entering Archive. The hide button is on the sidebar header; when the list is closed, Show sidebar is on the title bar.


9. Open a file
Drop a text file on the window to read it in place, at any size; Scratch maps it straight from disk. Drop a page from the internet, or a small file from a temporary folder, and Scratch keeps a dated copy. A temporary file larger than a slip is copied onto disk and opened the same mapped way. Binary samples open as hex.




10. Drop a link
Drop a web link, or a .url shortcut, and Scratch downloads the page into a new slip if the page is text. The slip is named from the last part of the address, or page when the address ends in a slash.
11. Lock a file
An opened file can be locked from its menu. A locked file ignores typing, but you can still move around in it, and it still reloads when the file changes on disk. Scratch remembers the lock.


12. When a file changes on disk
An opened file reloads when it changes on disk. If you have unsaved edits, Scratch keeps your copy and says The file changed on disk., with Use the file, Keep mine, and Diff.
13. Overwrite and discard warnings
Options > Files has Warn before overwriting a file and Warn before discarding edits, both on at first. With them on, Save on an opened file first asks Overwrite file, and closing an opened file with unsaved edits first asks Discard edits. Cancel leaves everything as it was.




14. Hex inspector
A binary file opens as hex, with its bytes as text beside each row. Click a line number to select that row. When a format description matches the file, its fields are underlined, sections fold behind an arrow, and a strip under the hex names the field at the cursor with its type and value. Click a value in that strip to select that many bytes.


15. Descriptions
Options > Descriptions has Update, which downloads the format descriptions the hex inspector uses. Scratch downloads them only when you ask: with Update here, or with Download on the Hex parsing notice. A failed update leaves the current files.


16. Status bar
The status bar says Slip or File for the open page. The Show whitespace button draws spaces and tabs. The rest of the bar shows the number of lines, the size, and the cursor's line, column, and byte offset. Hover the size to see the exact count of bytes, and click it to copy that count. Click a line number to select that line. Each line number is preceded by that line's byte offset in hex (0x). The offset and number of the line you are on stand out, and the others are dimmed.




17. Dev meter
Options > Status bar has Dev meter, off at first. Turn it on to put frame meters on the status bar. The status bar itself is always shown.


18. Status grid
Click the frame meters to open the status grid β the same shell View uses. Meter columns, Session statistics, Debug UI, and Display (backend and VSync). The title bar reads Status grid with the build line; the X closes it.
19. Typing aids
Next to Show whitespace, the status bar has Virtual newline, Smart indent, and Smart spread; a lit button means that aid is on. Virtual newline, on at first, wraps long lines at the edge of the window. Smart indent, off at first, indents rows that sit inside brackets. Smart spread, off at first, starts a new row after an opening bracket and after each comma inside brackets, and gives the closing bracket its own row; text in quotes stays together. All three change only how the text is shown; the file stays as it is.




20. Find in a note
Ctrl+F opens find in the message bar at the bottom left, already filled in with find. Type a word after it, and Scratch selects the next match in the open note. Esc closes find. Clicking the message bar and typing find and a word does the same. Find in notes, on the File menu, is separate. It searches every slip on the stack and every slip in compost, including a compressed .ncmp. A result shows the title, the date, and the line around the word, and a packed slip is marked. Opening a result selects that slip and the match. Opening a packed result puts the slip back on the stack first. A file that is not text is skipped. Ctrl+F stays on the open note.


21. Open in...
Right-click the text, a selection, the hex, or a slip in the list. The menu matches that surface. A selection offers Cut, Copy, Paste, and Select all. Hex offers Copy value when a field is under the pointer, and Copy bytes. A slip in the list offers Archive and Delete. Archive packs the slip; Delete removes its file. Open in... is on each of those menus. Paste in the text stays paste into that page.
22. Archive
Once a day, Active slips older than the Active age in Options (two weeks by default) are packed into archive and taken out of the Active list. Keep on a slip holds that slip out of this pack. The row says Kept, and clicking Kept takes the mark off. Keep holds 8 slips. The mark is a keep line in the recent index, not text in the slip. Archive still packs a kept slip; Delete removes the file. Archive files live in a compost folder inside the notes folder. Each packed slip is a compressed .ncmp file in compost/yyyy_mm, where yyyy_mm comes from the slip's own name. A slip file that is larger than 64 KB on disk, such as a big file dropped from a temporary folder, is moved there as it is, without packing.
23. Getting a slip back
Archive packs a slip into the Archive section. Delete removes the file. Archive is foldable in the sidebar, grouped by year and month. Open a row there and the slip comes back into the Active list. For a few seconds, Undo on the status bar does the same thing. The packed file is removed only after that write succeeds. A full stack stays full, and the packed file stays where it is.
24. Theme
Under Options > Theme, System follows the OS, and Inverse flips light and dark, so pick Inverse for a dark Scratch on a light desktop. Color scheme picks the palette.


25. Hints
Scratch has a single one-time notice, Hex parsing, which offers the descriptions the first time a hex view opens without them. Options > Hints > Reset brings it back, and Scratch confirms with Notices reset.


26. Window
The window remembers where you left it. New window opens another view of the same stack.
27. Column guides
A column ruler sits above the text. A first install starts with one guide at column 80. Drag the guide button out across the columns to drop a guide, and drag a guide's cap to move it. Hover the button to remove a guide. The same ruler sits on the hex bytes. The columns live in the app config, not in the slip. The line-number gutter still selects the line.
28. Third-party notices
File > Licenses lists the third-party code compiled into this copy of Scratch, and shows each license. Product activation is separate (File > Licensed to⦠/ Activate). Libraries this copy does not compile are not in the list.
29. Self-test
From a command line, scratch -self-test (or --self-test) runs Scratch's own checks on test files in the program's folder, then exits. The exit code is 0 when every check passes and 1 when any fails, and each failed check is logged by name.
30. Scratch Pro
Scratch Pro is a perpetual license for one user. Save the license file as local/entitlement.lic beside Scratch (or paste / choose it on Activate). Until Scratch finds a valid license there, it stays on the Activate screen. File > Version checks for updates; Recover License on the site emails licenses bought with your address.