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.
| Keys | What it does |
|---|---|
| Ctrl+K | Jump to the search box (and select what's in it) |
| Alt+N | New note |
| Ctrl+S | Save now (it also saves on its own after a short pause) |
| Ctrl+E | Switch mode: Edit → Split → Preview → Edit |
| Enter in search | Open the first result |
| Esc in search | Clear the search |
| Enter in the title | Rename the note and move to the text |
| Esc in the title | Undo the title change |
| Ctrl+P | Browser'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]
| Option | Meaning |
|---|---|
--dir PATH | Folder with notes. Default: Blocknotik in your home folder. Created if missing. |
--port N | Port on 127.0.0.1. Default 0: a free port is picked at each start. |
--no-browser | Don't open the browser, only print the address. |
--version | Print the version, build date and platform, then exit. |
--help | List 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.