micro/README.md

105 lines
4.3 KiB
Markdown
Raw Normal View History

2016-03-20 21:28:36 +00:00
# Micro
2016-03-25 19:09:24 +00:00
[![Build Status](https://travis-ci.org/zyedidia/micro.svg?branch=master)](https://travis-ci.org/zyedidia/micro)
2016-06-22 17:59:07 +00:00
![Go Report Card](https://goreportcard.com/badge/github.com/zyedidia/micro)
2016-04-21 16:46:30 +00:00
[![Join the chat at https://gitter.im/zyedidia/micro](https://badges.gitter.im/zyedidia/micro.svg)](https://gitter.im/zyedidia/micro?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
2016-03-20 21:33:37 +00:00
[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/zyedidia/micro/blob/master/LICENSE)
2016-03-20 21:28:36 +00:00
2016-08-20 20:02:19 +00:00
> Micro is still a work in progress
2016-03-20 21:28:36 +00:00
2016-04-18 02:22:11 +00:00
Micro is a terminal-based text editor that aims to be easy to use and intuitive, while also taking advantage of the full capabilities
2016-04-29 14:14:29 +00:00
of modern terminals. It comes as one single, batteries-included, static binary with no dependencies, and you can download and use it right now.
2016-03-20 21:28:36 +00:00
Here is a picture of micro editing its source code.
![Screenshot](./screenshot.png)
2016-03-20 21:28:36 +00:00
# Features
2016-06-03 15:14:11 +00:00
* Easy to use and to install
* No dependencies or external files are needed -- just the binary you can download further down the page
2016-03-20 21:28:36 +00:00
* Common keybindings (ctrl-s, ctrl-c, ctrl-v, ctrl-z...)
2016-06-03 15:14:11 +00:00
* Keybindings can be rebound to your liking
2016-08-20 20:02:19 +00:00
* Sane defaults
* You shouldn't have to configure much out of the box (and it is extremely easy to configure)
2016-03-20 21:28:36 +00:00
* Extremely good mouse support
2016-08-20 20:02:19 +00:00
* This means mouse dragging to create a selection, double click to select by word, and triple click to select by line
2016-06-03 15:14:11 +00:00
* Cross platform (It should work on all the platforms Go runs on)
* Plugin system (plugins are written in Lua)
2016-08-20 20:02:19 +00:00
* Automatic linting and error notifications
2016-06-03 15:14:11 +00:00
* Syntax highlighting (for over [75 languages](runtime/syntax)!)
* Colorscheme support
2016-08-20 20:02:19 +00:00
* By default, micro comes with 16, 256, and true color themes.
* True color support (set the `MICRO_TRUECOLOR` env variable to 1 to enable it)
2016-04-18 01:55:57 +00:00
* Copy and paste with the system clipboard
* Small and simple
2016-04-29 14:14:29 +00:00
* Easily configurable
2016-06-03 15:14:11 +00:00
* Common editor things such as undo/redo, line numbers, unicode support...
2016-03-20 21:28:36 +00:00
# Installation
2016-08-20 20:02:19 +00:00
To install micro, you can download a prebuilt binary, or you can build it from source.
2016-05-29 22:20:43 +00:00
You can also install micro with a few package managers (on OSX, Arch Linux, and CRUX).
2016-08-20 20:02:19 +00:00
See this [wiki page](https://github.com/zyedidia/micro/wiki/Installing-Micro) for details.
Please note that micro uses the amazing [tcell library](https://github.com/gdamore/tcell), but this
means that micro is restricted to the platforms tcell supports. As a result, micro does not support
Plan9, NaCl, and Cygwin (although this may change in the future).
2016-05-29 22:20:43 +00:00
### Prebuilt binaries
2016-05-21 22:25:49 +00:00
2016-08-20 20:02:19 +00:00
All you need to install micro is one file, the binary itself. It's as simple as that!
2016-08-20 20:02:19 +00:00
You can download the correct binary for your operating system from the list in the [nightly build release](https://github.com/zyedidia/micro/releases/tag/nightly).
2016-04-30 18:12:54 +00:00
2016-08-20 20:02:19 +00:00
Micro has no released version, instead these binaries are compiled every night and you can find the
commit they were compiled with by running `micro -version`.
2016-08-20 20:02:19 +00:00
If your operating system does not have binary, but does run Go, you can build from source.
### Building from source
2016-03-20 21:28:36 +00:00
2016-08-20 20:02:19 +00:00
Make sure that you have Go version 1.5 or greater (Go 1.4 will work for the systems like support CGO then).
2016-05-21 22:25:49 +00:00
```sh
2016-06-01 04:23:48 +00:00
go get -u github.com/zyedidia/micro/...
2016-03-20 21:28:36 +00:00
```
### Clipboard support
2016-05-21 22:28:29 +00:00
On Linux, clipboard support requires 'xclip' or 'xsel' command to be installed.
For Ubuntu:
2016-05-21 22:25:49 +00:00
```sh
2016-05-21 22:28:29 +00:00
sudo apt-get install xclip
```
If you don't have xclip or xsel, micro will use an internal clipboard for copy and paste, but it won't work with external applications.
# Usage
Once you have built the editor, simply start it by running `micro path/to/file.txt` or simply `micro` to open an empty buffer.
Micro also supports creating buffers from `stdin`:
2016-05-21 22:25:49 +00:00
```sh
ifconfig | micro
```
You can move the cursor around with the arrow keys and mouse.
2016-08-20 20:02:19 +00:00
You can also use the mouse to manipulate the text. Simply clicking and dragging
will select text. You can also double click to enable word selection, and triple
click to enable line selection.
2016-04-19 17:40:30 +00:00
2016-08-20 20:02:19 +00:00
### Documentation and Help
2016-04-24 12:41:30 +00:00
2016-08-20 20:02:19 +00:00
Micro has a built-in help system which you can access by pressing `CtrlE` and typing `help`. Additionally, you can
view the help files online [here](https://github.com/zyedidia/micro/tree/master/runtime/help).
2016-04-24 12:41:30 +00:00
# Contributing
2016-03-20 21:28:36 +00:00
If you find any bugs, please report them! I am also happy to accept pull requests from anyone.