Penstock

Guide / Start here

Penstock Desktop

Penstock Desktop is the editor of Penstock Web in an application window of its own. It has a menu, a folder dialog, recent projects, windows that come back where you left them, and it opens .bpmn, .dmn and .form files from the file manager.

Free Nothing else to install: Node.js is not needed. A preview for macOS (12 or later), Linux and Windows. Features that are Pro elsewhere are Pro here too.

What it is

Penstock Desktop is the same editor, project tree, tabs and sidebar as Penstock Web, in a window of its own instead of a browser tab. Everything in Penstock Web applies here: the title bar, the sidebar with its actions, the Project tree and the Chats, the editor groups you split and join, saving, comparing with Git, code tabs and the settings. Read that page for the window itself. This page is about what an application adds.

Each window runs its own copy of the local server that penstock web starts, inside the application, so there is nothing to install beside it and nothing to start in a terminal. The application loads that server's page and presents its key itself, so the key is never in a link or a cookie. Nothing is sent anywhere.

Where it stands

Install it

Every build is on the latest release, with a .sha256 file beside each one. <version> is the version number. The application is free, with no time limit.

SystemProcessorFile
macOSApple silicon (arm64)Penstock-<version>-mac-arm64.dmg
Intel (x64)Penstock-<version>-mac-x64.dmg
Linuxx86_64Penstock-<version>-linux-x86_64.AppImage, Penstock-<version>-linux-amd64.deb
arm64Penstock-<version>-linux-arm64.AppImage, Penstock-<version>-linux-arm64.deb
Windowsx64Penstock-<version>-win-x64.exe (installer), Penstock-<version>-win-x64.zip
arm64Penstock-<version>-win-arm64.exe (installer), Penstock-<version>-win-arm64.zip

To check a download, compare the SHA-256 of the file with the one in its .sha256 file.

macOS

  1. Download the .dmg for your Mac, open it, and drag Penstock to Applications.
  2. Open Penstock from Applications. macOS says it cannot verify the app. Press Done, not Move to Trash.
  3. Open System Settings, then Privacy & Security, scroll to Security, and press Open Anyway next to Penstock was blocked. Confirm with your password. This is asked once.
  4. Prefer a terminal? xattr -dr com.apple.quarantine /Applications/Penstock.app does the same.

The icon in the Dock follows the light or dark appearance of the app. On a Mac that supports it, the system also adapts the icon in the Finder.

Linux

Windows

  1. Download Penstock-<version>-win-x64.exe, or the arm64 one on an arm64 PC, and run it. The installer lets you choose the folder.
  2. Windows SmartScreen says it protected your PC, because the installer is not signed. Press More info, then Run anyway.
  3. Prefer no installer? Unpack the .zip into a folder of your own and start Penstock from it. SmartScreen asks the same question the first time.

Updating is the same again on every system: download the newer build and install it over the old one. Your projects and settings stay where they are.

Open a project

  1. Start the application. The first window offers Open a project: Choose a folder with BPMN diagrams, DMN decisions and forms. with an Open project… button and the recent projects under it.
  2. Press Open project… and choose a folder in the system's own folder dialog. Or pick a recent project.
  3. The window shows the name of the project with Opening… while its server starts, then shows the editor.

A project opens in the window you are in when that window has no project. Otherwise it opens in a window of its own. Opening the same project twice brings its window to the front.

From the file manager, and from a terminal

Windows

The menu

FileNew file, New window, Open project…, Open recent, Close project, Save, Reveal in Finder, Show in Explorer or Show in file manager (the open file), Close tab.
EditUndo, Redo, Cut, Copy, Paste and Select all elements, for the open file. Cut, copy, paste and select all in a diagram work across tabs and windows.
ViewToggle project tree, Toggle sidebar (the sidebar of the editor), the three zoom commands and full screen.
WindowThe system's own window commands.
HelpKeyboard shortcuts and Penstock website. The application menu has About Penstock.

The menu shows the shortcut of each command. The keys for tabs, splits, opening a file and the rest are the ones of Penstock Web, listed under Keyboard shortcuts. New file has the usual key for a new document here, not the one of the browser version.

What it shares with your other tools

The application keeps two things of its own: the position of its windows and the list of recent projects. They are in the application's data folder, not in ~/.penstock. The theme is chosen in Settings, as in Penstock Web.

When something goes wrong

"The editor engine stopped".
The server of that window ended. A server that ends by itself is started again once, after a second, on the same port, so the open page keeps its unsaved changes and carries on without a message. If the new one cannot start, or stops again, the window shows this screen and waits. Your unsaved changes are still in the window. Press Restart. A project that cannot run never loops.
"Unable to start the editor".
The server did not start for that project. Details shows the reason. Press Restart, or Open another project… to choose a different folder.
"The editor window stopped".
The window itself failed. Press Reload.
A link in the editor opens in a browser.
Links to web pages, http, https and mailto only, open in your own browser. The window shows only its own editor.