Repository navigation
Testing the beta
Agents only started the exe and opened each main entry point once. Everything below is untested by hand. Tick each step; when one fails, stop that section, report it (see "Reporting a failure"), and go on to the next section.
Your real notes stay safe if you do this every time you test beta 4:
-
Make a test folder and copy the exe into it (setup's Start menu option moves the file it was started from):
$t = "$env:TEMP\OpenNote-beta4-test"; New-Item -ItemType Directory -Force $t | Out-Null Copy-Item "$HOME\Downloads\OpenNote_Windows64.exe" $t $env:OPENNOTE_PROFILE_DIR = $t; & "$t\OpenNote_Windows64.exe"
-
Windows SmartScreen warns (the exe is unsigned): choose More info, then Run anyway.
-
In setup, keep the proposed notes folder. With
OPENNOTE_PROFILE_DIRset it is inside the test folder (...\OpenNote-beta4-test\Documents\OpenNote), never your real Documents. Settings, caches, and the log are in...\OpenNote-beta4-test\localand...\roaming. -
To start again from nothing: quit OpenNote and delete
%TEMP%\OpenNote-beta4-test. -
Always start the test copy from a PowerShell window where
$env:OPENNOTE_PROFILE_DIRis set (step 1's last line).
- The log:
%LOCALAPPDATA%\OpenNote\logs\opennote.logfor a normal run; for the test profile it is%TEMP%\OpenNote-beta4-test\local\logs\opennote.log. Attach it. - In the app: Help > Send feedback (or Ctrl+K, type "feedback"). It builds a file with the log and a self-check, with note titles removed; save it and attach it.
- Say which step number failed, what you did, what you expected, and what happened. A screenshot helps.
- Finish setup. A notebook, a section, and a page appear. The status reads "Saved".
- Type a heading, a bulleted list, a paragraph with bold (Ctrl+B), and a checklist item. Wait for "Saved".
- Make a second page (New page in the page list, or Ctrl+N). Check the new page shows only the title and a gray "Changed ..." subtitle under it, and no separate date text box on the page.
- Rename the first page in the page list (F2). The big heading changes to match. Type in the heading: the list name changes.
- Close the window (Alt+F4) right after typing a few more words, without waiting.
- Start the test copy again. Both pages, the rename, and every word you typed (including the last ones) are there.
- Delete a page (right-click > Delete), open Trash (bottom of the notebook list), choose Restore. It is back.
- Open the notes folder in File Explorer: one folder per notebook, with
page.mdfiles you can read.
- Open the Draw tab. Pick a pen. Rest the side of your hand on the screen and write a line with the Surface Pen. Only the pen writes; your palm leaves no marks and does not scroll or select.
- Write fast and slowly; the line follows the pen with no gaps and pressure changes the thickness.
- Lift your hand, touch the page with one finger: it scrolls (it does not draw unless touch drawing is on).
- Use the pen's eraser end (or the Eraser tool): stroke eraser removes whole strokes; partial eraser cuts strokes.
- Lasso a few strokes, move them, then Ctrl+Z and Ctrl+Y. Undo and redo put them back and forward.
- Draw a rough rectangle and hold the pen still at the end: it becomes a clean shape.
- Close and restart: the ink is still there in the same place.
- On a page with text, a picture, and ink, open Share > Export... (or Ctrl+K, "export").
- Export as PDF (from the page's Export / Print): the PDF opens, has the text (you can select it), the ink, and the picture, at the right page size.
- Export the page as Markdown, as Word (.docx) and as single-file HTML. Open each file; text, headings, and pictures are there. (The PDF choice in the Import/Export dialog's format list is hidden on purpose in this build.)
- Print (Ctrl+P): the print preview shows the page as it looks on screen.
- Ctrl+K, "Start recording" (or the Record button). Allow the microphone if Windows asks.
- Speak and type notes for 30 seconds, then stop. A recording block appears on the page.
- Play it: you hear yourself. Tap a word you typed during the recording: playback jumps to that moment.
- Trim the start of the recording; play again.
- Close the app while a second recording is running. Restart: the app offers to recover it, and it plays.
- Resize the window from wide to narrow and back. The panes follow, nothing is cut off, and no horizontal scroll bar appears under the page.
- Drag each pane splitter (notebook list, page list) left and right. The page area follows. Restart: the widths stay.
- Ctrl+K opens the command palette; type "settings" and press Enter. Settings opens. Escape closes it.
- Zoom with Ctrl+= and Ctrl+-; Ctrl+0 resets.
- Snap the window to half the screen (Win+Left). The layout switches to the compact one without overlapping parts.
Quality-of-life features in this build (shell lane):
- Select several pages: Ctrl+click two pages in the list. Delete or move them together.
- Pin, sort, duplicate, copy, and archive: right-click a page, choose Pin; it moves to the top. Try Duplicate, Copy to..., Archive, and the Sort menu above the page list.
- Tabs and windows: middle-click (or right-click > Open in new tab) a page. Ctrl+Tab switches tabs. Close one with Ctrl+W and reopen it with Ctrl+Shift+T.
- Focus mode (Ctrl+K, "Focus mode"): the panes hide; Escape brings them back.
- Window modes: Ctrl+K, "Mini window" (stays on top) and "Dock" (to a screen edge).
- Quick capture: Ctrl+K, "Quick capture": a small window; type a note and save it; it lands in the notebook.
- Home page: Ctrl+K, "Home": recent and pinned pages.
- Scheduled backups: Settings > Backups (or Ctrl+K "backup"): set a schedule, run one now, find the backup file.
- Edits from other apps: edit a page's
page.mdin Notepad and save; the page in OpenNote updates (or offers a side-by-side conflict if you edited the same page in both). - Open a notebook from any folder: Ctrl+K, "Open notebook folder", pick a folder elsewhere.
- Check notebook: Ctrl+K, "Check notebook": it reports no problems on a healthy notebook.
- Low-power mode, page shortcuts, and jump list, OneNote shortcut set, accessibility checker: each is in Ctrl+K by name; open each once.
- Portable mode: put an empty file named
portablenext to the exe and start it (withoutOPENNOTE_PROFILE_DIR): settings and caches go beside the program. (Delete that file afterwards.) - The tree Sort menu was stopped mid-feature: check it does not break the tree.
- Copy the whole test notes folder somewhere else, start a second throwaway profile pointed at the copy (setup's "choose folder"): the notebooks and pages are all there.
- Open the same page in two tabs or windows and type in one: the other updates.
- Page history: right-click a page > Page history. Restore an older version.
- Make a section group and move a section into it; move a page to another notebook (drag, or right-click > Move).
- Type
/on an empty line: the slash menu opens; insert a table, a code block, a callout, a divider, a date. - Headings (Ctrl+Alt+1, 2, 3), lists, checklist, quote, code with highlighting, links (Ctrl+K inside text if offered, or the Insert tab).
- Paste a picture and text from a web page. Paste a screenshot (Win+Shift+S then Ctrl+V).
- Spell check marks a misspelled word; right-click offers fixes.
- Fold a heading's outline (the arrow beside it) and unfold it.
- Read aloud: select text, Ctrl+K "Read aloud".
Quality-of-life features (typed-notes lane):
- Reading lock: Ctrl+K "Lock page": typing and ink are blocked until you unlock.
- Word count and reading time: shown in the status bar or Ctrl+K "Word count".
- Find on page (Ctrl+F) and Replace (Ctrl+H).
- Table of contents pane: Ctrl+K "Contents": it lists headings; click one to jump.
- Checklist extras: Ctrl+Enter toggles an item; "Check all"; finished items move down; counts show.
- Caret extras: Settings > Typing: thicker caret, typewriter scrolling (off by default), screenshot paste size.
- Page templates and series pages: New page from a template; "Next in series" makes the next numbered page.
- Alt text draft: right-click a picture with text in it > Alt text: a first draft is filled in.
- Extract, merge, and split pages: select blocks > "Extract to new page"; select two pages > "Merge".
- Wrap text around images in flow pages: picture > Wrap > Left/Right.
- Attachments that save back: drop a .docx on a page, open it, edit it in Word, and save; the page's copy updates.
- Drag and drop files, PDFs and links onto a page.
- Markdown source view: Ctrl+K "Markdown source": edit the source; the page updates.
- Page embeds: type
![[and pick a page: its content shows inline. - Link titles on paste: paste a web address; it becomes the page's title (Settings > Privacy lists the sites asked).
- Try the highlighter, each pen color and width, and the ink color in dark mode.
- Shapes: line, arrow, circle; with shape snapping off they stay freehand.
- Ink on top of typed text, scrolling with the page.
- Docs:
docs/testing/palm-rejection.mdin the repository has the full palm test.
Quality-of-life features (ink lane):
- Eraser and lasso filters (erase only highlighter, select only ink); pen hover circle shows where the pen will write; canvas lock; Describe drawing (alt text for ink).
- Pen gestures: scribble over words to erase; circle then tap to select; two-finger double tap undoes, three-finger double tap redoes. Per-pen buttons, pressure curves, and the steady pen in Settings > Pen and touch.
- Insert space tool: drag down to push everything below further down. Ruler, protractor, snap to grid.
- More shapes: polygon, star, arc, curved, and double arrows; hold then reshape.
- Shape handles, attached connectors (move a shape, the arrow follows), shape libraries, text in shapes.
- Ink replay: Ctrl+K "Replay ink": a play bar with a slider and speeds; with a recording, audio plays along.
- Handwriting tools: lasso handwriting > Convert to text, Straighten, Even spacing; the writing pen converts as you write.
- Draw a grid with the pen: it becomes a table. Pen editing of typed text: strike through a typed word to delete it.
- Zoom writing box: Ctrl+K "Zoom writing box": write big, it lands small on the line.
- Ink stays with its text: write beside a word, then add text before it: the ink follows the word.
- View > Page view: switch between flow, paginated (Letter/A4), and infinite canvas.
- Paper: View > Paper > Lined. Type three lines: each line of text sits on a rule, with no rule cutting through text. Try Grid and Dotted too.
Your requests in this build (owner fixes):
- New page: only the title and the gray "Changed ..." subtitle; no date text box. "Next in series" pages too.
- Lined paper: body text, a heading, a bulleted list, and a checklist each sit on the rules. Change the line spacing (View > Paper > spacing): the text follows the new rules.
- Text boxes on lined paper: click on the canvas to make a text box, type two lines, drag it up, and down: it moves rule to rule and its text stays on the rules. Nudge it with the arrow keys: one rule per press. Drag its width handle narrower: the text rewraps and the box grows by whole rules.
- Print or export the lined page as PDF: the text sits on the rules there too (only checked in code, not printed).
- Resizing: drag both pane splitters, then make the window narrow (half the screen) and wide again: the page area shrinks and grows with it, with no sideways scrolling into an empty strip.
- Present as slides (Ctrl+K "Present"): arrow keys move; Escape ends.
- Gallery view of a section, reading aids (line focus, colors), the immersive reader.
Quality-of-life features (pages lane):
- Layout presets: lab notebook, planner, storyboard, custom line spacing; set one as the notebook default; save a layout.
- Sheet navigator: in the paginated view, the strip of sheets at the side; click to jump.
- Accessible PDF export: tags, a language, and bookmarks from the headings (check in a PDF reader's bookmarks pane).
- Elements library: select something > Save as element; insert it from the Elements pane.
- Lasso selection: Export or copy as PDF, PNG, SVG, Word, or an image.
- Present a whole page with a laser pointer (hold the pen button) and ink that fades.
- Syllable marks in the reading view.
- Insert > Smart table. Add columns of type number, date, choice; sort and filter.
- Insert a chart from the table; change its type; edit a number: the chart updates.
Quality-of-life features (tables lane):
- Calculated columns: add a column with a formula (
=Price * Qty). - Board, calendar, gallery, and timeline views of a smart table.
- Accessible charts: Tab to a chart; a screen reader (Narrator, Win+Ctrl+Enter) reads its summary; there is a data table.
- Ctrl+Shift+F: search panel. A word typed a minute ago is found;
in:limits to a notebook. - Ctrl+K quick switcher: type part of a page name, Enter opens it.
- Type
[[and pick a page: a link. Open the target page: its Backlinks list shows the first page. - Tags: type
#todo; the tag is listed and searchable.
Quality-of-life features (search lane):
- Paragraph links (right-click a paragraph > Copy link) and
opennote://links from another app. - Line tags and the Tags pane.
- Daily note (Ctrl+K "Daily note") and the daily notes calendar.
- Replace across notebooks (Ctrl+K "Replace in all notebooks"): preview, then replace.
- Text read from pictures shows up in search (paste a screenshot with words, wait a minute, search a word in it).
- Page properties, collections, graph view, and the Connections list, the canvas of cards.
- Some of this lane was stopped mid-feature: report anything half-done.
- Record system audio (play a video while recording with "Include computer audio").
- Flags on the timeline (mark a moment while recording).
Quality-of-life features (audio lane):
- Tap a stamped word with the pen or a finger: that moment plays.
- Settings > Recording section.
- Split a recording; remove an off-the-record part; voice enhancement; export a recording as audio.
- Recording storage list: compress one, remove the audio but keep the transcript.
- Meeting prompt: start a Teams or Zoom call: OpenNote offers to record.
- Snap the screen while recording; drop an audio or video file on a page: it becomes a recording.
- Transcripts: transcript block, speakers (rename one), lines to notes, action items, chapters, copy meeting recap.
- Type
$x^2$(or Insert > Math): it renders. Edit it. - Insert > Graph: plot
y = sin(x); pan and zoom. - Math actions: select an equation > Solve / Simplify.
Quality-of-life features (math lane):
- Quick math: type
12*7=in text: the answer appears. - Math on page lines with variables and units; "Graph this".
- Mind maps (turn an outline into a map and back) and diagrams from Mermaid text.
- Flashcards: Insert > Flashcards; card types (fill in the blank, multiple choice, image occlusion); inline
cards (
Q :: A,{{blank}}); review them; set an exam date. - Anki: import an
.apkgdeck and export one; CSV import and export. - Study tape: cover part of a page; press it to show.
- Unit converter and reference tables tools (Ctrl+K "Unit converter", "Reference tables"): open as tool windows.
- Upcoming: exams, classes (import a calendar
.icsfile), repeating to-dos, due date chips on checkboxes, reminders with a Windows notification. - Citation helper: BibTeX, RIS, and Zotero.
- Timers, Calculator: tool windows open, work, and close.
- Ctrl+K "Import": import an Obsidian vault or a folder of Markdown files; the notebook appears with its pages.
- Import a Word file; export a section as Markdown.
Quality-of-life features (import lane):
- Import .odt, .xlsx (as table pages), .pptx (one page per slide), .eml (with attachments), Kindle clippings
(
My Clippings.txt) and Readwise CSV. - Export tables as .xlsx and .csv; export pages as a PowerPoint file.
- Read pictures from Windows Sticky Notes.
- Import dialog: Save report button.
- The Import step in first-run setup (start with a fresh test folder to see it).
- Snipping Tool: take a screenshot with Win+Shift+S: OpenNote offers to add it to the open page.
- Send copies to favorite folders, then "Update the copy" after editing.
- Share as a file was stopped mid-feature: try it once and report what happens.
Each feature is off until you turn it on in Settings > Privacy and smart features.
- Text in pictures (OCR): turn it on; right-click a picture > Copy text from picture.
- Read aloud with Windows voices; summaries of a page.
- Handwriting to text: write a word, lasso it, Convert to text.
Quality-of-life features (intel lane):
- Model downloads with consent: the app asks before downloading; Settings lists models and their sizes.
- Smart features step in first-run setup.
- Background work controls: the activity panel; new pictures are read in the background.
- Tidy handwriting and review unsure words.
- Custom transcript vocabulary per notebook.
- Search by meaning and a Related pages list.
- Ask your notes (Ctrl+K "Ask"): the answer lists the pages it used.
- Writing tools: select text > proofread, rewrite, shorten, make a list, tidy.
- Settings > Privacy: Work offline: on, then Help > Check for updates says it is offline.
- Help > Check OpenNote (self-check): all checks pass.
- Help > Send feedback: save the file; open it; no note titles or text in it.
- Crash reports: Settings > Privacy > Crash reports: the consent screen; "Show an example".
- Safe start: the offer appears only after two crashes in a row (hard to test by hand; skip unless it happens).
- Setup's look step: choose each look; the app's colors, paper, and drawings change.
- Light and dark (Settings > Appearance): every pane, menu, and dialog is readable in both.
- The empty states (no notebook, empty section, empty search) show the drawings.
The build ships with no client IDs, so Microsoft, Google, Slack, Dropbox, Box, and Vimeo say "Needs setup" until you
add your own app registrations (docs/CONNECTORS.md says where to register and how: a connectors.json file in the
data folder, which for the test profile is %TEMP%\OpenNote-beta4-test\local). Readwise, Canvas, and Moodle take a
personal token and work without setup.
- Settings (Ctrl+,) > Connectors: the page opens with a card per service; the six above say "Needs setup".
- Readwise: choose Connect, paste your Readwise access token: the card shows your account as connected.
- Restart: it is still connected. Open Windows Credential Manager > Windows Credentials: an entry named
OpenNote/readwise/...holds the token; no file in the test folder contains it. - Settings > Privacy: Work offline on, then try Connect on a card: it is refused while offline. Turn it off.
- Disconnect: the card shows not connected and the Credential Manager entry is gone.
- Help > Send feedback: save the file and search it for your token: it is not there.
- Add a
connectors.jsonwith a Microsoft or Google client ID: the card changes to Connect without a restart. Connect opens the sign-in page in your default browser, never inside the app. After sign-in, the browser tab says it can be closed, and the card shows your account.
OpenNote is licensed under the Apache License 2.0. Repository | Issues | Releases
- Getting started
- Installing and updating
- Where your notes are stored and how they stay safe
- Notebooks, sections, and pages
- Typed notes
- Ink and drawing
- Audio recording
- Math and study tools
- Productivity and study tools
- Tables and charts
- Search and links
- Page views, printing, and PDF
- Import and export
- On-device intelligence
- Settings and Connectors
- Keyboard shortcuts
- Accessibility
- Privacy and your data
- Troubleshooting
- FAQ