Skip to content

itlwas/mecro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

30c34ba · Jan 30, 2025

History

8 Commits
Jan 30, 2025
Jan 30, 2025
Jan 30, 2025
Jan 30, 2025
Jan 30, 2025
Jan 30, 2025
Jan 30, 2025
Jan 30, 2025
Jan 30, 2025
Jan 30, 2025

Repository files navigation

MECRO Go Lua

Modeless terminal text editor with enhanced customization.

Mecro is a fork of Macro/Micro, focused on improved theming, syntax support, and intuitive configuration.
Maintains compatibility with Micro's ecosystem while adding unique features.

⚠️ Note for Users

This is a personal passion project created because I loved using Micro. It is not intended to be a fully supported editor.
No active maintenance, bug fixes, or major innovations are promised — treat it as an experimental fork for tinkering and customization!

Key Features

  • 170+ languages with syntax highlighting
  • 60+ built-in colorschemes (16, 256, truecolor) + custom theme engine
  • Built-in file browser - opens automatically when launched without arguments
  • Modeless editing with familiar keybindings (Ctrl+S/Ctrl+Q/Ctrl+E)
  • Split windows and tabbed editing
  • JSON-configurable settings and keybindings
  • Lua scripting for advanced customization and plugins
  • Context-aware commands (type > help with Ctrl+E)
  • Mouse support, multiple cursors, and macros
  • Per-buffer settings via glob patterns
  • Integrated command runner (Ctrl+Space)

Install & Build

Requires Go 1.16+:

git clone https://github.com/itlwas/mecro
cd mecro
make build

Quick Start

  • mecro (no arguments) to launch the file browser
  • mecro file.txt to edit files directly
  • Save: Ctrl+S | Quit: Ctrl+Q | Commands: Ctrl+E
  • Explore features with > help tutorial in command mode
  • Customize via ~/.config/mecro/settings.json and bindings.json

Documentation

  • In-editor help: Type > help followed by topics like keybindings, plugins, or colors
  • For licenses of plugins, colorschemes, or other assets not explicitly included here, refer to the upstream Macro repository
  • Micro upstream docs: micro-editor.github.io

Notes

  • Linux clipboard: Requires xclip/xsel (X11) or wl-clipboard (Wayland)
  • Configuration examples in runtime/help/tutorial.md
  • Report issues only to this repository - differences from upstream exist!

Lightweight • Hackable • Compatible with Micro plugins • Integrated File Explorer

About

A modern and intuitive terminal-based text editor

Resources

License

Stars

Watchers

Forks

Packages

No packages published