# Forge: Your tools. Your workflow. > Forge is a free, open source text editor for macOS, Linux and Windows with built-in tools for JSON, CSV, Markdown, XML, YAML, cron, hashes and more. Website: https://forge.bytefulminds.com/ Source: https://gitlab.com/bytefulminds/forge Latest version: 0.3.0, released 2026-11-16 License: GPL-3.0 ## Why Forge - **Starts fast, stays fast.** Cold start under a second. Large files load in the background, and above 20 MB Forge switches off the heavy features so even huge logs scroll smoothly. - **Knows your files.** Every document gets a toolbar with the tools for its language: formatting, validation, previews and conversions, one click away. - **A toolbox built in.** Hashes, Base64, letter case, UUIDs, timestamps and cron, plus a regex tester, Quick Diff, code shots and a snipping tool. From the Tools menu or a right click. - **Looks the same everywhere.** Forge draws its own window, menus and dialogs in three themes, so it feels like home on macOS, Linux and Windows. - **Never loses work.** Unsaved text and open tabs come back after a restart, and Forge notices when another program changes a file on disk. - **Keeps itself up to date.** Forge checks once a day for a new version and installs it with one click after verifying its SHA-256. You can switch it off. ## Features ### Markdown with a live preview Write on the left, read on the right, and both sides scroll together. Tables, task lists, footnotes and Mermaid diagrams render as you type, and every code block has a copy button. ### Draw diagrams with the mouse Add boxes, drag arrows between them and Forge writes the Mermaid code for you. Flowcharts you wrote by hand open in the same editor. ### JSON: format, validate, explore Format or minify with one click. Errors are underlined as you type, and clicking a key in the tree view selects it in the code and lights up its line. ### JSON path queries Type a path such as $.items[*].name or $..id and Forge selects every match. Sort keys, or turn JSON into CSV or YAML and back. ### CSV that understands your data A color per column, a table view, delimiter and header detection, sorting, deduplication and export to JSON or Markdown. ### Developer tools on a right click Encode and decode Base64, URLs, HTML and JWTs, change letter case, sort lines and hash a selection. ### Regex tester Try a pattern on your own text: matches are outlined, every group gets its own color, a replace preview shows the result, and Copy as Python gives you the code. ### Code shots Turn a selection into a tidy image in your theme colors, with a window frame and a backdrop, ready for a manual, a slide or a chat. ### Snipping tool Capture an area or the whole screen, then mark it up with arrows, shapes, a highlighter and text. Move what you drew, crop, undo and copy. ### Cron, explained in plain words Paste an expression and see it in words, a card per field, the next run times and a clickable cheat sheet. ### Compare two versions Compare a document with its saved version, another tab or the clipboard, or paste two snippets in Quick Diff. Changes within a line are marked too. ### Find in Files Search and replace across a whole folder with regular expressions and filters such as *.py *.json !build. ### Made for code Syntax highlighting for 23 languages, rainbow brackets, live syntax checks and the shortcuts your fingers already know. ### Three themes Forge Dark, Forge Blue and Forge Light, or Follow System to switch with your operating system. ### English and Dutch The whole interface speaks two languages and follows your system by default. Copy System Info makes bug reports easy. ## Built-in tools Format JSON, Minify JSON, JSON tree view, JSON path query, Sort keys, JSON to CSV, JSON to YAML, YAML to JSON, Regex tester, Quick Diff, Code Shot, Snipping tool, Diagram editor, Table of contents, Validate YAML, Pretty print XML, XPath panel, Markdown preview, Mermaid diagrams, CSV table view, CSV to JSON, CSV to Markdown, Unix time to ISO 8601, Base64, URL encode, HTML entities, JWT decode, MD5, SHA-1, SHA-256, SHA-512, UUID v4, UUID v7, camelCase, snake_case, kebab-case, Sort lines, Remove duplicates, Cron explainer, Compare, Compare with clipboard, Find in Files, Regex search, Encodings, LF / CRLF. ## Syntax highlighting 23 languages: Python, JSON, YAML, XML, HTML, CSS, JavaScript, Shell, Markdown, CSV, SQL, C / C++, Java, C#, Properties / INI, Makefile, CMake, Diff, Batch, Perl, Ruby, Lua, TeX. Python, JSON, YAML, XML, TOML and CSV are also checked for errors while you type. ## Download and install ### macOS - Requirement: macOS 11 or later, Apple Silicon - File: `Forge-0.3.0-macos-arm64.dmg` - Install: Open the disk image and drag Forge to Applications. - Note: Not signed by Apple yet: allow the first start in System Settings > Privacy & Security with Open Anyway. ### Linux - Requirement: x86-64, any modern distribution - File: `Forge-0.3.0-linux-x86_64.AppImage` - Install: Make the AppImage executable and run it. No installation needed. - Note: One file with everything inside, including the full Markdown preview with Mermaid. ### Windows - Requirement: Windows 10 or 11, x86-64 - File: `Forge-0.3.0-setup.exe` - Install: Run the setup. It installs per user, no admin rights needed. - Note: Not signed yet: if SmartScreen warns, choose More info and Run anyway. All downloads: https://gitlab.com/bytefulminds/forge/-/releases After installing, Forge checks once a day for a new version and installs it with one click after verifying its SHA-256 checksum. The check can be turned off in Preferences. ### Run from source Requires uv (https://docs.astral.sh/uv/getting-started/installation/), which installs the right Python version. ```sh git clone https://gitlab.com/bytefulminds/forge.git cd forge uv sync uv run forge ``` ## Roadmap ### First release (v0.1.0 · October 2026) - Downloads for macOS, Linux and Windows - JSON, YAML, XML, Markdown and CSV tools - Compare and Find in Files - English and Dutch interface ### Self updating (v0.2.0 · November 2026) - One-click updates, checked with SHA-256 - Near black Forge Dark theme - Cron window with next runs and a cheat sheet - Window buttons that follow your system ### More tools (v0.3.0 · November 2026) - Regex tester, Quick Diff and Compare with Clipboard - Code shots and a snipping tool - Draw Mermaid flowcharts with the mouse - JSON path queries, sort keys and conversions ### Plugins (Coming next) - Every built-in tool already runs on an internal extension API - Opening that API up for your own Python plugins - A manifest and a plugin manager to install them ### Signed builds (Coming next) - Signed and notarized macOS app - Signed Windows installer, no more SmartScreen warning ### More languages (Open for contributions) - Translations are plain TOML files - Tests catch missing strings, so a new language stays complete - Your language could be next ## FAQ ### Is Forge free? Yes, completely. Forge is open source under the GPL-3.0 license: no price, no paid tier, no account and no ads. You can use it, read the code, change it and share it. ### Can I support Forge? Only if you want to, it is never required. If Forge saves you time and you would like to say thanks, you can buy me a coffee on Ko-fi. Reporting bugs, sharing ideas and telling others about Forge helps just as much. [Buy me a coffee on Ko-fi](https://ko-fi.com/bytefulminds) ### Which systems does Forge run on? macOS 11 or later on Apple Silicon, Linux on x86-64 as an AppImage, and Windows 10 or 11 on x86-64 with an installer. You can also run it from source anywhere Python and Qt run. ### Why does my system warn me the first time I open Forge? Forge is not signed with an Apple Developer ID or a Windows code signing certificate yet. On macOS, allow the first start in System Settings > Privacy & Security with Open Anyway. On Windows, choose More info and Run anyway. Signed builds are on the roadmap. ### Does Forge send any data? Forge only asks GitLab once a day whether there is a new version. You can turn this off in Preferences. There is no telemetry and no account. ### How does Forge handle very large files? Files from 2 MB load in the background, and above 20 MB Forge switches off highlighting, wrapping and folding so that logs of 100 MB open in under a second and scroll smoothly. ### Which languages does Forge highlight? Python, JSON, YAML, XML, HTML, CSS, JavaScript, Shell, Markdown, CSV, SQL, C and C++, Java, C#, Properties and INI, Makefile, CMake, Diff, Batch, Perl, Ruby, Lua and TeX. Python, JSON, YAML, XML, TOML and CSV are also checked for errors while you type. ### What is Forge built with? Python with Qt through PyQt6 and QScintilla, the same Scintilla editing engine many classic editors use. Every dependency is pinned to an exact version so every build is the same. ### How can I help? Report bugs and ideas in the issue tracker, add a translation, or send a merge request on GitLab. ## Links - Manual: https://gitlab.com/bytefulminds/forge/-/blob/main/MANUAL.md - Changelog: https://gitlab.com/bytefulminds/forge/-/blob/main/CHANGELOG.md - Issues: https://gitlab.com/bytefulminds/forge/-/issues - Releases: https://gitlab.com/bytefulminds/forge/-/releases