Skip to content

Openote 1.0.1

Choose a tag to compare

@github-actions github-actions released this 01 Oct 10:33
· 179 commits to master since this release

What's new

  • A table sits in your writing now, and you type in it where it sits.
  • Bold stays bold when you press space, and the asterisks stay hidden.
  • Drag a page onto the page you are writing for a live window onto it.
  • Links live in your words, and Ctrl+K puts one on what you selected.
  • Straight lines and shapes for the pen, which makes a trackpad usable.
  • Fold the section list away when you want the room for the page.
  • Pen sizes are four dots instead of a slider you had to aim.

All of it, in more detail

Tables moved into your writing. A table used to be a box of its own that
sat beside the sentence it belonged to. Now it lives in the paragraph: you
type a word, press Tab, and it becomes the first cell. Tab again adds a
column, Enter starts a row, and the caret stays where you put it. Your
existing tables convert as you open each page, keeping their contents and the
width they had. To format text inside a cell, type the Markdown for it: the
toolbar buttons act on the sentence around the table rather than on the
cell, so they stand down while you are in one.

The markup stops showing itself. Three things you could do by accident
and see asterisks for:

  • Bolding a word and pressing space printed the markers around it, because
    a marker may not sit against a space. The space steps outside the run
    now, and the bold carries on into the next word.
  • Selecting a bold word and deleting it left half its markers behind. All of it goes now.
  • Ctrl+Z in a table cell removed the whole table. It takes back what you
    typed, then the row or column you made, and never the table itself.

Links read as their words. Clicking into a sentence used to unfold
[the docs](https://…/a/long/path) in the middle of it. A link now behaves
like everything else in a note: bold stays bold, an equation stays an
equation, and a link stays its words. Ctrl+K puts one on what you selected
or on the word you are touching, and Ctrl+K inside a link edits it.

Windows onto other pages. Drag a page out of the list and onto the page
you are writing, and you get a live window onto it. Right-click to swap it
for a plain page link, or right-click a page link to swap it the other way —
they are the same thing at two sizes, and which one you want is usually only
clear once you can see it.

Shapes for the pen. Pick Line, Arrow, Rectangle, Ellipse or Triangle on
the Draw tab and the stroke comes out straight. A shape is ink: it takes your
colour, size and opacity, both erasers rub it out, the lasso picks it up and
undo undoes it. Drawing a diagram with a trackpad is the difference between a
diagram and a mess, and most people using Openote are on a school laptop.

The navigator does what you drag. Fold the section list away when you
want the width for the page. Groups and pages you closed stay closed when you
come back. Dropping a page or a section into the space below the list moves
it to the bottom, which is where a hand overshooting a short list lands.

Smaller things that add up.

  • Insert puts a new block under the box you were last writing in, not in the
    middle of the screen — and a new code block opens in the language you last
    chose.
  • Clicking out of a box onto the page opens the next box straight away,
    rather than taking two clicks.
  • Pen thickness is four dots drawn at the size they set, with anything in
    between behind the ⚙ — which now goes up to 40 and shows the dot it will
    draw, in the colour it will draw it.
  • Comments in a code block are green, as they are in almost every editor.
  • A picture that was still syncing appears when it lands, and you can
    right-click any picture to save a copy of it.
  • Point a notebook at its own SSH key, alongside its remote.
  • Pressing Enter in an empty note no longer throws.
  • Deleting a page leaves you on the page next door; deleting a section is one
    Ctrl+Z away from coming back.

Before you update

Your existing tables are converted as you open each page. The conversion
proves itself before it writes: the table is read back out and compared cell
for cell, and anything less than identical is left exactly as it was. A table
it declines goes on working as a table. Nothing is converted in a notebook
that is read-only or still catching up with another device.

For the technically curious

A table in a sentence is an inline atom: the paragraph holds a CommonMark
reference, ![2x3 table](onote://atom/<id>), and the payload lives beside it
in the same block. A reader that has never heard of Openote sees the alt
text rather than a syntax error, and a build too old to draw one says which
version made it instead of overwriting it.

The caret arithmetic is the interesting part. An atom is drawn as one
zero-width placeholder standing for its first character, with the rest of the
reference laid out at a hair's width — so the number of code units the caret
walks is exactly the number in the source, and every offset in the paragraph
still means what it says.

3,580 automated tests run on every push.

Downloads

  • Windows: openote-*-windows-x64-setup.exe — the installer.
    Installs for your user only, so it never asks for an
    administrator password. (Prefer no installer? The
    …-windows-x64.zip is the same build — unzip it anywhere and run
    openote.exe from inside the folder it extracts.)
  • Linux: openote-*-linux-amd64.deb on Ubuntu/Debian/Mint, or
    openote-*-linux-x86_64.rpm on Fedora/RHEL/openSUSE. Double-click
    it, or install from a terminal — then Openote is in your
    applications menu like any other program. To open a notebook from
    your file manager, double-click the Open this notebook file
    inside the notebook's folder; whether double-clicking the folder
    itself opens Openote depends on which file manager you use.
    (Neither package fits? The .tar.gz runs from anywhere: extract
    it and run ./openote inside. It has no package manager to ask
    for libmpv, so if you want video to play in the page, install
    mpv-libs on Fedora or libmpv2 on Ubuntu/Debian yourself —
    the app says so too.)
  • macOS: openote-*-macos-universal.dmg — drag Openote to Applications.

Both warnings below are expected. Here is exactly why.

Openote is not code-signed. Signing certificates cost a few hundred
dollars a year each, and while the project is this young that money
is better spent on nothing at all. Nothing about the warnings says
the software is unsafe — only that we have not paid to tell your
operating system who we are. Every build here is produced by the
public workflow in this repository, from the tagged commit, and you
can read both.

Windows: "Windows protected your PC"

Click More info, then Run anyway. SmartScreen shows this for
any installer it has not seen often enough to have an opinion about.

macOS: "openote is damaged and can't be opened"

Gatekeeper quarantines unsigned downloads. After copying to
Applications, clear the flag once:

xattr -cr /Applications/openote.app

Your notes never leave your machine either way — see the project's
local-first principles.

Full Changelog: v1.0.0...v1.0.1