User guide
ZITEXT Documentation
Everything you need to install ZITEXT, find your way around, and get the most out of its editing tools on macOS, Windows and Linux.
Introduction
ZITEXT is a free, open-source text editor for macOS, Windows and Linux. It is built with Rust and Tauri v2 and uses the Monaco editor (the editing engine behind VS Code), so you get familiar, industry-standard editing in a small, native-feeling app instead of a bundled browser.
- Speed: Instant startup (under 300ms) and a low memory footprint.
- Simplicity: A clean, distraction-free UI that stays out of your way.
- Built-in tools: a viewer for huge files and live logs, file compare, text and data tools, marks, a Scratchpad, JSON, XML and YAML formatting, Markdown preview, split view, find in files and a command palette, with no plugins to install.
- Private: No account and no telemetry. Your files never leave your machine.
System requirements
- macOS: 10.15 Catalina or later (Apple Silicon and Intel builds)
- Windows: Windows 10 or 11, 64-bit
- Linux: 64-bit; Ubuntu 22.04+, Debian 12+, Fedora 36+ or equivalent
Coming from Notepad++?
Notepad++ only runs on Windows. ZITEXT gives you the same kind of power-user editing on every platform:
- Multi-cursor editing and column (rectangular) selection
- Find and replace with match case, whole word and regular expressions
- Find in files across a whole project folder
- Syntax highlighting for 80+ languages, chosen automatically from the file extension
- Split view to work on two files side by side
- JSON, XML and YAML tools built in, with no plugins to install
- Compare files, mark words in colour, and sort, de-duplicate and convert text, like the popular Notepad++ plugins
- Open huge log files and follow them as they grow
- Crash recovery that brings back unsaved work if the app quits unexpectedly
Installation & updates
Download the installer for your system from the downloads page. Every build is free and contains the full feature set.
macOS
- Download the Apple Silicon build for M1/M2/M3/M4 Macs, or the Intel build for older Macs. (Not sure? Apple menu › About This Mac shows “Chip” for Apple Silicon or “Processor” for Intel.)
- Open the
.dmgfile and drag ZITEXT into your Applications folder. - Launch ZITEXT from Applications or Spotlight.
Windows
- Download the
.msiinstaller (recommended) or the.exesetup program. - Run it and follow the prompts. ZITEXT uses Microsoft Edge WebView2, which is built into Windows 10 and 11.
- If Windows SmartScreen shows “Windows protected your PC”, click More info and then Run anyway. This appears for new apps that have not yet built up a download reputation with Microsoft.
Linux
Debian / Ubuntu (.deb):
sudo apt install ./ZITEXT-2.2.3-Linux-amd64.deb
Any distribution (.AppImage):
chmod +x ZITEXT-2.2.3-Linux-x64.AppImage
./ZITEXT-2.2.3-Linux-x64.AppImage
The .deb package installs its dependencies (WebKitGTK and GTK) automatically. The AppImage needs FUSE; if it does not start, install libfuse2 (Ubuntu/Debian) or fuse-libs (Fedora).
Updates
A few seconds after launch, ZITEXT checks once whether a newer version has been released. If there is one, a dialog offers Download (opens the downloads page), Remind me later or Skip this version. Only Skip this version hides that version for good. Install the new version over the old one; your settings are kept. You can turn the check off in Settings › Privacy. Help › About shows your current version and links to the release notes.
The interface
When you first open ZITEXT you see the Welcome screen with buttons for New File, Open File and Open Folder, your recent files, and a short list of keyboard shortcuts.
- Menu bar: File, Edit, View, Tools, Language, Settings and Help. On macOS these are in the system menu bar, alongside the ZITEXT and Window menus; on Windows and Linux they are at the top of the window, which ZITEXT draws itself on Windows.
- Explorer: the file tree of an open folder, on the left. Show or hide it from View › Toggle Explorer; drag its edge to resize it (150–600 px).
- Tab bar: one tab per open file. A dot (●) marks unsaved changes. The Large File viewer, File Compare and the Scratchpad also appear here as tabs.
- Breadcrumb: the path of the current file.
- Editor: line numbers, syntax highlighting, code folding and an optional minimap.
- Status bar: language (with its colour badge; click it to change the language), line ending (LF, CRLF or Mixed), encoding, file size in bytes as saved, minimap toggle, cursor position (Ln, Col), character and word counts, selection size and font size controls.
ZITEXT remembers the window’s size and position, and whether it was maximized, between launches.
Files & tabs
Creating and opening files
- New file: Cmd+N / Ctrl+N. New files live in memory until you save them.
- Open file: Cmd+O / Ctrl+O, or File › Open File…
- Open folder: Cmd+K / Ctrl+K or File › Open Folder… shows the folder in the Explorer.
- Recent files: File › Recent Files and the Welcome screen list your last 10 files. Files that have been deleted or moved are left out.
- One tab per file: opening a file that is already open, even through a symbolic link, a different letter case or a relative path, switches to its tab.
- Drag and drop: drop files onto the window to open them, or drop a folder to open it in the Explorer.
- From your OS: ZITEXT registers as an editor for common text and code files (.txt, .md, .json, .xml, .yaml, .js, .ts, .py, .rs, .go, .sql, .csv, .log and many more), so you can use Open With › ZITEXT. Opening a file while ZITEXT is running adds it to the existing window.
Saving
- Save: Cmd+S / Ctrl+S. Untitled files ask for a location.
- Save As: Cmd+Shift+S / Ctrl+Shift+S.
- Revert File (File menu or command palette) discards your changes and goes back to the version on disk. If another program changed the file since, ZITEXT asks before replacing that change.
- Saves are atomic: the file is written to a temporary copy and swapped in, so a crash during a save cannot leave a half-written file. Hard links, file permissions and, on macOS, Finder tags are kept.
- If the file changed on disk since you opened it, ZITEXT shows File Changed on Disk and lets you overwrite it or cancel.
- Read-only files (including files you don’t have permission to change) ask before saving with Save Anyway; the file stays read-only afterwards.
- New documents suggest a file name with the extension of their language, for example
Untitled-1.py. Save As onto a file that is already open in another tab is refused and that tab is shown.
Auto-save
Choose a mode in Settings › Files:
- Off (default): save manually.
- After Delay: save after you stop typing for 0.5–10 seconds (default 2 seconds).
- On Focus Change: save when you switch tabs or switch to another app.
Auto-save only applies to files that already exist on disk; untitled tabs are never saved automatically. Auto-save never opens a dialog: if the file changed on disk, is read-only, or its text can’t be stored in the file’s encoding, auto-save pauses for that file and a notice explains why. Saving manually, Reload or Revert resumes it.
Working with tabs
- Switch tabs: click a tab, press Cmd+1–Cmd+9 / Ctrl+1–Ctrl+9, or cycle with Option+Tab (macOS) / Ctrl+Tab (Windows/Linux). Add Shift to go backwards.
- Reorder: drag a tab to a new position.
- Rename: double-click a tab. For a saved file this renames the file on disk, including letter-case-only changes such as
readme.mdtoREADME.md. Renaming never replaces an existing file. - Pin: click the pin icon on a tab. Pinned tabs cannot be closed or moved until you unpin them.
- Close: Cmd+W / Ctrl+W. If a tab has unsaved changes you can Save, Don’t Save or Cancel. Quitting with unsaved tabs offers Save All & Quit.
- Read-only: use Toggle Read-Only in the command palette (also in the View menu on Windows and Linux) to protect a tab from accidental edits.
- Copy File Path: in the View menu and the command palette.
File Explorer
- Expand and collapse folders with the mouse or the arrow keys; press Enter to open a file.
- Use Filter by file name… to find files anywhere in the folder, including folders you haven’t expanded. To search inside files, use Find in Files.
- The × button hides the sidebar; Close Folder closes the folder.
- Refresh reloads the tree and keeps your expanded folders open.
- The open folder, sidebar width and visibility are remembered between launches.
- The Explorer is for browsing: create, rename and delete files in your OS file manager.
- Very large folders are shown up to 5,000 entries (with a note saying so) and 10 levels deep. Symbolic links are not followed; the Explorer says how many it left out.
- The file count at the bottom shows, for example, 100,000+ files when counting stopped at a limit.
- On Windows, network folders (
\\server\share) work like any other folder.
Encoding, line endings and large files
- Files are read as UTF-8 (with or without a byte-order mark, shown as UTF-8 with BOM), falling back to Windows-1252, and saved back exactly as they were. If new text cannot be stored in the original encoding, ZITEXT offers to save as UTF-8.
- Line endings (LF or CRLF) are detected and shown in the status bar, and kept when you save. A file that mixes styles shows Mixed, and ZITEXT tells you when you open it that editing will make its line endings consistent.
- Files larger than 1 MB show a warning before opening. Files larger than 10 MB can’t be edited, and ZITEXT offers to open them in the Large File viewer instead.
- Binary files are not opened. UTF-16 text files are recognised, and ZITEXT explains that they need converting to UTF-8 first.
External changes
ZITEXT checks open files every two seconds while its window is visible. If another program changes a file, a banner offers Reload or Ignore; if the file or its folder is deleted, you can Save Again or ignore it. Reloading a tab with unsaved changes asks for confirmation first, and the banner stays until the change is dealt with.
Crash recovery
While you work, ZITEXT keeps a copy of your open tabs, including unsaved text, about two seconds after you stop typing (at least every 10 seconds while you type). If the app crashes, is force-quit, or the computer shuts down, the next launch asks whether to Restore Previous Session, even if you open ZITEXT by double-clicking a file. Unsaved changes to a file that has since been deleted or moved reopen in a Recovered tab, and if the file was changed after the crash, ZITEXT asks before overwriting it. When you quit normally, the next launch starts fresh.
Scratchpad
The Scratchpad is a note that is always there, for SQL, JSON snippets, IDs, commands or anything else you want to keep at hand. Open it with Cmd+Shift+N / Ctrl+Shift+N or Tools › Open Scratchpad.
- There is no file name and no Save dialog: it saves itself as you type and is there again the next time you open ZITEXT, even if you quit with Don’t Save.
- Pick a language in its header for syntax highlighting; ZITEXT remembers it.
- Find & Replace and Go to Line work here as in any document.
- It holds up to 5 MB of text. If it can’t be saved, a notice says so and ZITEXT asks before you quit.
- The text is stored in ZITEXT’s private data folder (see Where settings are stored).
Editing
Syntax highlighting and languages
ZITEXT highlights 87 languages. The language is chosen from the file name and extension, and for untitled files ZITEXT guesses it from the content once you have typed a few lines; it never overrides a language you picked. To change it, use the Language menu or click the language in the status bar and type to narrow the list.
- Web & markup
- HTML, CSS, SCSS, Less, JavaScript, TypeScript, Markdown, MDX, XML, Liquid, Handlebars, Razor
- Programming
- Python, Java, C, C++, C#, Go, Rust, Ruby, PHP, Swift, Kotlin, Scala, Dart, Elixir, Clojure, Lua, Perl, R, Objective-C, Pascal
- Data & config
- JSON (including JSON with comments, such as
tsconfig.json), YAML, TOML, INI, SQL, MySQL, PostgreSQL, GraphQL, Protocol Buffers, Terraform (HCL), Bicep, Dockerfile, Makefile - Shell & scripts
- Bash/Shell, PowerShell, Batch, Tcl, Plain Text
Multi-cursor editing
- Option+click (macOS) or Alt+click (Windows/Linux) adds a cursor.
- Cmd+D / Ctrl+D selects the next occurrence of the current selection, adding a cursor there.
- Everything you type is applied at every cursor. Press Esc to go back to a single cursor.
Column (rectangular) selection
Column selection lets you select and edit a vertical block of text, such as a column in a CSV file.
- Turn it on in Settings › Editor › Column Selection (it is off by default).
- Hold Option+Shift (macOS) or Alt+Shift (Windows/Linux) and drag with the mouse.
From the keyboard, use Cmd+Shift+Option+arrow keys on macOS or Ctrl+Shift+Alt+arrow keys on Windows.
Everyday editing
- Move line up/down: Option+↑/↓ / Alt+↑/↓.
- Toggle line comment: Cmd+/ / Ctrl+/.
- Toggle block comment: Shift+Option+A (macOS), Shift+Alt+A (Windows), Ctrl+Shift+A (Linux).
- Format document: Shift+Option+F (macOS), Shift+Alt+F (Windows), Ctrl+Shift+I (Linux). Works for JSON, HTML, CSS, SCSS, Less, JavaScript and TypeScript. For XML and YAML, use the data tools.
- Auto-closing brackets and quotes, smart indentation and code folding (click the arrows in the gutter).
- Suggestions as you type, based on the words and syntax in the file. JSON files are checked for errors as you type.
- Copy, Cut and Paste work with several cursors, and copy or cut the whole line when nothing is selected. Pasting as many lines as there are cursors puts one line at each cursor.
- Word wrap: View › Toggle Word Wrap, Option+Z (macOS) / Alt+Z (Windows/Linux), or Settings › Editor.
- Minimap: toggle from the status bar, the command palette or Settings.
- Zoom: Cmd+= / Cmd+- (Ctrl on Windows/Linux) or the −/+ buttons in the status bar (8–72 px).
Search
Find and replace
Press Cmd+F / Ctrl+F to find, or Cmd+Option+F (macOS) / Ctrl+H (Windows/Linux) to find and replace. The search box starts with your current selection. Pressing the shortcut again while the find bar is open moves the cursor back into the search box. Find also works in the Markdown preview.
- Aa: match case
- Whole word: ignore partial matches (a search for
userdoesn’t match insideuser_id) - .*: use a regular expression. In the replacement,
$1–$99insert groups,$&the whole match,$$a dollar sign, and\n/\ta new line or tab. A pattern that would take too long on the document is not run, and the bar shows Too slow. - The bar shows “x of y” matches. Enter goes to the next match, Shift+Enter to the previous one, and Esc closes the bar.
- Replace changes the current match; Replace All changes every match and is undone in one step.
- Mark keeps every match highlighted after the bar closes. See Marks.
Find in Files
Press Cmd+Shift+F / Ctrl+Shift+F (or Edit › Find in Files) to search every file in the open folder. If no folder is open, the panel offers to open one.
- Type your search and press Enter. Options: Match Case and Match Whole Word.
- Results are grouped by file; click a result to open the file at that line.
- Generated and dependency folders are skipped (
node_modules,.git,target,dist,build,vendor,.venvand similar), as are files over 1 MB, UTF-16 files and symbolic links. A note under the results says what was skipped, and when a search stopped early. - A search returns up to 500 results. Unsaved changes in open tabs are not searched.
- Results stay while you open them one after another. Closing the panel (which brings the Explorer back) clears the search, so it opens fresh next time; opening another folder clears it too. Emptying the search box clears the results straight away.
Go to line
Press Cmd+G / Ctrl+G and enter a line number, or line:column such as 120:8. The box shows the valid range for the current file.
Marks
Marks keep every occurrence of a word, phrase or pattern highlighted in its own colour while you read and edit, which is handy in logs, configuration files and debugging output.
- Mark Selection: select text (or put the cursor on a word) and press Cmd+Shift+M / Ctrl+Shift+M.
- From Find: click Mark in the Find bar, or run Mark Find Matches from the command palette.
- Mark Text… and Mark Regular Expression… (Tools menu or command palette) let you type what to mark, with Match case and Whole word options.
- Up to six colours, also shown in the scrollbar. Marks follow your edits and show in both panes of split view.
- F4 / Shift+F4 go to the next or previous marked text (on Mac laptops you may need fn).
- Clear one mark with Clear Mark in the command palette, or all of them with Clear All Marks. Marks last until you close the document.
Split view & Markdown preview
Split view
- Toggle with Cmd+\ / Ctrl+\, View › Toggle Split View or the command palette.
- Drag the divider to resize the panes (from 15% to 85%).
- View › Open in Right Pane shows the current file on the right; Swap Panes switches the two sides.
- Click the right pane, then click a tab to open that file in the right pane. Each pane keeps its own cursor and scroll position, even when both show the same file.
- The divider can also be moved with the keyboard: focus it and use the arrow keys, Home and End.
Markdown preview
Press Cmd+Shift+V / Ctrl+Shift+V (or use Toggle Markdown Preview in the command palette, or View menu on macOS) to switch a Markdown or MDX tab between source and a rendered, GitHub-style preview. The preview follows the app theme and is set per tab, and Find searches the rendered text.
- Links to headings scroll the preview, and links to other files open them in a tab.
- Web and email links ask first, showing the full address, and then open in your browser or mail app.
Large files & logs
The Large File viewer opens files of any size, even several gigabytes, in seconds, because it reads only the lines on screen. It is read-only, so the file is never changed. Open a file with File › Open Large File or Log… or Open Current File in Log Viewer in the command palette; files over the editor’s 10 MB limit are offered the viewer automatically.
Following a log
- Live watches the file for new lines; press it again to pause.
- Follow keeps the newest line in view; Latest jumps to the end.
- If the log is rotated (replaced with a new file), truncated or deleted, a notice says so and the viewer carries on with what is there.
Filtering and highlights
- Type in the filter box and press Enter to show only matching lines (Include) or hide them (Exclude). Use .* for a regular expression and Aa to match case. With several include filters, choose Match any (OR) or Match all (AND).
- Lines keep their real line numbers. Untick Only matching to see every line again without losing the filter.
- Highlights colours errors, warnings, info and debug lines, HTTP status codes and request IDs, and any keywords you add.
Finding your way
- Go to takes a line number, a percentage such as
50%, or a time such as2026-10-08 14:30or14:30:05, and jumps to the first line at or after it. ISO 8601, Apache/nginx and syslog timestamps are understood. - Find (Cmd+F / Ctrl+F) searches the whole file; Enter and Shift+Enter go to the next and previous match.
- Click a line number to bookmark it. F2 / Shift+F2 go to the next or previous bookmark, and Cmd+F2 / Ctrl+F2 toggles one on the selected line.
- Click a line, Shift-click to select a range, and copy up to 10,000 lines.
Exporting lines
Export writes the filtered, highlighted, selected or bookmarked lines to a new file of your choice, exactly as they appear in the original (line endings included). The viewed file itself can’t be chosen as the destination.
Compare files
File Compare shows what differs between the current document and:
- another file (File › Compare › With File…, which also opens it in a tab),
- another open tab (With Open Tab…),
- the clipboard (With Clipboard), or
- its saved version on disk (With Saved Version), to review unsaved changes.
The same commands are in the command palette under “Compare”.
Reading a comparison
- Added lines are green, removed lines red, and the characters that changed within a line are marked. Blank space keeps both sides level, and the two sides scroll together.
- Switch between Side by side and Inline, where removed lines appear above the change.
- Step through changes with the first, previous, next and last buttons, or Alt+F5 / Shift+Alt+F5.
- Ignore leading/trailing spaces, all whitespace, case or blank lines to hide differences that don’t matter.
Copying changes
- Click an arrow in the margin, or use Copy to right / Copy to left, to copy one change to the other side.
- Edits in a comparison are ordinary edits to that document: undo works, and the tab shows unsaved changes until you save (the Save button in the pane, or Cmd+S / Ctrl+S).
- Find & Replace and Go to Line work on the side you last clicked.
- The clipboard, saved versions and read-only files are never changed.
Command palette & tools
Command palette
Press Cmd+Shift+P / Ctrl+Shift+P (or Cmd+P / Ctrl+P) and start typing to filter commands by name or category. Use the arrow keys and Enter to run one, or Esc to close. Clicking the language name in the status bar also opens the palette.
- File
- New File, Open File, Open Folder, Close Folder, Open Large File or Log, Open Scratchpad, Save, Save As, Revert File, Close Tab
- Edit
- Find, Find & Replace, Find in Files, Go to Line
- Compare
- Compare With File, With Clipboard, With Saved Version, With Tab
- Text & Data
- Line, case, encoding, checksum, date and conversion tools (see below)
- Marks
- Mark Selection, Mark Find Matches, Mark Text, Mark Regular Expression, Next/Previous Marked, Clear Mark, Clear All Marks
- View
- Toggle Theme, Toggle Word Wrap, Toggle Read-Only, Toggle Explorer, Toggle Split View, Toggle Markdown Preview, Toggle Minimap, Copy File Path
- Settings
- Preferences, Keyboard Shortcuts
- Help
- Show Diagnostics
- Data
- JSON: Format, Minify, Validate, Sort Keys · XML: Format, Validate · YAML: Format
Data tools: JSON, XML and YAML
Run these from the command palette on the current file:
- Format JSON: pretty-prints with consistent indentation.
- Minify JSON: removes all whitespace.
- Validate JSON: reports the line and column of the first syntax error.
- Sort JSON Keys: sorts object keys alphabetically at every level.
- Format XML and Validate XML. Entity references such as
"are kept as written. - Format YAML. Values such as
0755,0x1Fand very large numbers are kept exactly; a document that can’t be formatted without changing a value is left as it is.
These tools use your Tab Size, keep the file’s line endings and final newline, run in the background on large documents, and never change a read-only document. Format on Save (Settings › Files) applies them to JSON, XML and YAML files when you save.
Text & Data Tools
Run these from the Tools menu or the command palette (category “Text & Data”). They work on the selection, or on the whole document when nothing is selected, and each run can be undone in one step.
- Lines
- Sort ascending, descending or numerically; remove duplicate lines, empty lines or repeated blank lines; trim leading, trailing or both ends; reverse; join; split at a delimiter you choose; count unique lines (opens a report in a new tab)
- Case
- Uppercase, lowercase, title case
- Encode / decode
- URL, Base64, HTML and JSON escaping; decode a JWT (on your computer; the signature is not checked)
- Generate
- Insert a UUID at each cursor; SHA-256 and MD5 checksums (copied to the clipboard); Unix timestamp to date and date to Unix timestamp (UTC)
- Convert
- CSV ↔ JSON, TSV ↔ JSON, CSV ↔ TSV (values are kept exactly as text, so IDs and leading zeros survive), and Minify XML. Conversions open in a new tab.
Diagnostics
Show Diagnostics in the command palette displays your version, platform, open tabs and performance timings, with a Copy to Clipboard button. Include this when you report a bug.
Settings & customization
Open Settings with Cmd+, / Ctrl+, or Settings › Preferences…. Theme, fonts and font size show on screen as you pick them. Changes are kept when you click Save Changes; Cancel or Esc discards them and puts back the previous look.
Editor
- Theme: Light, Dark or System (the default for new installs), which follows your operating system’s setting as it changes. View › Toggle Theme switches quickly. The editor always matches the app theme.
- UI font: Space Grotesk (default), Geist Sans, IBM Plex Sans, Inter or System UI.
- Code font: JetBrains Mono (default), IBM Plex Mono, Menlo, Monaco, Consolas, Courier New, Fira Code, Source Code Pro, Ubuntu Mono, Roboto Mono, Space Mono, Courier Prime or System Monospace. A font that isn’t bundled must be installed on your computer to be used.
- Font Size: 8–72 px (default 14), matching the zoom range.
- Tab Size: 2, 4 (default) or 8, and Insert Spaces (on by default).
- Word Wrap, Minimap and Column Selection (all off by default).
Files
- Autosave: Off, After Delay or On Focus Change, plus the delay. See Auto-save.
- Format on Save: formats JSON, XML, YAML, HTML, CSS, JavaScript and TypeScript files each time you save (off by default). Read-only and new, unsaved documents are skipped.
Privacy and Advanced
- Check for updates: on by default. This is the only network request ZITEXT makes.
- Advanced shows the file limits: a warning at 1 MB, a 10 MB maximum for editing (use the Large File viewer beyond that), and a two-second check for external changes.
Custom keyboard shortcuts
Open Settings › Keyboard Shortcuts… (or Keyboard Shortcuts in the command palette). You can remap: New File, Open File, Open Folder, Save, Save As, Close Tab, Find, Find & Replace, Go to Line, Command Palette, Toggle Word Wrap, Open Scratchpad, Mark Selection and Next/Previous Marked Occurrence. Your shortcuts apply everywhere, including the macOS menu bar.
- Click a shortcut, then press the new key combination. It must include Cmd/Ctrl or Alt.
- Press Esc to cancel. Use the reset button on a row, or Reset all, to restore the defaults.
- If two commands share a shortcut, ZITEXT warns you before saving. Keys used by fixed commands (such as Copy, Undo, Find in Files or Split View) can’t be assigned.
Where settings are stored
- macOS:
~/Library/Application Support/com.zitrino.zitext/settings.json - Windows:
%APPDATA%\com.zitrino.zitext\settings.json - Linux:
~/.config/com.zitrino.zitext/settings.json
Crash-recovery data (session.json) and the Scratchpad (scratchpad.txt) are kept in the same folder. A damaged settings file is set aside (as settings.corrupt.….json) and ZITEXT starts with defaults.
Keyboard shortcuts
Default shortcuts in ZITEXT 2.2.3. Shortcuts marked ★ can be changed in Keyboard Shortcuts.
| Action | macOS | Windows / Linux |
|---|---|---|
| Files & tabs | ||
| New file ★ | Cmd+N | Ctrl+N |
| Open file ★ | Cmd+O | Ctrl+O |
| Open folder ★ | Cmd+K | Ctrl+K |
| Save ★ | Cmd+S | Ctrl+S |
| Save as ★ | Cmd+Shift+S | Ctrl+Shift+S |
| Close tab ★ | Cmd+W | Ctrl+W |
| Go to tab 1–9 | Cmd+1…Cmd+9 | Ctrl+1…Ctrl+9 |
| Next / previous tab | Option+Tab / Option+Shift+Tab | Ctrl+Tab / Ctrl+Shift+Tab |
| Search | ||
| Find ★ | Cmd+F | Ctrl+F |
| Find & replace ★ | Cmd+Option+F | Ctrl+H |
| Find in files | Cmd+Shift+F | Ctrl+Shift+F |
| Go to line ★ | Cmd+G | Ctrl+G |
| Editing | ||
| Add next match to selection | Cmd+D | Ctrl+D |
| Add cursor | Option+click | Alt+click |
| Column selection (when enabled) | Option+Shift+drag | Alt+Shift+drag |
| Move line up / down | Option+↑ / Option+↓ | Alt+↑ / Alt+↓ |
| Toggle line comment | Cmd+/ | Ctrl+/ |
| Toggle block comment | Shift+Option+A | Shift+Alt+A (Linux: Ctrl+Shift+A) |
| Format document | Shift+Option+F | Shift+Alt+F (Linux: Ctrl+Shift+I) |
| View | ||
| Command palette ★ | Cmd+Shift+P or Cmd+P | Ctrl+Shift+P or Ctrl+P |
| Toggle split view | Cmd+\ | Ctrl+\ |
| Toggle Markdown preview | Cmd+Shift+V | Ctrl+Shift+V |
| Toggle word wrap ★ | Option+Z | Alt+Z |
| Zoom in / out | Cmd+= / Cmd+- | Ctrl+= / Ctrl+- |
| Settings | Cmd+, | Ctrl+, |
| Full screen | Ctrl+Cmd+F | F11 |
| Tools | ||
| Open Scratchpad ★ | Cmd+Shift+N | Ctrl+Shift+N |
| Mark selection ★ | Cmd+Shift+M | Ctrl+Shift+M |
| Next / previous marked ★ | F4 / Shift+F4 | F4 / Shift+F4 |
| Compare: next / previous change | Option+F5 / Shift+Option+F5 | Alt+F5 / Shift+Alt+F5 |
| Log viewer: next / previous bookmark | F2 / Shift+F2 | F2 / Shift+F2 |
| Log viewer: toggle bookmark | Cmd+F2 | Ctrl+F2 |
Privacy & security
- No telemetry: ZITEXT does not collect usage data or crash reports, and file contents never leave your computer. The only network request is the optional update check.
- Open source: the full source code is on GitHub under the Apache-2.0 licence.
- Restricted file access: the editor can only read and write files you open or that are inside a folder you open, and closing the folder ends that access. System areas such as
/proc,/sysand/devare blocked. - Private app data: settings, crash-recovery data, crash logs and the Scratchpad are readable only by your user account on macOS and Linux.
- Local-only tools: JWT decoding, checksums and every other Text & Data Tool run on your computer.
- Strict Content Security Policy, and Markdown previews are sanitised before they are shown. Links in a preview can’t navigate the editor window; web and email links ask before opening.
- Safe saves: atomic, conflict-aware writes that keep the file’s original encoding.
To report a security issue, see the project’s security policy.
Troubleshooting
Windows says “Windows protected your PC”
Click More info and then Run anyway. SmartScreen shows this for new apps until they build a download reputation.
The window is blank on Linux
ZITEXT already disables the WebKit DMA-BUF renderer that causes blank windows on many NVIDIA systems. If you still see a blank window, update your graphics drivers and WebKitGTK, and make sure you are using the .deb or AppImage for your architecture (64-bit x86).
The AppImage does not start
Make it executable with chmod +x and install FUSE 2 (sudo apt install libfuse2 on Ubuntu and Debian).
The wrong language is detected
Choose the right one from the Language menu. Files with uncommon extensions open as Plain Text until you pick a language.
A file will not open
Files over 10 MB can’t be edited; open them read-only in the Large File viewer. Binary files are not opened, and UTF-16 text files need converting to UTF-8 first.
A file is not saving
Make sure you have permission to write to that folder and that the tab is not set to read-only. If auto-save shows a notice that it paused, save manually once to resume it. Otherwise use Save As to save a copy somewhere else.
Find says “Too slow”
The regular expression would take too long on this document (for example, nested repeats such as (a+)+), so ZITEXT didn’t run it to keep the window responsive. Simplify the pattern.
Getting help
Report bugs on GitHub Issues (include the output of Show Diagnostics), ask questions in our Discord community, or email support@zitrino.com.