OlaProeis/FerritePublic

A fast, lightweight text editor for Markdown, JSON, YAML, and TOML files. Built with Rust and egui for a native, responsive experience.

AI summary: A fast, lightweight text editor for Markdown, JSON, YAML, and TOML files built with Rust and egui.

Stars
1.9K
+6 today
Forks
108
Watchers
8
Open issues
45
Open PRs
4
Contributors
~26
Commits
387
Branches
6

RustMITCreated Dec 19, 2025Last push 5d agoLatest release v0.3.1+10 stars this week+62 this month

Quick answers

What is Ferrite?
A fast, lightweight text editor for Markdown, JSON, YAML, and TOML files built with Rust and egui.
What does Ferrite do?
Ferrite is a lightning-fast, native text editor designed for developers and technical writers working with structured text formats like Markdown, JSON, YAML, and TOML. Built entirely in Rust using the egui framework, it delivers exceptional performance and a highly responsive user experience across Windows and Linux. The editor offers a rich feature set including a side-by-side split view for live Markdown rendering, executable code blocks, and an integrated terminal. By prioritizing speed and low memory usage through a custom virtual scrolling engine, Ferrite provides a capable, modern alternative to electron-based editors for everyday text and data manipulation tasks.
Who is Ferrite for?
Developers, technical writers, and power users who require a high-performance, native text editor for Markdown and structured data formats. Users need familiarity with hardware description languages and synthesis tools.
How do I get started with Ferrite?
Download the pre-built binary for Windows or Linux from the GitHub Releases page.
How popular is Ferrite on GitHub?
OlaProeis/Ferrite has 1,905 stars and 108 forks on GitHub, and gained 10 stars in the last 7 days.
What license does Ferrite use?
OlaProeis/Ferrite is released under the MIT license.

Star history

since Jul 28, 2026
05001K1.5KJul 2026Sep 2026Oct 2026Nov 2026
1.9K stars as of Nov 17, 2026. Measured daily since Jul 28, 2026; GitHub no longer exposes earlier star timestamps.

Update history

1 recorded
  • Nov 17, 2026New release v0.3.1 (previously v0.3.0).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 2 commits2025-12-20: 1 commit2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 1 commit2026-01-10: 5 commits2026-01-11: 7 commits2026-01-12: 6 commits2026-01-13: 4 commits2026-01-14: 3 commits2026-01-15: 0 commits2026-01-16: 6 commits2026-01-17: 6 commits2026-01-18: 5 commits2026-01-19: 5 commits2026-01-20: 12 commits2026-01-21: 9 commits2026-01-22: 6 commits2026-01-23: 6 commits2026-01-24: 39 commits2026-01-25: 5 commits2026-01-26: 4 commits2026-01-27: 3 commits2026-01-28: 6 commits2026-01-29: 0 commits2026-01-30: 4 commits2026-01-31: 3 commits2026-02-01: 7 commits2026-02-02: 1 commit2026-02-03: 2 commits2026-02-04: 3 commits2026-02-05: 2 commits2026-02-06: 4 commits2026-02-07: 7 commits2026-02-08: 1 commit2026-02-09: 3 commits2026-02-10: 0 commits2026-02-11: 0 commits2026-02-12: 0 commits2026-02-13: 1 commit2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 1 commit2026-02-17: 7 commits2026-02-18: 5 commits2026-02-19: 0 commits2026-02-20: 0 commits2026-02-21: 1 commit2026-02-22: 0 commits2026-02-23: 4 commits2026-02-24: 4 commits2026-02-25: 1 commit2026-02-26: 4 commits2026-02-27: 1 commit2026-02-28: 0 commits2026-03-01: 1 commit2026-03-02: 0 commits2026-03-03: 2 commits2026-03-04: 1 commit2026-03-05: 1 commit2026-03-06: 1 commit2026-03-07: 0 commits2026-03-08: 1 commit2026-03-09: 0 commits2026-03-10: 0 commits2026-03-11: 4 commits2026-03-12: 0 commits2026-03-13: 2 commits2026-03-14: 0 commits2026-03-15: 1 commit2026-03-16: 0 commits2026-03-17: 0 commits2026-03-18: 0 commits2026-03-19: 0 commits2026-03-20: 0 commits2026-03-21: 0 commits2026-03-22: 0 commits2026-03-23: 0 commits2026-03-24: 0 commits2026-03-25: 0 commits2026-03-26: 0 commits2026-03-27: 0 commits2026-03-28: 1 commit2026-03-29: 2 commits2026-03-30: 1 commit2026-03-31: 0 commits2026-04-01: 1 commit2026-04-02: 0 commits2026-04-03: 0 commits2026-04-04: 0 commits2026-04-05: 0 commits2026-04-06: 0 commits2026-04-07: 0 commits2026-04-08: 0 commits2026-04-09: 0 commits2026-04-10: 0 commits2026-04-11: 3 commits2026-04-12: 0 commits2026-04-13: 1 commit2026-04-14: 0 commits2026-04-15: 3 commits2026-04-16: 0 commits2026-04-17: 0 commits2026-04-18: 1 commit2026-04-19: 0 commits2026-04-20: 0 commits2026-04-21: 1 commit2026-04-22: 1 commit2026-04-23: 1 commit2026-04-24: 1 commit2026-04-25: 0 commits2026-04-26: 0 commits2026-04-27: 0 commits2026-04-28: 0 commits2026-04-29: 0 commits2026-04-30: 0 commits2026-05-01: 0 commits2026-05-02: 0 commits2026-05-03: 0 commits2026-05-04: 2 commits2026-05-05: 0 commits2026-05-06: 0 commits2026-05-07: 0 commits2026-05-08: 0 commits2026-05-09: 0 commits2026-05-10: 0 commits2026-05-11: 2 commits2026-05-12: 1 commit2026-05-13: 0 commits2026-05-14: 0 commits2026-05-15: 0 commits2026-05-16: 1 commit2026-05-17: 0 commits2026-05-18: 1 commit2026-05-19: 6 commits2026-05-20: 2 commits2026-05-21: 2 commits2026-05-22: 6 commits2026-05-23: 0 commits2026-05-24: 0 commits2026-05-25: 0 commits2026-05-26: 0 commits2026-05-27: 0 commits2026-05-28: 0 commits2026-05-29: 0 commits2026-05-30: 0 commits2026-05-31: 0 commits2026-06-01: 0 commits2026-06-02: 0 commits2026-06-03: 0 commits2026-06-04: 0 commits2026-06-05: 0 commits2026-06-06: 0 commits2026-06-07: 0 commits2026-06-08: 0 commits2026-06-09: 4 commits2026-06-10: 0 commits2026-06-11: 0 commits2026-06-12: 0 commits2026-06-13: 0 commits2026-06-14: 0 commits2026-06-15: 6 commits2026-06-16: 3 commits2026-06-17: 5 commits2026-06-18: 2 commits2026-06-19: 0 commits2026-06-20: 0 commits2026-06-21: 0 commits2026-06-22: 0 commits2026-06-23: 0 commits2026-06-24: 0 commits2026-06-25: 0 commits2026-06-26: 0 commits2026-06-27: 0 commits2026-06-28: 1 commit2026-06-29: 0 commits2026-06-30: 0 commits2026-07-01: 0 commits2026-07-02: 0 commits2026-07-03: 0 commits2026-07-04: 0 commits2026-07-05: 0 commits2026-07-06: 0 commits2026-07-07: 0 commits2026-07-08: 0 commits2026-07-09: 0 commits2026-07-10: 0 commits2026-07-11: 0 commits2026-07-12: 0 commits2026-07-13: 0 commits2026-07-14: 0 commits2026-07-15: 0 commits2026-07-16: 0 commits2026-07-17: 0 commits2026-07-18: 0 commits2026-07-19: 0 commits2026-07-20: 0 commits2026-07-21: 0 commits2026-07-22: 0 commits2026-07-23: 0 commits2026-07-24: 0 commits2026-07-25: 0 commits2026-07-26: 0 commits2026-07-27: 0 commits2026-07-28: 0 commits2026-07-29: 0 commits2026-07-30: 0 commits2026-07-31: 0 commits2026-08-01: 0 commits2026-08-02: 0 commits2026-08-03: 0 commits2026-08-04: 0 commits2026-08-05: 0 commits2026-08-06: 0 commits2026-08-07: 0 commits2026-08-08: 0 commits2026-08-09: 0 commits2026-08-10: 0 commits2026-08-11: 0 commits2026-08-12: 0 commits2026-08-13: 0 commits2026-08-14: 0 commits2026-08-15: 0 commits2026-08-16: 0 commits2026-08-17: 0 commits2026-08-18: 0 commits2026-08-19: 0 commits2026-08-20: 0 commits2026-08-21: 0 commits2026-08-22: 0 commits2026-08-23: 0 commits2026-08-24: 0 commits2026-08-25: 0 commits2026-08-26: 0 commits2026-08-27: 0 commits2026-08-28: 0 commits2026-08-29: 0 commits2026-08-30: 0 commits2026-08-31: 0 commits2026-09-01: 0 commits2026-09-02: 0 commits2026-09-03: 0 commits2026-09-04: 0 commits2026-09-05: 0 commits2026-09-06: 0 commits2026-09-07: 0 commits2026-09-08: 0 commits2026-09-09: 0 commits2026-09-10: 0 commits2026-09-11: 0 commits2026-09-12: 0 commits2026-09-13: 0 commits2026-09-14: 0 commits2026-09-15: 0 commits2026-09-16: 0 commits2026-09-17: 0 commits2026-09-18: 0 commits2026-09-19: 0 commits2026-09-20: 0 commits2026-09-21: 0 commits2026-09-22: 0 commits2026-09-23: 0 commits2026-09-24: 0 commits2026-09-25: 0 commits2026-09-26: 0 commits2026-09-27: 0 commits2026-09-28: 0 commits2026-09-29: 0 commits2026-09-30: 0 commits2026-10-01: 0 commits2026-10-02: 0 commits2026-10-03: 0 commits2026-10-04: 0 commits2026-10-05: 0 commits2026-10-06: 0 commits2026-10-07: 0 commits2026-10-08: 1 commit2026-10-09: 7 commits2026-10-10: 0 commits2026-10-11: 0 commits2026-10-12: 0 commits2026-10-13: 0 commits2026-10-14: 0 commits2026-10-15: 0 commits2026-10-16: 0 commits2026-10-17: 0 commits2026-10-18: 0 commits2026-10-19: 0 commits2026-10-20: 0 commits2026-10-21: 0 commits2026-10-22: 0 commits2026-10-23: 0 commits2026-10-24: 0 commits2026-10-25: 0 commits2026-10-26: 0 commits2026-10-27: 0 commits2026-10-28: 0 commits2026-10-29: 0 commits2026-10-30: 0 commits2026-10-31: 0 commits2026-11-01: 0 commits2026-11-02: 0 commits2026-11-03: 0 commits2026-11-04: 0 commits2026-11-05: 0 commits2026-11-06: 0 commits2026-11-07: 0 commits2026-11-08: 0 commits2026-11-09: 7 commits2026-11-10: 2 commits2026-11-11: 4 commits2026-11-12: 0 commits2026-11-13: 0 commits2026-11-14: 0 commits2026-11-15: 0 commits2026-11-16: 0 commits2026-11-17: 0 commits2026-11-18: 0 commits2026-11-19: 0 commits2026-11-20: 0 commits2026-11-21: 0 commits
303 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Permissive license

    MIT

What Ferrite does

Ferrite is a lightning-fast, native text editor designed for developers and technical writers working with structured text formats like Markdown, JSON, YAML, and TOML. Built entirely in Rust using the egui framework, it delivers exceptional performance and a highly responsive user experience across Windows and Linux. The editor offers a rich feature set including a side-by-side split view for live Markdown rendering, executable code blocks, and an integrated terminal. By prioritizing speed and low memory usage through a custom virtual scrolling engine, Ferrite provides a capable, modern alternative to electron-based editors for everyday text and data manipulation tasks.

Developers, technical writers, and power users who require a high-performance, native text editor for Markdown and structured data formats. Users need familiarity with hardware description languages and synthesis tools.

  • WYSIWYG Markdown Editing: Edit markdown with live preview, one-click block switching, and full syntax highlighting.
  • Executable Code Blocks: Run shell or Python scripts directly from the rendered markdown preview with inline output.
  • Multi-Format Support: Provide native, optimized support for Markdown, JSON, CSV, YAML, and TOML file types.
  • High Performance: Utilize a custom virtual scrolling engine built in Rust to handle massive files with minimal RAM footprint.
  • Split View Modes: Work with side-by-side raw and rendered views featuring bidirectional live scroll synchronization.
  • Integrated Terminal: Access multiple terminal instances directly within the workspace with tiling and layout persistence.

Where teams use it

Technical Documentation

Writers crafting comprehensive documentation using live Markdown rendering and embedded Mermaid diagrams.

Data File Inspection

Developers rapidly opening and editing massive JSON or CSV files that would stall traditional Electron-based editors.

Interactive Prototyping

Executing small Python snippets directly from a Markdown file during an exploratory coding session.

Distraction-Free Writing

Enabling Zen Mode to focus entirely on writing a blog post in a clean, centered text environment.

Getting started: Download the pre-built binary for Windows or Linux from the GitHub Releases page.

README

master branch

Ferrite

English | 简体中文

Website Latest Release License GitHub Stars GitHub Issues Translation Status

getferrite.dev — Official website with downloads, features, and documentation

A fast, lightweight text editor for Markdown, JSON, YAML, and TOML files. Built with Rust and egui for a native, responsive experience.

⚠️ Platform Note: Ferrite is developed and tested on Windows and Linux. macOS support is experimental. If you encounter issues, please report them.

🛡️ Code Signing & Antivirus

Starting with v0.2.6.1, all Windows releases are digitally signed with a certificate from SignPath Foundation. This means:

  • Windows SmartScreen recognizes the publisher — no more "Unknown publisher" warnings
  • Antivirus false positives are significantly reduced thanks to the trusted code signature
  • Integrity verification — you can verify that the binary hasn't been tampered with

Previous False Positives

Older unsigned builds may still trigger antivirus detections. This was caused by:

  • Live Pipeline feature: Uses cmd.exe /C on Windows for shell commands, which ML-based detection can misidentify
  • Rust compilation patterns: Rust binaries can trigger heuristic detections due to unique characteristics

We've addressed this through code signing, build profile adjustments (disabled symbol stripping, speed optimization), and reporting to Microsoft's Security Intelligence portal.

If You're Still Affected

If Windows Defender quarantines Ferrite:

  1. Upgrade: Download the latest signed release from GitHub Releases
  2. Verify the signature: Right-click ferrite.exe → Properties → Digital Signatures → should show "SignPath Foundation"
  3. Check VirusTotal: Upload the file to VirusTotal — signed builds should show clean results

Ferrite does NOT access passwords, browser data, or make unsolicited network connections. The only network access is the manual "Check for Updates" button (Settings → About), which contacts the GitHub Releases API when you click it. The application only accesses files you explicitly open.

🍎 macOS Installation & Gatekeeper

GitHub Release .dmg / .tar.gz builds are packaged as Ferrite.app but are not signed with an Apple Developer ID and are not notarized (CI limitation). Gatekeeper, especially on macOS 15.x (Sequoia / 15.6+), may block or warn on first launch—see GitHub #130 and the workarounds below.

📖 Full troubleshooting: docs/install/macos.md

Option 1: Homebrew (often smoothest)

brew tap olaproeis/ferrite
brew install --cask ferrite

Homebrew typically avoids quarantine friction compared to raw GitHub downloads.

Option 2: DMG / tar.gz from GitHub Releases + workaround

  1. Download from Releases:
    • Apple Silicon: ferrite-macos-arm64.dmg or .tar.gz
    • Intel: ferrite-macos-x64.dmg or .tar.gz
  2. Copy Ferrite.app to Applications (or another folder you prefer).
  3. First launch — pick one:
    • Terminal (most reliable): xattr -dr com.apple.quarantine /Applications/Ferrite.app — use the real path if the app is not under /Applications.
    • Finder: Control-click Ferrite.app → Open → Open (may not work on every macOS 15.x configuration).
    • System Settings → Privacy & Security: after a blocked launch, use Open Anyway if shown.

Why this happens

Apple expects apps distributed outside the Mac App Store to be signed with a Developer ID certificate and notarized. Ferrite is open source—you can audit the code and build from source—but paid enrollment and CI wiring are still pending for GitHub-hosted macOS builds.

🤖 AI-Assisted Development

This project is 100% AI-generated code. All Rust code, documentation, and configuration was written by Claude (Anthropic) via Cursor with MCP tools.

About the AI workflow

My Role

  • Product direction — Deciding what to build and why
  • Testing — Running the app, finding bugs, verifying features
  • Review — Reading generated code, understanding what it does
  • Orchestration — Managing the AI workflow effectively

The Workflow

  1. Idea refinement — Discuss concepts with multiple AIs (Claude, Perplexity, Gemini Pro)
  2. PRD creation — Generate requirements using Task Master
  3. Task execution — Claude Opus handles implementation (preferring larger tasks over many subtasks)
  4. Session handover — Structured prompts maintain context between sessions
  5. Human review — Every handover is reviewed; direction adjustments made as needed

📖 Full details: AI Development Workflow

Open Process

The actual prompts and documents used to build Ferrite are public:

Document Purpose
current-handover-prompt.md Active session context
ai-workflow/ Full workflow docs, PRDs, historical handovers
handover/ Reusable handover templates

This transparency is intentional — I want others to learn from (and improve upon) this approach.

Screenshots

Ferrite Demo

Raw Editor Split View Zen Mode
Raw Editor Split View Zen Mode

✨ v0.3.1 (latest, November 11, 2026): Inline YouTube video embeds. Multi-window. Mermaid second wave (git graph rewrite, diagram popup, fit-to-pane, autonumber, linkStyle interpolate basis). CSV cell editing. GitHub HTML subset and HTML entities. GFM table alignment. Preview lock. Search-first Settings with corruption-safe config.json. Spellcheck. Separate Rendered and terminal fonts. Tab / Shift+Tab indent. Emoji fallback. Clipboard image paste. Reload from Disk. CRLF preserved on edit and save. Arrow keys and Find in the rendered preview. macOS Finder Open With. Typing-run undo. Linux QA close-out (four rounds). Late fixes: encoding save/switch no longer drops or mangles text (#197, #198), CSV cell commits keep mid-file Raw edits (#196), rendered list items show nested blocks and keep wrapped lines. LSP stays deferred to v0.3.2+. Linux YouTube Error 153 is deferred to v0.3.2. See CHANGELOG.md § 0.3.1 and ROADMAP.md.

📦 v0.3.0: eframe / egui 0.34.2 platform refresh. PDF + themed HTML export. Executable code blocks (▶ Run). Rendered edit session. Split-view scroll sync. User accent color. Mermaid insert toolbar and flowchart polish. Phosphor icons. Session recovery. Quick note workflow. See CHANGELOG.md § 0.3.0.

📦 v0.2.6 Highlights: Custom Editor Engine with virtual scrolling (80MB file uses ~80MB RAM), Multi-Cursor Editing, Code Folding, IME/CJK input improvements.

Features

Core Editing

  • WYSIWYG Markdown Editing - Edit markdown with live preview, one-click block switching between headings, paragraphs, lists, and table cells in rendered mode, click-to-edit formatting, and syntax highlighting. (v0.3.1) Arrow Up/Down moves between rendered blocks (a locked preview scrolls instead); the status bar Ln/Col follows that caret; list items show nested paragraphs, code, quotes, and tables, and a hard-wrapped item keeps its continuation lines
  • Executable Code Blocks - Run shell or Python fenced blocks from rendered/split preview (▶ Run); inline ANSI output, timeout, and Stop (opt-in via Settings; first-run consent)
  • YouTube Video Embeds (v0.3.1) - Use {{video URL}} on its own line for inline playback in the rendered preview (primary window); optional width=640 / height=360 params set player size (width-only keeps 16:9); bare YouTube links stay normal clickable links; other windows and untrusted hosts show a thumbnail that opens in your browser
  • Multi-Format Support - Native support for Markdown, JSON, CSV, YAML, and TOML files
  • Multi-Encoding Support - Auto-detect and preserve file encodings (UTF-8, Latin-1, Shift-JIS, Windows-1252, GBK, and more). (v0.3.1) Windows CRLF is kept through edit and save; switching encoding on a dirty file asks first; a legacy encoding that cannot store a character is refused instead of writing &#NNNN;
  • Tree Viewer - Hierarchical view for JSON/YAML/TOML with inline editing, expand/collapse, and path copying
  • Find & Replace - Search with regex support and match highlighting. (v0.3.1) Next/previous scrolls the Rendered and Split preview to the match; literal search is Unicode case-folding (istanbul matches İstanbul)
  • Go to Line (Ctrl+G) - Quick navigation to specific line number
  • Undo/Redo - Full undo/redo support per tab; (v0.3.1) a run of typing undoes as one step instead of one keystroke at a time
  • Reload from Disk (v0.3.1) - Ctrl+Shift+R replaces the active tab with the file on disk (asks first if the tab has unsaved changes); encoding and line endings are re-detected
  • GitHub HTML Subset (v0.3.1) - <div align>, <details>/<summary>, <br>, <kbd>, <sup>, <sub>, and sized <img> render in the preview; HTML entities (&amp;, &rarr;, &#…;) show as characters
  • GFM Table Alignment (v0.3.1) - Per-column left/center/right alignment in rendered tables, with a toolbar control that writes the delimiter row

View Modes

  • Split View - Side-by-side raw editor and rendered preview with resizable divider; both panes are fully editable; optional live scroll sync (minimap Sync / 2-way controls)
  • Zen Mode - Distraction-free writing with centered text column
  • Multi-Window (v0.3.1) - Ctrl+Shift+N opens a second window with its own tab strip; window layout and per-window tabs are restored on restart
  • Preview Lock (v0.3.1) - Padlock on the preview pane (Insert) makes the rendered side read-only while the raw pane stays editable; Up/Down scroll the locked preview

Editor Features

  • Syntax Highlighting - Full-file syntax highlighting for 100+ languages (Rust, Python, JavaScript, Go, TypeScript, PowerShell, and more)
  • Code Folding - Fold/unfold regions with gutter indicators (▶/▼) for headings, code blocks, and lists; collapsed content is hidden
  • Semantic Minimap - Navigation panel with clickable header labels, content type indicators, and text density bars (switchable to VS Code-style pixel view)
  • Multi-Cursor Editing - Ctrl+Click to add multiple cursors; type, delete, and navigate at all positions simultaneously
  • Bracket Matching - Highlight matching brackets ()[]{}<> and emphasis pairs ** __
  • Auto-close Brackets & Quotes - Type (, [, {, ", or ' to get matching pair; selection wrapping supported
  • Duplicate Line (Ctrl+Shift+D) - Duplicate current line or selection
  • Move Line Up/Down (Alt+↑/↓) - Rearrange lines without cut/paste
  • Smart Paste for Links - Select text then paste URL to create [text](url) markdown link
  • Drag & Drop Images - Drop images into editor to auto-save to ./assets/ and insert markdown link
  • Paste Images from the Clipboard (v0.3.1) - Ctrl+V with an image on the clipboard saves a PNG under ./assets/ and inserts the markdown link. An untitled note with no workspace opens Save As first; nothing is written if you cancel
  • Tab / Shift+Tab Indent (v0.3.1) - Indent or outdent the selected lines in the raw editor (multi-cursor aware; spaces or tabs per settings)
  • Word Wrap Toggle (v0.3.1) - Alt+Z flips word wrap from anywhere
  • Emoji Fallback (v0.3.1) - Unicode emoji render (monochrome) in Raw and Rendered instead of missing-glyph boxes
  • Table of Contents - Generate/update TOC from headings with <!-- TOC --> block (Ctrl+Shift+U)
  • Snippets - Text expansions like ;date → current date, ;time → current time, plus custom snippets
  • Auto-Save - Configurable auto-save with temp-file safety
  • Line Numbers - Optional line number gutter
  • Configurable Line Width - Limit text width for readability (80/100/120 or custom)
  • Custom Font Selection - Choose preferred fonts for editor and UI; important for CJK regional glyph preferences; (v0.3.1) the Rendered view can use a different font from the raw editor
  • Keyboard Shortcut Customization - Rebind shortcuts via settings panel
  • Spellcheck (v0.3.1, off by default) - Hunspell English in the raw editor: dotted underlines, right-click suggestions, personal dictionary, and session ignore. Rendered/Split preview is not checked.
  • Linux middle-click paste (v0.3.1) - On Linux, a selection in the raw editor is the primary selection; middle-click pastes it. The setting is under Editor and does nothing on Windows or macOS

MermaidJS Diagrams

Native rendering of 11 diagram types directly in the preview:

  • Flowchart, Sequence, Pie, State, Mindmap
  • Class, ER, Git Graph, Gantt, Timeline, User Journey
  • Insert templates - Format toolbar → Insert → Mermaid… for starter snippets per diagram type
  • Inline validation - Parse errors in preview with squiggles on broken mermaid blocks in the raw editor
  • Flowchart polish - Improved edge routing, extra shapes, style / classDef support; state diagrams support fork/join and history nodes
  • Diagram popup viewer (v0.3.1) - Click a rendered diagram to open a large zoom/pan viewer; wide diagrams shrink to fit the preview with a per-diagram Fit/Native toggle
  • Git graph rewrite (v0.3.1) - Tags, branch types, cherry-pick, and LR/TB orientation; sequence diagrams support autonumber; flowcharts support linkStyle … interpolate basis and %% @pos layout hints

v0.3.1 Mermaid update: Popup zoom/pan viewer, fit-to-pane with a per-diagram Fit/Native toggle, git graph rewrite, sequenceDiagram autonumber, and flowchart linkStyle … interpolate basis (straight diagonals draw as S-curves; a straight chain stays straight) plus %% @pos hints. The v0.3.0 insert toolbar, F1 syntax help, inline validation, and edge routing are unchanged. Dense diagrams and subgraph layout can still differ from mermaid.js. See ROADMAP.md.

CSV/TSV Viewer

  • Native Table View - View CSV and TSV files in a formatted table with fixed-width column alignment
  • Rainbow Column Coloring - Alternating column colors for improved readability
  • Delimiter Detection - Auto-detect comma, tab, semicolon, and pipe separators
  • Header Row Detection - Intelligent detection and highlighting of header rows
  • Cell Editing (v0.3.1) - Double-click a cell to edit it in the table view (small files); Tab / Shift+Tab and arrow keys move between cells; a Raw edit in the middle of the file survives the next cell commit; large files are edited in Raw view

Workspace Features

  • Workspace Mode - Open folders with file tree, quick switcher (Ctrl+P), and search-in-files (Ctrl+Shift+F)
  • Workspace File Index - Ctrl+P and Search in Files scan the entire workspace in the background (not only expanded folders in the tree)
  • Quick Note Workflow - Pathless scratch tabs: quit without a save dialog by default; closing a tab still prompts; unsaved notes persist via session recovery (Settings → Files)
  • Git Integration - Visual status indicators (modified, added, untracked, ignored) with auto-refresh on save, focus, and file changes
  • Session Persistence - Restore open tabs, cursor positions, and scroll offsets on restart; hardened crash recovery with identity checks and disk-conflict banner
  • Tab Context Menu (v0.3.1) - Right-click a tab for New Tab, Close Tab, Copy Path, and Reveal in file manager; hover shows the full path
  • Open Links from the Preview (v0.3.1) - Ctrl/Cmd+click or middle-click a link in the rendered view: web links open in the browser, local files and folders in the file manager
  • Single Instance - Files opened from the file manager join the running window; (v0.3.1) Settings → Files can allow multiple instances, and ferrite --new-instance always starts a separate process

Terminal Workspace

  • Integrated Terminal - Multiple instances with shell selection (PowerShell, CMD, WSL, bash)
  • Tiling & Splitting - Create complex 2D grids with horizontal and vertical splits
  • Smart Maximize - Temporarily maximize any pane to focus on work (Ctrl+Shift+M)
  • Layout Persistence - Save and load your favorite terminal arrangements to JSON files
  • Theming & Transparency - Custom color schemes (Dracula, etc.) and background opacity
  • Terminal Font & Nerd Font Symbols (v0.3.1) - Pick a system font for the terminal (Settings → Terminal); Powerline / private-use glyphs fall back to an installed Nerd Font
  • Drag-and-Drop Tabs - Reorder terminals with visual feedback
  • AI-Ready - Visual "breathing" indicator when terminal is waiting for input (perfect for AI agents)

Additional Features

  • Light & Dark Themes - Beautiful themes with runtime switching; custom Ferrite accent color (Settings / Welcome) for headings, selection, tabs, and chrome
  • Search-First Settings (v0.3.1) - Instantly search every setting (including keyboard shortcuts) with category filter chips; default view shows recently changed settings and essentials; a changed setting is written within about half a second
  • Corruption-Safe Settings (v0.3.1) - One invalid value resets only that setting; an unreadable config.json is kept as config.json.corrupt-<timestamp> instead of being overwritten; saves are atomic with a .bak of the previous file
  • Markdown Cheat Sheet (v0.3.1) - Ribbon MD button opens a compact syntax and shortcut reference
  • Frontmatter Properties Card (v0.3.1) - YAML frontmatter renders as a read-only properties panel in the preview
  • Document Outline & Statistics - Navigate with outline panel; tabbed statistics showing word count, reading time, heading/link/image counts
  • Export & Print - Export to PDF or themed HTML (options dialog, Mermaid as SVG); print preview opens a temp PDF in the in-app viewer; copy as HTML
  • Formatting Toolbar - Quick access to bold, italic, headings, lists, links, Mermaid insert, and more
  • Phosphor Icons - Consistent icon font across ribbon, toolbar, panels, and preview controls
  • Live Pipeline - Pipe JSON/YAML content through shell commands (for developers)
  • Custom Window - Borderless window with custom title bar and resize handles; (v0.3.1) Linux and macOS can switch to the system title bar (Settings → Appearance, restart required)
  • Recent Files & Folders - Click filename in status bar to access recently opened files and workspace folders
  • CJK Paragraph Indentation - First-line indentation options for Chinese (2 chars) and Japanese (1 char) writing conventions

Installation

Pre-built Binaries

Download the latest release for your platform from GitHub Releases.

Platform Download Notes
Windows ferrite-windows-x64.msi Recommended - full installer with Start Menu
Windows ferrite-portable-windows-x64.zip Portable - extract anywhere, run from USB
Linux (Debian/Ubuntu) ferrite-editor_amd64.deb For Debian, Ubuntu, Mint, Pop!_OS
Linux (Fedora/RHEL) ferrite-editor.x86_64.rpm For Fedora, RHEL, CentOS, Rocky
Linux ferrite-linux-x64.tar.gz Universal - works on any distro
macOS (Apple Silicon) ferrite-macos-arm64.dmg Recommended - drag to Applications (M1/M2/M3)
macOS (Apple Silicon) ferrite-macos-arm64.tar.gz Alternative - contains Ferrite.app bundle
macOS (Intel) ferrite-macos-x64.dmg Recommended - drag to Applications
macOS (Intel) ferrite-macos-x64.tar.gz Alternative - contains Ferrite.app bundle
Windows Installation
MSI Installer (Recommended)

Download ferrite-windows-x64.msi and run it. This will:

  • Install Ferrite to C:\Program Files\Ferrite
  • Add Start Menu shortcut with icon
  • Enable easy uninstall via Windows Settings
  • Store settings in %APPDATA%\ferrite\
Portable (ZIP)

Download ferrite-portable-windows-x64.zip and extract anywhere. The zip includes:

  • ferrite.exe - the application
  • portable/ - folder for all your settings
  • README.txt - quick start guide

True portable mode: All configuration, sessions, and data are stored in the portable folder next to the executable. Nothing is written to %APPDATA% or the Windows registry. Perfect for USB drives or trying Ferrite without installation.

Linux Installation
Debian/Ubuntu/Mint (.deb)
# Download the .deb file, then install with:
sudo apt install ./ferrite-editor_amd64.deb

# Or using dpkg:
sudo dpkg -i ferrite-editor_amd64.deb
Fedora/RHEL/CentOS (.rpm)
# Download the .rpm file, then install with:
sudo dnf install ./ferrite-editor.x86_64.rpm

# Or using rpm:
sudo rpm -i ferrite-editor.x86_64.rpm

Both .deb and .rpm packages will:

  • Install Ferrite to /usr/bin/ferrite
  • Add desktop entry (appears in your app menu)
  • Register file associations for .md, .json, .yaml, .toml files
  • Install icons for the system
Arch Linux (AUR)

Ferrite on AUR Ferrite-bin on AUR

Ferrite is available on the AUR:

# Release package
yay -Sy ferrite

# Binary package
yay -Sy ferrite-bin
Nix / NixOS (official flake)
# Run Ferrite directly from GitHub (no install)
nix run github:OlaProeis/Ferrite

# Drop into a shell that exposes ferrite in PATH
nix shell github:OlaProeis/Ferrite

From a local clone:

# Build package output
nix build .#ferrite
./result/bin/ferrite

# Enter development shell (Rust toolchain + system deps)
nix develop
Other Linux (tar.gz)
tar -xzf ferrite-linux-x64.tar.gz
./ferrite
Known Issues

Emoji appear monochrome (not full colour)

Ferrite’s text engine (egui/epaint) rasterises outline fonts only; OS colour emoji fonts (Noto Color Emoji, Segoe UI Emoji) do not produce full-colour glyphs in the editor or preview. Emoji should still appear as monochrome symbols where an outline exists; some sequences (flags, ZWJ) may degrade. See docs/technical/platform/emoji-rendering-limitation.md.

Inline YouTube playback shows "Error 153" on Linux (deferred to v0.3.2)

On Linux the embedded player (WebKitGTK) is refused by YouTube with Error 153: Video player configuration error, and shows a black rectangle when offline. Windows playback is unaffected. Watch the video in your browser from the thumbnail. See CHANGELOG.md § 0.3.1 → Deferred.

Keyboard not working on Ubuntu 24.04 LTS (GNOME/Wayland)

Keyboard input does not work when Ferrite is launched under GNOME on Wayland (Ubuntu 24.04 LTS and similar). As a workaround, launch Ferrite with WAYLAND_DISPLAY unset to force X11 mode:

env -u WAYLAND_DISPLAY ferrite

To make this permanent for your desktop launcher, create a user-level desktop entry override:

mkdir -p ~/.local/share/applications
cp /usr/share/applications/ferrite-editor.desktop ~/.local/share/applications/ferrite-editor.desktop

Then edit ~/.local/share/applications/ferrite-editor.desktop and change the Exec line to:

Exec=env -u WAYLAND_DISPLAY ferrite %F
macOS Installation
DMG Installer (Recommended)

Download the .dmg for your Mac:

  • Apple Silicon (M1/M2/M3/M4): ferrite-macos-arm64.dmg
  • Intel: ferrite-macos-x64.dmg

Open the DMG and drag Ferrite.app to the Applications folder. Launch from Launchpad or Spotlight.

From tar.gz (Alternative)
# Apple Silicon
tar -xzf ferrite-macos-arm64.tar.gz
cp -R Ferrite.app /Applications/

# Intel
tar -xzf ferrite-macos-x64.tar.gz
cp -R Ferrite.app /Applications/

Gatekeeper (GitHub downloads): Unsigned / non-notarized CI builds may be blocked on macOS 15.x. See docs/install/macos.md — quickest fix: xattr -dr com.apple.quarantine /Applications/Ferrite.app (adjust path). Tracked: #130.

Build from Source
Prerequisites
  • Rust 1.92+ - Install from rustup.rs (pinned via rust-toolchain.toml)
  • Platform-specific dependencies:

Nix users: you can skip manual dependency installation and use nix develop from the repository root (see flake.nix).

Windows:

  • Visual Studio Build Tools 2019+ with C++ workload

Linux:

# Ubuntu/Debian
sudo apt install build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev libsoup-3.0-dev libxcb-shape0-dev libxcb-xfixes0-dev libfontconfig1-dev

# Fedora
sudo dnf install gcc pkg-config gtk3-devel webkit2gtk4.1-devel libsoup3-devel libxcb-devel fontconfig-devel

# Arch
sudo pacman -S base-devel pkg-config gtk3 webkit2gtk-4.1 libsoup3 libxcb fontconfig

v0.3.1 and later: WebKitGTK 4.1 and libsoup 3 are required for the video-embed WebView. The Ubuntu/Debian line matches what CI installs; the Fedora and Arch package names are the usual equivalents and have not been verified on those distros for this release.

macOS:

xcode-select --install
Build
# Clone the repository
git clone https://github.com/OlaProeis/Ferrite.git
cd Ferrite

# Build release version (optimized)
cargo build --release

# The binary will be at:
# Windows: target/release/ferrite.exe
# Linux/macOS: target/release/ferrite

# macOS: Create .app bundle (optional)
cargo install cargo-bundle
cargo bundle --release
# Bundle will be at: target/release/bundle/osx/Ferrite.app

macOS "Open With": As of v0.3.1, double-click and Finder "Open With" open files in Ferrite tabs (best-effort workaround for eframe/winit limitations). If it fails on your setup, use the Terminal escape hatch open -a Ferrite path/to/file.md or File > Open within the app — see docs/install/macos.md.

Development Builds: Building from the main branch gives you the latest features before they're officially released. These builds are untested and may contain bugs. For stable versions, download from GitHub Releases.

Usage

# Open a file
ferrite path/to/file.md

# Open a folder as workspace
ferrite path/to/folder/
More CLI options
# Run from source
cargo run --release

# Or run the binary directly
./target/release/ferrite

# Open multiple files as tabs
./target/release/ferrite file1.md file2.md

# Start a separate process even if Ferrite is already running (v0.3.1)
./target/release/ferrite --new-instance

# Show version
./target/release/ferrite --version

# Show help
./target/release/ferrite --help

See docs/cli.md for full CLI documentation.

View Modes

Ferrite supports three view modes for Markdown files:

  • Raw - Plain text editing with syntax highlighting
  • Rendered - WYSIWYG editing with rendered markdown
  • Split - Side-by-side raw editor and live preview

Toggle between modes using the toolbar buttons or keyboard shortcuts.

Keyboard Shortcuts

Shortcut Action
Ctrl+N New file
Ctrl+O Open file
Ctrl+S Save file
Ctrl+W Close tab
Ctrl+P Quick file switcher
Ctrl+F Find
Ctrl+G Go to line
Ctrl+, Open settings
All Keyboard Shortcuts

File Operations

Shortcut Action
Ctrl+N New file
Ctrl+O Open file
Ctrl+S Save file
Ctrl+Shift+S Save as
Ctrl+W Close tab
Ctrl+Shift+R Reload from disk (v0.3.1)
Ctrl+Shift+N New window (v0.3.1)
F12 Open workspace
Shift+F12 Close workspace (was F12 before v0.3.1)

Navigation

Shortcut Action
Ctrl+Tab Next tab
Ctrl+Shift+Tab Previous tab
Ctrl+P Quick file switcher (workspace)
Ctrl+Shift+F Search in files (workspace)

Editing

Shortcut Action
Ctrl+Z Undo
Ctrl+Y / Ctrl+Shift+Z Redo
Ctrl+F Find
Ctrl+H Find and replace
Ctrl+G Go to line
Ctrl+Shift+D Duplicate line
Alt+↑ Move line up
Alt+↓ Move line down
Ctrl+B Bold
Ctrl+I Italic
Ctrl+K Insert link
Ctrl+Shift+7 Numbered list (was Ctrl+Shift+N before v0.3.1)
Tab / Shift+Tab Indent / outdent selected lines (v0.3.1)

View

Shortcut Action
F11 Toggle Zen mode
F10 Toggle fullscreen
Alt+Z Toggle word wrap (v0.3.1)
Insert Toggle preview lock (v0.3.1)
Ctrl+, Open settings
Ctrl+Shift+[ Fold all
Ctrl+Shift+] Unfold all

Terminal Workspace

Terminal shortcuts are context-aware; they work when the terminal panel is focused.

Shortcut Action
Ctrl+Tab / Ctrl+Shift+Tab Cycle through terminal tabs
Ctrl+1-9 Switch to specific terminal tab
Ctrl+Arrow Keys Move focus between split panes
Ctrl+Shift+M Toggle Maximize Pane (Zoom)
Ctrl+L Clear terminal screen
Ctrl+Shift+C Copy selection / screen
Ctrl+Shift+V Paste to terminal
Ctrl+W / Ctrl+F4 Close focused pane (auto-collapses splits)
Double-click Tab Rename terminal

Configuration

Access settings via Ctrl+, or the gear icon. The Settings tab is search-first: type to instantly filter every setting (including keyboard shortcuts), or narrow by category with filter chips. The default view surfaces your recently changed settings plus the most common "Essentials".

Configuration details

Settings are stored in platform-specific locations:

  • Windows: %APPDATA%\ferrite\
  • Windows Portable: portable\ folder next to ferrite.exe
  • Linux: ~/.config/ferrite/
  • macOS: ~/Library/Application Support/ferrite/

Portable Mode (Windows): If a portable folder exists next to the executable, Ferrite automatically uses it for all configuration instead of %APPDATA%. This makes Ferrite fully self-contained - perfect for USB drives.

Workspace settings are stored in .ferrite/ within the workspace folder.

Settings Panel

  • Instant search: Type to filter all settings by name or keyword (e.g. "lang" finds Language, "zoom" finds Font Size); individual keyboard shortcuts are searchable too. Ctrl+F focuses the search field, Esc clears it
  • Filter chips: One-click category filters — Appearance, Editor, Files, Keyboard, Terminal — with live match counts while searching
  • Recently Changed + Essentials: The default view shows the settings you touched most recently, followed by the same curated essentials as the Welcome screen
  • About: Version info, update check, and project links live behind the About button in the top-right corner
  • Categories: Appearance (theme, accent color, language, fonts, view mode), Editor (word wrap, line numbers, minimap, brackets, folding, syntax highlighting, line width), Files (auto-save, session restore, recent files), Keyboard (rebindable shortcuts), Terminal

Roadmap

See ROADMAP.md for planned features and known issues.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Help Translate

Ferrite is being translated into multiple languages with help from the community.

Translation Status

Help translate Ferrite on Weblate - no coding required!

Quick Start for Contributors
# Fork and clone
git clone https://github.com/YOUR_USERNAME/Ferrite.git
cd Ferrite

# Create a feature branch
git checkout -b feature/your-feature

# Make changes, then verify
cargo fmt
cargo clippy
cargo test
cargo build

# Optional (Nix users): validate flake outputs
nix flake check

# Commit and push
git commit -m "feat: your feature description"
git push origin feature/your-feature

Tech Stack

Built with Rust 1.92+, egui/eframe for GUI, comrak for Markdown parsing, ropey for rope-based text editing, and syntect for syntax highlighting.

Full tech stack
Component Technology
Language Rust 1.92+
GUI Framework egui 0.34 + eframe 0.34
Text Buffer ropey 1.6 (rope data structure)
Markdown Parser comrak 0.22
Syntax Highlighting syntect 5.1 + two-face 0.5
Git Integration git2 0.19
Terminal PTY portable-pty 0.8
Terminal ANSI Parser vte 0.13
Encoding Detection encoding_rs 0.8 + chardetng 0.1
Internationalization rust-i18n 3 + sys-locale 0.3
CLI Parsing clap 4
File Dialogs rfd 0.14
Clipboard arboard 3
File Watching notify 6
Fuzzy Matching fuzzy-matcher 0.3
HTTP Client ureq 2 (update checker)
Hashing blake3 1.5 (Mermaid caching)
Date/Time chrono 0.4
CSV Parsing csv 1.3
Color Palette palette 0.7
Font Enumeration font-kit 0.14
Allocator (Windows) mimalloc 0.1
Allocator (Unix) tikv-jemallocator 0.6

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Libraries

  • egui and eframe - Immediate mode GUI and native window integration
  • ropey - Rope text buffer for large-file editing
  • comrak - CommonMark + GFM compatible Markdown parser
  • syntect and two-face - Syntax highlighting and extra language definitions
  • harfrust - OpenType text shaping for complex scripts
  • git2 - libgit2 bindings for Rust
  • portable-pty and vte - Integrated terminal (PTY and ANSI parsing)
  • image - Raster image decoding (markdown preview and image viewer)
  • hayro - Pure Rust PDF rasterization (PDF viewer tabs)
  • rust-i18n - Internationalization
  • Inter and JetBrains Mono fonts

Development Tools

  • Claude (Anthropic) - AI assistant that wrote the code
  • Cursor - AI-powered code editor
  • Task Master - AI task management for development workflows

Contributors

Sponsors

SignPath Free code signing on Windows provided by SignPath.io, certificate by SignPath Foundation
Weblate Hosted translations provided by Weblate on Hosted Weblate (gratis libre project plan)

If you find Ferrite useful, consider supporting its development.

View on GitHub

Recent activity

commits and pull requests

Recent open issues

view all

Releases and announcements

18 total
  1. Ferrite v0.3.1v0.3.1Nov 11, 2026771 downloads

    ## What's Changed * feat: open local markdown links in file manager by @starSumi in https://github.com/OlaProeis/Ferrite/pull/157 * ci: provision linux webview dependencies by @starSumi in https://github.com/OlaProeis/Ferrite/pull/156 * feat: improve rendered markdown interactions by @starSumi in https://github.com/OlaProeis/Ferrite/pull/158 * fix: stabilize mermaid subgraph title width by @starSumi in https://github.com/OlaProeis/Ferrite/pull/159 * fix: handle Windows verbatim git paths by @starSumi in https://github.com/OlaProeis/Ferrite/pull/160 * Fix Windows git untracked status for canonicalized paths by @starSumi in https://github.com/OlaProeis/Ferrite/pull/161 ## New Contributors * @starSumi made their first contribution in https://github.com/OlaProeis/Ferrite/pull/157 **Full Changelog**: https://github.com/OlaProeis/Ferrite/compare/v0.3.0...v0.3.1

  2. Ferrite v0.3.0v0.3.0May 22, 202611.9K downloads

    ## What's Changed * Translations update from Hosted Weblate by @weblate in https://github.com/OlaProeis/Ferrite/pull/123 * Translations update from Hosted Weblate by @weblate in https://github.com/OlaProeis/Ferrite/pull/134 * Translations update from Hosted Weblate by @weblate in https://github.com/OlaProeis/Ferrite/pull/136 * fix: scroll to document start/end on Ctrl+Home/End in Rendered view by @moabtools in https://github.com/OlaProeis/Ferrite/pull/137 * Translations update from Hosted Weblate by @weblate in https://github.com/OlaProeis/Ferrite/pull/138 ## New Contributors * @moabtools made their first contribution in https://github.com/OlaProeis/Ferrite/pull/137 **Full Changelog**: https://github.com/OlaProeis/Ferrite/compare/v0.2.9...v0.3.0

  3. Ferrite v0.2.9v0.2.9Apr 23, 20263.1K downloads

    ## What's Changed * Translations update from Hosted Weblate by @weblate in https://github.com/OlaProeis/Ferrite/pull/104 **Full Changelog**: https://github.com/OlaProeis/Ferrite/compare/v0.2.8...v0.2.9

  4. Ferrite v0.2.8v0.2.8Apr 15, 20261.7K downloads

    ## What's Changed * docs: document Wayland keyboard workaround for Ubuntu 24.04 Gnome by @sfeole in https://github.com/OlaProeis/Ferrite/pull/107 ## New Contributors * @sfeole made their first contribution in https://github.com/OlaProeis/Ferrite/pull/107 **Full Changelog**: https://github.com/OlaProeis/Ferrite/compare/v0.2.7...v0.2.8

  5. Ferrite v0.2.7v0.2.7Mar 13, 20264.1K downloads

    ## macOS Users — Important The macOS DMG is **not notarized** (Apple charges $99/year for this). Gatekeeper may show a warning on first launch. **Recommended: Install via Homebrew (bypasses Gatekeeper automatically)** ```bash brew tap olaproeis/ferrite brew install --cask ferrite ``` **Manual install from DMG:** 1. Download `ferrite-macos-arm64.dmg` (Apple Silicon) or `ferrite-macos-x64.dmg` (Intel) 2. Drag `Ferrite.app` to Applications 3. First launch: Right-click → Open, or run `xattr -cr /Applications/Ferrite.app` 4. Alternatively: System Settings → Privacy & Security → "Open Anyway" See the [README](https://github.com/OlaProeis/Ferrite#readme) for full details. --- ## What's Changed * Translations update from Hosted Weblate by @weblate in https://github.com/OlaProeis/Ferrite/pull/69 * Translations update from Hosted Weblate by @weblate in https://github.com/OlaProeis/Ferrite/pull/77 * feat: add welcome page by @blizzard007dev in https://github.com/OlaProeis/Ferrite/pull/80 * Translations update from Hosted Weblate by @weblate in https://github.com/OlaProeis/Ferrite/pull/78 * Add official Nix flake build/dev workflow by @liuxiaopai-ai in https://github.com/OlaProeis/Ferrit

Code frequency

additions and deletions
+568.1K-568.1KWeek of 2025-12-14: +48,226 linesWeek of 2025-12-14: -58 linesWeek of 2025-12-21: +0 linesWeek of 2025-12-21: -0 linesWeek of 2025-12-28: +0 linesWeek of 2025-12-28: -0 linesWeek of 2026-01-04: +24,712 linesWeek of 2026-01-04: -1,711 linesWeek of 2026-01-11: +568,111 linesWeek of 2026-01-11: -9,879 linesWeek of 2026-01-18: +50,244 linesWeek of 2026-01-18: -24,512 linesWeek of 2026-01-25: +19,670 linesWeek of 2026-01-25: -2,633 linesWeek of 2026-02-01: +17,393 linesWeek of 2026-02-01: -10,817 linesWeek of 2026-02-08: +12,293 linesWeek of 2026-02-08: -127 linesWeek of 2026-02-15: +17,299 linesWeek of 2026-02-15: -16,949 linesWeek of 2026-02-22: +5,135 linesWeek of 2026-02-22: -3,596 linesWeek of 2026-03-01: +4,584 linesWeek of 2026-03-01: -963 linesWeek of 2026-03-08: +2,381 linesWeek of 2026-03-08: -35 linesWeek of 2026-03-15: +284 linesWeek of 2026-03-15: -17 linesWeek of 2026-03-22: +24 linesWeek of 2026-03-22: -1 linesWeek of 2026-03-29: +16,386 linesWeek of 2026-03-29: -2,176 linesWeek of 2026-04-05: +4,519 linesWeek of 2026-04-05: -482 linesWeek of 2026-04-12: +1,747 linesWeek of 2026-04-12: -340 linesWeek of 2026-04-19: +1,741 linesWeek of 2026-04-19: -36 linesWeek of 2026-04-26: +0 linesWeek of 2026-04-26: -0 linesWeek of 2026-05-03: +947 linesWeek of 2026-05-03: -13 linesWeek of 2026-05-10: +22,216 linesWeek of 2026-05-10: -7,107 linesWeek of 2026-05-17: +18,443 linesWeek of 2026-05-17: -6,113 linesWeek of 2026-05-24: +0 linesWeek of 2026-05-24: -0 linesWeek of 2026-05-31: +0 linesWeek of 2026-05-31: -0 linesWeek of 2026-06-07: +4,939 linesWeek of 2026-06-07: -535 linesWeek of 2026-06-14: +22,185 linesWeek of 2026-06-14: -3,152 linesWeek of 2026-06-21: +0 linesWeek of 2026-06-21: -0 linesWeek of 2026-06-28: +788 linesWeek of 2026-06-28: -27 linesWeek of 2026-07-05: +0 linesWeek of 2026-07-05: -0 linesWeek of 2026-07-12: +0 linesWeek of 2026-07-12: -0 linesWeek of 2026-07-19: +0 linesWeek of 2026-07-19: -0 linesWeek of 2026-07-26: +0 linesWeek of 2026-07-26: -0 linesWeek of 2026-08-02: +0 linesWeek of 2026-08-02: -0 linesWeek of 2026-08-09: +0 linesWeek of 2026-08-09: -0 linesWeek of 2026-08-16: +0 linesWeek of 2026-08-16: -0 linesWeek of 2026-08-23: +0 linesWeek of 2026-08-23: -0 linesWeek of 2026-08-30: +0 linesWeek of 2026-08-30: -0 linesWeek of 2026-09-06: +0 linesWeek of 2026-09-06: -0 linesWeek of 2026-09-13: +0 linesWeek of 2026-09-13: -0 linesWeek of 2026-09-20: +0 linesWeek of 2026-09-20: -0 linesWeek of 2026-09-27: +0 linesWeek of 2026-09-27: -0 linesWeek of 2026-10-04: +82,677 linesWeek of 2026-10-04: -7,095 linesWeek of 2026-10-11: +0 linesWeek of 2026-10-11: -0 linesWeek of 2026-10-18: +0 linesWeek of 2026-10-18: -0 linesWeek of 2026-10-25: +0 linesWeek of 2026-10-25: -0 linesWeek of 2026-11-01: +0 linesWeek of 2026-11-01: -0 linesWeek of 2026-11-08: +44,947 linesWeek of 2026-11-08: -2,776 linesWeek of 2026-11-15: +0 linesWeek of 2026-11-15: -0 linesDec 14, 2025Nov 15, 2026
+991.9K lines added, -101.2K removed over the last year.

Commits per week

last 52 weeks
820Week of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 3 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 6 commitsWeek of 2026-01-11: 32 commitsWeek of 2026-01-18: 82 commitsWeek of 2026-01-25: 25 commitsWeek of 2026-02-01: 26 commitsWeek of 2026-02-08: 5 commitsWeek of 2026-02-15: 14 commitsWeek of 2026-02-22: 14 commitsWeek of 2026-03-01: 6 commitsWeek of 2026-03-08: 7 commitsWeek of 2026-03-15: 1 commitsWeek of 2026-03-22: 1 commitsWeek of 2026-03-29: 4 commitsWeek of 2026-04-05: 3 commitsWeek of 2026-04-12: 5 commitsWeek of 2026-04-19: 4 commitsWeek of 2026-04-26: 0 commitsWeek of 2026-05-03: 2 commitsWeek of 2026-05-10: 4 commitsWeek of 2026-05-17: 17 commitsWeek of 2026-05-24: 0 commitsWeek of 2026-05-31: 0 commitsWeek of 2026-06-07: 4 commitsWeek of 2026-06-14: 16 commitsWeek of 2026-06-21: 0 commitsWeek of 2026-06-28: 1 commitsWeek of 2026-07-05: 0 commitsWeek of 2026-07-12: 0 commitsWeek of 2026-07-19: 0 commitsWeek of 2026-07-26: 0 commitsWeek of 2026-08-02: 0 commitsWeek of 2026-08-09: 0 commitsWeek of 2026-08-16: 0 commitsWeek of 2026-08-23: 0 commitsWeek of 2026-08-30: 0 commitsWeek of 2026-09-06: 0 commitsWeek of 2026-09-13: 0 commitsWeek of 2026-09-20: 0 commitsWeek of 2026-09-27: 0 commitsWeek of 2026-10-04: 8 commitsWeek of 2026-10-11: 0 commitsWeek of 2026-10-18: 0 commitsWeek of 2026-10-25: 0 commitsWeek of 2026-11-01: 0 commitsWeek of 2026-11-08: 13 commitsWeek of 2026-11-15: 0 commitsNov 23, 2025Nov 15, 2026
303 commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 1 commitsSun 1:00 — 1 commitsSun 2:00 — 3 commitsSun 3:00 — 0 commitsSun 4:00 — 1 commitsSun 5:00 — 0 commitsSun 6:00 — 0 commitsSun 7:00 — 0 commitsSun 8:00 — 1 commitsSun 9:00 — 1 commitsSun 10:00 — 1 commitsSun 11:00 — 2 commitsSun 12:00 — 1 commitsSun 13:00 — 1 commitsSun 14:00 — 2 commitsSun 15:00 — 3 commitsSun 16:00 — 2 commitsSun 17:00 — 3 commitsSun 18:00 — 1 commitsSun 19:00 — 1 commitsSun 20:00 — 1 commitsSun 21:00 — 1 commitsSun 22:00 — 1 commitsSun 23:00 — 3 commitsMon 0:00 — 1 commitsMon 1:00 — 0 commitsMon 2:00 — 0 commitsMon 3:00 — 1 commitsMon 4:00 — 0 commitsMon 5:00 — 1 commitsMon 6:00 — 1 commitsMon 7:00 — 1 commitsMon 8:00 — 4 commitsMon 9:00 — 12 commitsMon 10:00 — 7 commitsMon 11:00 — 2 commitsMon 12:00 — 2 commitsMon 13:00 — 4 commitsMon 14:00 — 0 commitsMon 15:00 — 4 commitsMon 16:00 — 2 commitsMon 17:00 — 0 commitsMon 18:00 — 2 commitsMon 19:00 — 0 commitsMon 20:00 — 0 commitsMon 21:00 — 3 commitsMon 22:00 — 1 commitsMon 23:00 — 5 commitsTue 0:00 — 1 commitsTue 1:00 — 1 commitsTue 2:00 — 0 commitsTue 3:00 — 1 commitsTue 4:00 — 1 commitsTue 5:00 — 0 commitsTue 6:00 — 1 commitsTue 7:00 — 0 commitsTue 8:00 — 0 commitsTue 9:00 — 2 commitsTue 10:00 — 2 commitsTue 11:00 — 2 commitsTue 12:00 — 1 commitsTue 13:00 — 2 commitsTue 14:00 — 3 commitsTue 15:00 — 1 commitsTue 16:00 — 0 commitsTue 17:00 — 2 commitsTue 18:00 — 7 commitsTue 19:00 — 7 commitsTue 20:00 — 4 commitsTue 21:00 — 1 commitsTue 22:00 — 11 commitsTue 23:00 — 1 commitsWed 0:00 — 1 commitsWed 1:00 — 2 commitsWed 2:00 — 0 commitsWed 3:00 — 1 commitsWed 4:00 — 1 commitsWed 5:00 — 0 commitsWed 6:00 — 0 commitsWed 7:00 — 0 commitsWed 8:00 — 0 commitsWed 9:00 — 0 commitsWed 10:00 — 2 commitsWed 11:00 — 1 commitsWed 12:00 — 1 commitsWed 13:00 — 0 commitsWed 14:00 — 0 commitsWed 15:00 — 8 commitsWed 16:00 — 2 commitsWed 17:00 — 4 commitsWed 18:00 — 7 commitsWed 19:00 — 3 commitsWed 20:00 — 6 commitsWed 21:00 — 2 commitsWed 22:00 — 6 commitsWed 23:00 — 2 commitsThu 0:00 — 5 commitsThu 1:00 — 2 commitsThu 2:00 — 0 commitsThu 3:00 — 0 commitsThu 4:00 — 0 commitsThu 5:00 — 0 commitsThu 6:00 — 0 commitsThu 7:00 — 1 commitsThu 8:00 — 0 commitsThu 9:00 — 2 commitsThu 10:00 — 1 commitsThu 11:00 — 1 commitsThu 12:00 — 0 commitsThu 13:00 — 1 commitsThu 14:00 — 1 commitsThu 15:00 — 0 commitsThu 16:00 — 0 commitsThu 17:00 — 0 commitsThu 18:00 — 1 commitsThu 19:00 — 3 commitsThu 20:00 — 1 commitsThu 21:00 — 1 commitsThu 22:00 — 0 commitsThu 23:00 — 0 commitsFri 0:00 — 4 commitsFri 1:00 — 0 commitsFri 2:00 — 0 commitsFri 3:00 — 0 commitsFri 4:00 — 1 commitsFri 5:00 — 0 commitsFri 6:00 — 0 commitsFri 7:00 — 0 commitsFri 8:00 — 0 commitsFri 9:00 — 0 commitsFri 10:00 — 1 commitsFri 11:00 — 3 commitsFri 12:00 — 4 commitsFri 13:00 — 0 commitsFri 14:00 — 3 commitsFri 15:00 — 2 commitsFri 16:00 — 0 commitsFri 17:00 — 0 commitsFri 18:00 — 3 commitsFri 19:00 — 3 commitsFri 20:00 — 3 commitsFri 21:00 — 1 commitsFri 22:00 — 6 commitsFri 23:00 — 8 commitsSat 0:00 — 6 commitsSat 1:00 — 4 commitsSat 2:00 — 3 commitsSat 3:00 — 0 commitsSat 4:00 — 0 commitsSat 5:00 — 0 commitsSat 6:00 — 0 commitsSat 7:00 — 0 commitsSat 8:00 — 6 commitsSat 9:00 — 16 commitsSat 10:00 — 0 commitsSat 11:00 — 8 commitsSat 12:00 — 10 commitsSat 13:00 — 2 commitsSat 14:00 — 1 commitsSat 15:00 — 1 commitsSat 16:00 — 1 commitsSat 17:00 — 4 commitsSat 18:00 — 1 commitsSat 19:00 — 0 commitsSat 20:00 — 2 commitsSat 21:00 — 7 commitsSat 22:00 — 0 commitsSat 23:00 — 1 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Who is committing

last 52 weeks
Maintainer commits197 (51%)
Community commits190 (49%)

387 commits in total over the last year.

DateListRankStars gained
Jan 11, 2026daily#14+226
  • morluto/rea

    Reverse engineer anything with agents, from app behavior down to native binaries.

    471.6K stars · TypeScript

  • affaan-m/ECC

    The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

    307.9K stars · JavaScript

  • firecrawl/firecrawl

    Knowledge infrastructure to make your agents smarter. Search, scrape and access 550+ data providers through one API.

    205.3K stars · TypeScript

  • microsoft/markitdown

    Python tool for converting files and office documents to Markdown.

    197.3K stars · Python

  • microsoft/vscode

    Visual Studio Code

    195.7K stars · TypeScript

  • ultraworkers/claw-code

    An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.

    194.8K stars · Rust