Docs
Installation
Download, check and start Blocknotik on Windows, macOS and Linux, including what to do about SmartScreen and Gatekeeper warnings.
On this page
Blocknotik has no installer. It is a single executable file inside an archive: unpack it anywhere and start it. To remove the program, delete that file — your notes stay where they are.
What you need
- Windows 10 or 11, 64-bit (x64). On Windows on ARM the x64 build should run through the built-in emulation, but we haven't tried it.
- macOS 12 Monterey or later, on Apple silicon or Intel.
- Linux on x86-64 or ARM64. The program has no dependencies; any distribution from the last ten years will do. To open the browser automatically it uses
xdg-open. - A web browser from the last few years: Firefox, Chrome, Chromium, Edge, Safari or anything built on them.
- Very little memory and disk: the program is about 7–8 MB unpacked and keeps the text of your notes in memory.
Check the download
Each archive on the download page is listed with its SHA-256 checksum; the same sums are in the file SHA256SUMS. Comparing them takes a minute and tells you the file arrived intact and is the one we published.
On Windows, in PowerShell:
Get-FileHash .\blocknotik-0.1.0-windows-x64.zip -Algorithm SHA256
On macOS:
shasum -a 256 blocknotik-0.1.0-macos-arm64.zip
On Linux, with SHA256SUMS in the same folder:
sha256sum --ignore-missing -c SHA256SUMS
The long hexadecimal string must match the one on the download page exactly.
Windows
- Download
blocknotik-0.1.0-windows-x64.zip, right-click it and choose Extract All…. - Open the extracted folder and double-click
blocknotik.exe. - Windows will probably show a blue Windows protected your PC window (SmartScreen). This happens because the program is not signed with a paid certificate and is new. Click More info, check that the file name is
blocknotik.exe, then click Run anyway. Windows remembers the decision. - A console window opens and prints the address of your notes; the browser opens by itself. Keep the console window open while you work. Closing it stops Blocknotik.
If the browser doesn't open, copy the address that starts with http://127.0.0.1: from the console window into the browser.
macOS
- Download the archive for your Mac:
macos-arm64for Apple silicon (M1 and newer),macos-x64for Intel. Double-click to unpack. - The program is not signed or notarized by Apple, so a double-click will show “blocknotik” cannot be opened or Apple could not verify…. There are two ways around it:
- Open System Settings → Privacy & Security, scroll down to the message about
blocknotikand click Open Anyway. Confirm with your password. - Or remove the quarantine mark in Terminal, from the unpacked folder:
- Open System Settings → Privacy & Security, scroll down to the message about
xattr -d com.apple.quarantine ./blocknotik
./blocknotik
- Started from Finder, Blocknotik opens a Terminal window for its messages. Keep it open while you work. To stop the program, choose Quit Blocknotik in the app menu or press Ctrl+C in Terminal.
Linux
tar -xzf blocknotik-0.1.0-linux-x64.tar.gz
cd blocknotik-0.1.0-linux-x64
./blocknotik
Use the linux-arm64 archive on a Raspberry Pi 4/5 with a 64-bit system and other ARM64 machines. To have the command everywhere, copy the file to a folder in your PATH, for example ~/.local/bin.
To start Blocknotik from the application menu, create ~/.local/share/applications/blocknotik.desktop:
[Desktop Entry]
Type=Application
Name=Blocknotik
Exec=/home/YOU/.local/bin/blocknotik
Terminal=true
Categories=Office;
Terminal=true keeps a terminal window open for the program's messages; closing it stops Blocknotik.
Where the notes are
By default notes live in the Blocknotik folder in your home folder: C:\Users\you\Blocknotik on Windows, /Users/you/Blocknotik on macOS, /home/you/Blocknotik on Linux. The folder is created on first start. To use another one, see command-line options.
Updating and removing
To update, download the new archive and replace the old blocknotik file. Settings live in your browser (language and editor mode), the notes in their folder, so nothing else needs migrating.
To remove Blocknotik, delete the file. The notes folder is not touched; delete it yourself if you really mean it.