Editora 0.13.1 docs. You are reading an archived version, kept so links from that release keep working. Read the 0.15.0 docs →

Command line

Editora takes a few command-line arguments. With the native installers the launcher binary accepts them too; from source, pass them after javafx:run or the jar.

Flags

--single-window opens exactly one window instead of restoring every window that was open at last quit: bare, it opens the no-project window; with a name (--single-window=MyProject), that project’s window (falling back to no-project if no project matches). It’s session-only, so your saved multi-window layout is untouched and the next normal launch restores everything.

--no-session skips the saved session’s files entirely and opens only what you named on the command line. It’s for launching from a file manager or a script, where restoring the last session is pure cost — every restored file is a buffer to load and highlight and, once shown, a language server to run, for files you didn’t ask to see. Also session-only: your saved tabs are left as they were rather than replaced by whatever you happened to open.

Opening files

Pass one or more file targets, each optionally with a line and column:

editora path/to/file.txt
editora src/Main.java:42
editora notes.md:10:5

Each target opens in its own focused tab and jumps to the given position. File targets, --project, and --new-file combine, so you can open a project and jump into a file in one command.

One editor, not two

If Editora is already running, a launch that just opens files hands them to the running editor and exits rather than starting a second one — reusing the process, with its language servers and its memory, instead of paying for a second set.

What you get is a new window for those files, brought to the front, with any focus mode you asked for (--expert, say) applied to it — so a desktop entry like “Editora Expert Mode” still means Expert Mode. What is reused is the process, not the window you happened to be working in: a file arriving as a tab in the middle of what you were doing, restyling that window’s chrome on the way, is not what clicking a file should do.

Unless the file is already open, in which case the window holding it is brought forward instead of opening it twice. Two independent buffers over one file loses edits — save one and the other is silently stale.

These windows are deliberately left out of your saved layout, so a file opened from the file manager doesn’t come back as an empty window on the next launch.

The reason it exists: on Linux and Windows a file manager passes the path as a command-line argument, which by definition starts a new process, so clicking a file used to pay a full cold start and leave a second editor resident. (macOS never had the problem — Finder delivers an event to the running app — and the handoff routes into that same code path.)

It is deliberately narrow. Only a launch that is purely “open these files” is handed over; these always get their own editor:

• --project, --new-file, --config-dir and --dev, which shape how a process starts and have no honest meaning inside a window that’s already running
• a launch with no files at all
• anything passing --new-instance

An instance is scoped to its config directory, so a --dev launch can never hand off to your real editor, and two --config-dir sessions stay independent. If the handoff fails for any reason, the launch simply starts its own editor.

Opening files from the file manager

Editora registers itself as a text editor with the desktop, so it shows up where your file manager offers a choice of application. What the installer can claim differs by platform:

Windows hands a file manager’s chosen file to an application as a command-line argument, and nothing maps an extension to Editora unless the installer says so — so until 0.13.0 the MSI installed an editor that no file manager could hand a file to.

It doesn’t take over your existing defaults. On Windows 8+ the shell’s per-user choice wins over anything an installer writes, so a type you already open with something else keeps opening with it and Editora is simply offered alongside. An extension nothing else claims does fall to Editora, which is the wanted outcome for the likes of .tfvars.

The list is every extension Editora actually resolves to a language, minus .html, .htm, .xhtml and .svg — left to the browser and the image viewer. That’s the same choice the Linux package already made, so the two installers can’t drift apart in what they claim.

Examples

# A throwaway instance that won't touch your real config
editora --dev

# Open a folder as a project and jump to a line
editora --project ~/code/app src/main/java/App.java:88

# Start a quick scratch buffer in Zen mode
editora --new-file=scratch.md --zen

# Open a file in a second editor rather than the running one
editora --new-instance notes.md

# What a desktop "Open With" entry passes: just these files, no saved session
editora --expert --single-window --no-session README.md

--zen and --simple only affect the current session; they don’t change your saved preferences. The config-folder flags are documented in Configuration.