Docs

Keyboard and command line

All keyboard shortcuts of Blocknotik and the command-line options for choosing the notes folder, the port and the browser behaviour.

Keyboard shortcuts

On macOS, use Cmd wherever Ctrl is written, and Option for Alt.

KeysWhat it does
Ctrl+KJump to the search box (and select what's in it)
Alt+NNew note
Ctrl+SSave now (it also saves on its own after a short pause)
Ctrl+ESwitch mode: Edit → Split → Preview → Edit
Enter in searchOpen the first result
Esc in searchClear the search
Enter in the titleRename the note and move to the text
Esc in the titleUndo the title change
Ctrl+PBrowser's print dialog — use it in Preview mode for paper or PDF

Why Alt+N and not Ctrl+N? Blocknotik runs inside your browser, and browsers don't let a page take over Ctrl+N (new window) or Ctrl+T. Everything else in the text field is the browser's own editing: Ctrl+Z to undo, Ctrl+F to find on the page, and so on.

Command line

blocknotik [options]
OptionMeaning
--dir PATHFolder with notes. Default: Blocknotik in your home folder. Created if missing.
--port NPort on 127.0.0.1. Default 0: a free port is picked at each start.
--no-browserDon't open the browser, only print the address.
--versionPrint the version, build date and platform, then exit.
--helpList the options.

The environment variable BLOCKNOTIK_DIR sets the folder too; --dir wins if both are given.

Examples

A second notebook for work, started from a shortcut or a script:

blocknotik --dir ~/Work-notes

Windows, a shortcut on the desktop: set Target to

C:\Tools\blocknotik.exe --dir "D:\Notes"

A fixed port, for example when a firewall on your computer asks about every new port:

blocknotik --port 8765

The session key changes at every start, even with a fixed port. While the program runs, http://127.0.0.1:8765/ keeps working in the browser where you opened it; after a restart, open the full address the program prints (or let it open the browser for you). If you see a page asking for “the link printed by Blocknotik”, that's what it means.

What the program prints

Blocknotik 0.1.0
Notes folder: /home/anna/Blocknotik
Open in the browser: http://127.0.0.1:41873/auth?token=9c1f…
Keep this window open while you work. Press Ctrl+C (or use Quit in the app) to stop.

The address contains the session key. Don't paste it into chats: anyone on the same computer who has it can open your notes while the program runs. People on other computers can't reach the address at all.

Exit codes

0 after a normal stop (Ctrl+C or Quit in the menu), 1 if the notes folder can't be opened or the port is busy.