Tree [a61683] default tip /

File Date Author Commit
charmaps 2010-04-28 Joseph Allen Joseph Allen [409b67] Joe sources...
docs 5 days ago Joseph Allen Joseph Allen [4d2e2a] manual fixes
htdocs 2015-09-17 Joseph Allen Joseph Allen [374a14] Update link
joe 5 days ago Joseph Allen Joseph Allen [264c21] Improve help. Fix spelling in manual. ^C kill...
man 2010-04-28 Joseph Allen Joseph Allen [409b67] Joe sources...
po 2015-08-31 Joe Allen Joe Allen [17407c] forgot to add
rc 4 days ago Joseph Allen Joseph Allen [fff357] More UI refinements: Enable noxon. Use ^S/^R fo...
syntax 2015-09-07 Joe Allen Joe Allen [897bcd] Improve ruby and perl highlighters.
tests 2015-04-07 John J. Jordan John J. Jordan [84a092] Missed change to naborttw from [a8e8ed]. Expect...
.hgignore 2015-07-23 Joe Allen Joe Allen [99d0de] Support for unicode character classes.
.hgtags 2015-09-08 Joe Allen Joe Allen [da33f3] Added tag joe-4.1 for changeset ab72746ca433
COPYING 2015-03-19 Joe Allen Joe Allen [d731f9] Update copyright notice.
ChangeLog 2010-04-28 Joseph Allen Joseph Allen [409b67] Joe sources...
INSTALL 2015-07-18 Joe Allen Joe Allen [cc8d35] Fix more warnings.
INSTALL.AMIGA 2010-04-28 Joseph Allen Joseph Allen [409b67] Joe sources... 2015-03-22 Joe Allen Joe Allen [347fc8] Drop xterm patch from distribution. 4 days ago Joseph Allen Joseph Allen [a61683] Update news. 2015-03-24 John J. Jordan John J. Jordan [dd27a9] Update wiki/README to point to paltry Windows d... 2015-03-17 Joseph Allen Joseph Allen [440901] Markdown links
acinclude.m4 2010-04-28 Joseph Allen Joseph Allen [93fb8d] Forgot acinclude.m4
autojoe 2010-04-28 Joseph Allen Joseph Allen [93fb8d] Forgot acinclude.m4 2015-09-08 Joe Allen Joe Allen [ab7274] Change to JOE 4.1
cygbuild 2010-04-28 Joseph Allen Joseph Allen [409b67] Joe sources...
runtests 2015-04-02 John J. Jordan John J. Jordan [d5c75e] Accept arguments in runtests
setup.hint 2010-04-28 Joseph Allen Joseph Allen [409b67] Joe sources...
xterm-patch 2010-04-28 Joseph Allen Joseph Allen [409b67] Joe sources...
xterm-readme 2010-04-28 Joseph Allen Joseph Allen [409b67] Joe sources...

Read Me

Joe's Own Editor

User manual

Release Notes

List of Commands

List of Options

JOE for Windows tips


Project page

Download source

Build instructions


JOE is a full featured terminal-based screen editor which is distributed under the GNU General Public License (GPL). JOE has been around since 1988 and comes standard with many Linux distributions.

JOE is being maintained by its original author Joseph Allen, plus all of the people who send bug reports, feature suggestions and patches to the project web site. JOE is hosted by and its source code is controlled under Mercurial.

JOE is a blending of MicroPro's venerable microcomputer word processor WordStar and Richard Stallman's famous LISP based text editor GNU-EMACS (but it does not use code from either program): most of the basic editing keys are the same as in WordStar as is the overall feel of the editor. JOE also has some of the key bindings and many of the powerful features of EMACS.

JOE is written in C and its only dependency is libc. This makes JOE very easy to build (just "configure" and "make install"), making it feasible to include on small systems and recovery disks. The compiled binary is about 300K in x86. Note that JOE can use either the termcap or terminfo terminal capabilities databases (or a built-in termcap entry for ANSI terminals). The choice is controlled by a "configure" option. If terminfo is used, a library is required to access the database (on some systems this library is ncurses, but JOE does not use curses to control the terminal- it has its own code for this).

Much of the look and feel of JOE is determined by its simple configuration file "joerc". Several variants of the editor are installed by default in addition to "joe": "jmacs" (emulate GNU-EMACS), "jstar" emulate WordStar, "jpico" emulate the Pine mailer editor PICO and "rjoe"- a restricted version of JOE which allows the used to only edit the file given on the command line. JOE is linked to several names. The name which is used to invoke the editor with "rc" tacked on the end gives the name of configuration file to use. It is thus easy for you to make your own variant if you want. Also you can customize the editor by copying the system "joerc" file to your home directory.

Here is a basic screen shot of JOE running in a Cygwin console:

screen capture

Here is a screen shot showing several windows- the first has some example double-wide characters, the second is the same buffer as the first, but in hex-dump view mode, the third is a shell window and the fourth shows a selected rectangular block of numbers and their sum:

elaborate screen capture

JOE has the following features:

  • Multi-file search and replace- file list is either given on command line or by a UNIX command (grep/find) run from within JOE.

  • Mouse support, including wheel (works best when using xterm). The mouse can resize windows, scroll windows, select and paste text, and select menu entries.

  • Context display on status line: allows you to see name of function cursor is in.

  • UTF-8 support, optional auto-detect of UTF-8 files.

  • Syntax highlighting for more than 40 languages.

  • Hexadecimal edit mode. Use JOE as a disk editor: joe -overwrite -hex /dev/hda1,0,512 (edit first sector of /dev/hda1).

  • Non-destructive editing of binary files even when handling MS-DOS or UNIX line endings.

  • Swap file allows editing files larger than memory.

  • Context sensitive on-line help.

  • Bash-like TAB completion and history for all prompts, or jump into the
    completion menu and use it to traverse the file system.

  • Complete word in edit buffer by hitting ESC Enter (uses other words in
    buffer for dictionary).

  • EMACS-compatible file locks and file modification checking.

  • Shell windows.

  • Multiple-windows onto same or different files.

  • Compile and step through errors or Grep and step through finds.

  • Goto matching character delimiter "() [] {} <>" which skips comments and
    quoted matter.

  • Goto matching word delimiter, including XML tags and C preprocessor

  • Ctrl-arrow key block selection.

  • Search and replace system, including regular expression and optional
    incremental search. Regular expression key for matching balanced C

  • Tags file search (tab completion at tags search prompt uses tags file as

  • Spell check commands which invoke aspell or ispell. Language for aspell
    can be passed through editor.

  • Paragraph format which preserves news/mail quoting indentation

  • Unlimited Undo and Redo.

  • Yank buffer allows stepping through and insertion of previously deleted

  • State file restores history buffers, yank buffer and last file cursor

  • Cursor position history allows you to step through previously visited areas
    of a file.

  • Multiple interactive keyboard macros. Macros can be assigned to key
    sequences in joerc file.

  • Block move/copy/delete/filter.

  • Rectangle (columnar) block mode- search and replace can be narrowed to
    the rectangular block. Rectangular blocks can be filtered through UNIX

  • Overtype/Insert modes.

  • Indent/Unindent (shift block left or right).

  • Auto-indent mode.

  • Picture mode for ASCII graphics.

  • Line number mode displays line number of each line.

  • Powerful scientific calculator with block statistics functions (sum/standard-deviation/count highlighted block of numbers).

  • Termcap/Terminfo support allows JOE to use any terminal or terminal emulator.

  • Can accept data from a pipe, for example: ls | joe

JOE does not have these features (yet):

  • Vertical windows
  • Folding
  • Right to left editing for Hebrew and Arabic
  • Direct editing of 16-bit character sets such as UCS-16 and BIG5
  • All encompassing macro language like elisp in GNU-EMACS
  • Background spell checking, like Microsoft WORD
  • Highlight all matching words
  • Automatic unzip/untar
  • Built-in FTP
  • X-Window version (use inside a terminal emulator)
  • Interface to debugger

Here are some other editors to consider:
Richard Stallman's powerful LISP-based editor. John E.
Davis' version of EMACS using the S-Lang language. Micro Emacs Paul Fox's vi clone
(built on top of Micro Emacs). Now maintained by Tom Dickey and others. An open
source PICO clone.
PICO: A simple editor built on Micro Emacs. Bram Moolenaar's vi
clone Elvis: A
small vi clone Powerful editor
written in Java X-Windowing System
editor Midnight
Commander file manager with built-in text editor with highlighting. Can
browse ZIP and TAR files. A
UNIX/X clone of Rob Pike's Plan9 editor ACME. Originally written by Gary
Capell, but now maintained by Ozan Yigit. This is an interesting minimalist
Huge IDE written in Java. Performs same function as Wily, but is literally
1300 times larger.
UNIX/X port of Rob Pike's Plan9 editor SAM. This interesting editor
supports multi-file regular expression search & replace with unlimited
UNIX Stream EDitor. If you're on UNIX, you already have this editor, but follow
this link to see the amazing things that can be done with it.