Releases: bjasspa/jasspa
Jasspa MicroEmacs 20241201
INTRODUCTION
MicroEmacs is an Emacs like text editor for developers, its great strength is its speed, fast key-bindings and powerful macro language. If you are looking for a menu driven editor this is probably not for you!
Jasspa MicroEmacs also has a couple of other base limitations, firstly, no real Unicode support - so you you are constantly editing multi-language files this is probably not the best tool for you. MicroEmacs also does not support long line wrapping in its rendering, one line of a file will always be represented as one line on the screen regardless of how long the line is - this is MicroEmacs, if these issues are blockers to you, try Emacs.
For move information visit our Github repository.
VERY QUICK START GUIDE
For your platform download the single-file binary zip file:
Platform | Console/Terminal | GUI (X11 on Linux/Mac) |
---|---|---|
Linux | mesc | mesw |
MacOS apple | mesc | mesw |
MacOS intel | mesc | mesw |
Windows | mesc | mesw |
Extract the executable from the zip and run.
The console/terminal version should work on all computers of the given platform, whereas the GUI version may not work on all computers (particularly macOS where XQuartz is required) but will give the best user experience.
This is a truly portable version, it will not alter/add to your environment or registry and will only create/edit files you explicitly ask it to. So this version is ideal for trying MicroEmacs without affecting your computer.
For a more complete experience execute command init-session, this creates a small user configuration directory in your user area, allowing MicroEmacs to save setup changes and download supporting files such as the comprehensive help docs and spelling dictionaries for numerous languages.
INSTALLERS
-
Windows: Download and run Jasspa_MicroEmacs_20241201_installer_windows.msi installer, which contains the binaries, macros and help file, to create a fully working environment.
-
UNIX: The preferred install method is using the microemacs-install script, run the following script in a terminal:
/bin/sh -c "$(curl -fsSL https://github.com/bjasspa/jasspa/releases/latest/download/microemacs-install)"
Or download the script first and run locally, note that this will always install the latest release. If the script encounters issues during the installation processes, typically insufficient permissions, please follow the instructions given.
Once successfully installed a
microemacs-update
script can be used to update the installation to the latest version or to install spelling languages, e.g. run:microemacs-update enus
-
UNIX - Homebrew: For users familiar with brew we also provide a brew installer. In a terminal run:
brew tap bjasspa/jasspa brew install microemacs
This will install the binaries, macros and help. To install spelling languages run:
brew install microemacs-spelling-<LANG>
Use
brew search microemacs
for a full list of available packages.
On all platforms, spelling dictionaries can also be downloaded and installed by MicroEmacs as and when required.
SLOWER QUICK START GUIDE
To build a more complete, native environment do the following:
-
Create a main MicroEmacs directory to hold all required files, this is typically ~/MicroEmacs on Unix or c:\Users\<user-name>\MicroEmacs on Windows, but the path can be anywhere. In following steps this path will be referred to as ~/MicroEmacs
-
Download the following zip package files:
a. Required: Binaries for your platform (Jasspa_MicroEmacs_20241201_bin_<PLATFORM>_binaries.zip)
b. Required: Macro files (Jasspa_MicroEmacs_20241201_macros.zip)
c. Help file (Jasspa_MicroEmacs_20241201_help_ehf.zip)
d. Spelling dictionaries for any language you require (Jasspa_MicroEmacs_20241201_spelling_<LANGUAGE>.zip)
e. OpenSSL dynamic libraries (Jasspa_MicroEmacs_20241201_bin_<PLATFORM>_openssl.zip) for https/ftps support (country permitting)
-
Extract downloaded zip files into the ~/MicroEmacs directory you created in (1), this should have created:
~/MicroEmacs/bin
- containing platform directories for each of the binary packages you downloaded and extracted.~/MicroEmacs/macros
- containing many macro files (*.emf), the me.ehf help file and other supporting files.~/MicroEmacs/spelling
- containing the dictionaries of the languages you downloaded. -
Set the following environment variable:
MEINSTALLPATH=~/MicroEmacs
Setting an environment variable is platform & shell dependent.
-
Run:
~/MicroEmacs/bin/<platform>/mec
The console version should run on all platforms, if the message '[Failed to load file me]' appears at the bottom of the window then you have either not set the environment variable correctly or it has not taken effect in your current shell/command prompt.
-
Try running:
~/MicroEmacs/bin/<platform>/mew
This should always work on Windows but may not on Unix systems, particularly macOS, where an X server (XQuartz) is required to support the window interface. Fixing issues causing mew to not run is beyond the scope of this document.
-
Optionally copy the binaries (mec & mew) into a directory on your path (or add ~/MicroEmacs/bin/<platform> to your path. This simplifies running MicroEmacs in a terminal.
-
Run mew, if working, mec otherwise and follow the setup steps to create a basic user configuration area, this will create the directory:
~/MicroEmacs/<user-name>
All your customisations should go in here. Run the command user-setup (in the Tools menu) to start customising the editor.
-
Enjoy fast, free editing!
Jasspa MicroEmacs 20241101
INTRODUCTION
MicroEmacs is an Emacs like text editor for developers, its great strength is its speed, fast key-bindings and powerful macro language. If you are looking for a menu driven editor this is probably not for you!
Jasspa MicroEmacs also has a couple of other base limitations, firstly, no real Unicode support - so you you are constantly editing multi-language files this is probably not the best tool for you. MicroEmacs also does not support long line wrapping in its rendering, one line of a file will always be represented as one line on the screen regardless of how long the line is - this is MicroEmacs, if these issues are blockers to you, try Emacs.
For move information visit our Github repository.
VERY QUICK START GUIDE
For your platform download the single-file binary zip file:
Platform | Console/Terminal | GUI (X11 on Linux/Mac) |
---|---|---|
Linux | mecs | mews |
MacOS apple | mecs | mews |
MacOS intel | mecs | mews |
Windows | mecs | mews |
Extract the executable from the zip and run.
The console/terminal version should work on all computers of the given platform, whereas the GUI version may not work on all computers (particularly macOS where XQuartz is required) but will give the best user experience.
This is a truly portable version, it will not alter/add to your environment or registry and will only create/edit files you explicitly ask it to. So this version is ideal for trying MicroEmacs without affecting your computer.
For a more complete experience execute command init-session, this creates a small user configuration directory in your user area, allowing MicroEmacs to save setup changes and download supporting files such as the comprehensive help docs and spelling dictionaries for numerous languages.
INSTALLERS
-
Windows: Download and run Jasspa_MicroEmacs_20241101_installer_windows.msi installer, which contains the binaries, macros and help file, to create a fully working environment.
-
UNIX: The preferred install method is using the microemacs-install script, run the following script in a terminal:
/bin/sh -c "$(curl -fsSL https://github.com/bjasspa/jasspa/releases/latest/download/microemacs-install)"
Or download the script first and run locally, note that this will always install the latest release. If the script
encounters issues during the installation processes, typically insufficient permissions, please follow the
instructions given.Once successfully installed a
microemacs-update
script can be used to update the installation to the latest version or to install spelling languages, e.g. run:microemacs-update enus
-
UNIX - Homebrew: For users familiar with brew we also provide a brew installer. In a terminal run:
brew tap bjasspa/jasspa brew install microemacs
This will install the binaries, macros and help. To install spelling languages run:
brew install microemacs-spelling-<LANG>
Use
brew search microemacs
for a full list of available packages.
On all platforms, spelling dictionaries can also be downloaded and installed by MicroEmacs as and when required.
SLOWER QUICK START GUIDE
To build a more complete, native environment do the following:
-
Create a main MicroEmacs directory to hold all required files, this is typically ~/MicroEmacs on Unix or c:\Users\<user-name>\MicroEmacs on Windows, but the path can be anywhere. In following steps this path will be referred to as ~/MicroEmacs
-
Download the following zip package files:
a. Required: Binaries for your platform (Jasspa_MicroEmacs_20241101_bin_<PLATFORM>_binaries.zip)
b. Required: Macro files (Jasspa_MicroEmacs_20241101_macros.zip)
c. Help file (Jasspa_MicroEmacs_20241101_help_ehf.zip)
d. Spelling dictionaries for any language you require (Jasspa_MicroEmacs_20241101_spelling_<LANGUAGE>.zip)
e. OpenSSL dynamic libraries (Jasspa_MicroEmacs_20241101_bin_<PLATFORM>_openssl.zip) for https/ftps support (country permitting)
-
Extract downloaded zip files into the ~/MicroEmacs directory you created in (1), this should have created:
~/MicroEmacs/bin
- containing platform directories for each of the binary packages you downloaded and extracted.~/MicroEmacs/macros
- containing many macro files (*.emf), the me.ehf help file and other supporting files.~/MicroEmacs/spelling
- containing the dictionaries of the languages you downloaded. -
Set the following environment variable:
MEINSTALLPATH=~/MicroEmacs
Setting an environment variable is platform & shell dependent.
-
Run:
~/MicroEmacs/bin/<platform>/mec
The console version should run on all platforms, if the message '[Failed to load file me]' appears at the bottom of the window then you have either not set the environment variable correctly or it has not taken effect in your current shell/command prompt.
-
Try running:
~/MicroEmacs/bin/<platform>/mew
This should always work on Windows but may not on Unix systems, particularly macOS, where an X server (XQuartz) is required to support the window interface. Fixing issues causing mew to not run is beyond the scope of this document.
-
Optionally copy the binaries (mec & mew) into a directory on your path (or add ~/MicroEmacs/bin/<platform> to your path. This simplifies running MicroEmacs in a terminal.
-
Run mew, if working, mec otherwise and follow the setup steps to create a basic user configuration area, this will create the directory:
~/MicroEmacs/<user-name>
All your customisations should go in here. Run the command user-setup (in the Tools menu) to start customising the editor.
-
Enjoy fast, free editing!
Jasspa MicroEmacs 20241001
INTRODUCTION
MicroEmacs is an Emacs like text editor for developers, its great strength is its speed, fast key-bindings and powerful macro language. If you are looking for a menu driven editor this is probably not for you!
Jasspa MicroEmacs also has a couple of other base limitations, firstly, no real Unicode support - so you you are constantly editing multi-language files this is probably not the best tool for you. MicroEmacs also does not support long line wrapping in its rendering, one line of a file will always be represented as one line on the screen regardless of how long the line is - this is MicroEmacs, if these issues are blockers to you, try Emacs.
For move information visit our Github repository.
VERY QUICK START GUIDE
For your platform download the single-file binary zip file:
Platform | Terminal/Console | GUI (X11 on Linux/Mac) |
---|---|---|
Linux | mecs | mews |
MacOS apple | mecs | mews |
MacOS intel | mecs | mews |
Windows | mecs | mews |
Extract the executable from the zip and run.
The terminal/console version should work on all computers of the given platform, whereas the GUI version may not work on all computers (particularly macOS where XQuartz is required) but will give the best user experience.
This is a truly portable version, it will not alter/add to your environment or registry and will only create/edit files you explicitly ask it to. So this version is ideal for trying MicroEmacs without affecting your computer.
For a more complete experience execute command init-session, this creates a small user configuration directory in your user area, allowing MicroEmacs to save setup changes and download supporting files such as the comprehensive help docs and spelling dictionaries for numerous languages.
INSTALLERS
-
Windows: Download and run Jasspa_MicroEmacs_20241001_installer_windows.msi installer, which contains the binaries, macros and help file, to create a fully working environment.
-
UNIX: The preferred install method is using the microemacs-install script, run the following script in a terminal:
/bin/sh -c "$(curl -fsSL https://github.com/bjasspa/jasspa/releases/latest/download/microemacs-install)"
Or download the script first and run locally, note that this will always install the latest release. If the script encounters issues during the installation processes, typically insufficient permissions, please follow the instructions given.
Once successfully installed a
microemacs-update
script can be used to update the installation to the latest version or to install spelling languages, e.g. run:microemacs-update enus
-
UNIX - Homebrew: For users familiar with brew we also provide a brew installer. In a terminal run:
brew tap bjasspa/jasspa brew install microemacs
This will install the binaries, macros and help. To install spelling languages run:
brew install microemacs-spelling-<LANG>
Use
brew search microemacs
for a full list of available packages.
On all platforms, spelling dictionaries can also be downloaded and installed by MicroEmacs as and when required.
SLOWER QUICK START GUIDE
To build a more complete, native environment do the following:
-
Create a main MicroEmacs directory to hold all required files, this is typically ~/MicroEmacs on Unix or c:\Users\<user-name>\MicroEmacs on Windows, but the path can be anywhere. In following steps this path will be referred to as ~/MicroEmacs
-
Download the following zip package files:
a. Required: Binaries for your platform (Jasspa_MicroEmacs_20241001_bin_<PLATFORM>_binaries.zip)
b. Required: Macro files (Jasspa_MicroEmacs_20241001_macros.zip)
c. Help file (Jasspa_MicroEmacs_20241001_help_ehf.zip)
d. Spelling dictionaries for any language you require (Jasspa_MicroEmacs_20241001_spelling_<LANGUAGE>.zip)
e. OpenSSL dynamic libraries (Jasspa_MicroEmacs_20241001_bin_<PLATFORM>_openssl.zip) for https/ftps support (country permitting)
-
Extract downloaded zip files into the ~/MicroEmacs directory you created in (1), this should have created:
~/MicroEmacs/bin
- containing platform directories for each of the binary packages you downloaded and extracted.~/MicroEmacs/macros
- containing many macro files (*.emf), the me.ehf help file and other supporting files.~/MicroEmacs/spelling
- containing the dictionaries of the languages you downloaded. -
Set the following environment variable:
MEINSTALLPATH=~/MicroEmacs
Setting an environment variable is platform & shell dependent.
-
Run:
~/MicroEmacs/bin/<platform>/mec
The console version should run on all platforms, if the message '[Failed to load file me]' appears at the bottom of the window then you have either not set the environment variable correctly or it has not taken effect in your current shell/command prompt.
-
Try running:
~/MicroEmacs/bin/<platform>/mew
This should always work on Windows but may not on Unix systems, particularly macOS, where an X server (XQuartz) is required to support the window interface. Fixing issues causing mew to not run is beyond the scope of this document.
-
Optionally copy the binaries (mec & mew) into a directory on your path (or add ~/MicroEmacs/bin/<platform> to your path. This simplifies running MicroEmacs in a terminal.
-
Run mew, if working, mec otherwise and follow the setup steps to create a basic user configuration area, this will create the directory:
~/MicroEmacs/<user-name>
All your customisations should go in here. Run the command user-setup (in the Tools menu) to start customising the editor.
-
Enjoy fast, free editing!
Jasspa MicroEmacs 20240903
INTRODUCTION
MicroEmacs is an Emacs like text editor for developers, its great strength is its speed, fast key-bindings and powerful macro language. If you are looking for a menu driven editor this is probably not for you!
Jasspa MicroEmacs also has a couple of other base limitations, firstly, no real Unicode support - so you you are constantly editing multi-language files this is probably not the best tool for you. MicroEmacs also does not support long line wrapping in its rendering, one line of a file will always be represented as one line on the screen regardless of how long the line is - this is MicroEmacs, if these issues are blockers to you, try Emacs.
For move information visit our Github repository.
VERY QUICK START GUIDE
For your platform download the single-file binary zip file:
Platform | Terminal/Console | GUI (X11 on Linux/Mac) |
---|---|---|
Linux | mecs | mews |
MacOS apple | mecs | mews |
MacOS intel | mecs | mews |
Windows | mecs | mews |
Extract the executable from the zip and run.
The terminal/console version should work on all computers of the given platform, whereas the GUI version may not work on all computers (particularly macOS where XQuartz is required) but will give the best user experience.
This is a truly portable version, it will not alter/add to your environment or registry and will only create/edit files you explicitly ask it to. So this version is ideal for trying MicroEmacs without affecting your computer.
For a more complete experience execute command init-session, this creates a small user configuration directory in your user area, allowing MicroEmacs to save setup changes and download supporting files such as the comprehensive help docs and spelling dictionaries for numerous languages.
INSTALLERS
-
Windows: Download and run Jasspa_MicroEmacs_20240903_installer_windows.msi installer, which contains the binaries, macros and help file, to create a fully working environment.
-
UNIX: The preferred install method is using the microemacs-install script, run the following script in a terminal:
/bin/sh -c "$(curl -fsSL https://github.com/bjasspa/jasspa/releases/latest/download/microemacs-install)"
Or download the script first and run locally, note that this will always install the latest release. If the script encounters issues during the installation processes, typically insufficient permissions, please follow the instructions given.
Once successfully installed a
microemacs-update
script can be used to update the installation to the latest version or to install spelling languages, e.g. run:microemacs-update enus
-
UNIX - Homebrew: For users familiar with brew we also provide a brew installer. In a terminal run:
brew tap bjasspa/jasspa brew install microemacs
This will install the binaries, macros and help. To install spelling languages run:
brew install microemacs-spelling-<LANG>
Use
brew search microemacs
for a full list of available packages.
On all platforms, spelling dictionaries can also be downloaded and installed by MicroEmacs as and when required.
SLOWER QUICK START GUIDE
To build a more complete, native environment do the following:
-
Create a main MicroEmacs directory to hold all required files, this is typically ~/MicroEmacs on Unix or c:\Users\<user-name>\MicroEmacs on Windows, but the path can be anywhere. In following steps this path will be referred to as ~/MicroEmacs
-
Download the following zip package files:
a. Required: Binaries for your platform (Jasspa_MicroEmacs_20240903_bin_<PLATFORM>_binaries.zip)
b. Required: Macro files (Jasspa_MicroEmacs_20240903_macros.zip)
c. Help file (Jasspa_MicroEmacs_20240903_help_ehf.zip)
d. Spelling dictionaries for any language you require (Jasspa_MicroEmacs_20240903_spelling_<LANGUAGE>.zip)
e. OpenSSL dynamic libraries (Jasspa_MicroEmacs_20240903_bin_<PLATFORM>_openssl.zip) for https/ftps support (country permitting)
-
Extract downloaded zip files into the ~/MicroEmacs directory you created in (1), this should have created:
~/MicroEmacs/bin
- containing platform directories for each of the binary packages you downloaded and extracted.~/MicroEmacs/macros
- containing many macro files (*.emf), the me.ehf help file and other supporting files.~/MicroEmacs/spelling
- containing the dictionaries of the languages you downloaded. -
Set the following environment variable:
MEINSTALLPATH=~/MicroEmacs
Setting an environment variable is platform & shell dependent.
-
Run:
~/MicroEmacs/bin/<platform>/mec
The console version should run on all platforms, if the message '[Failed to load file me]' appears at the bottom of the window then you have either not set the environment variable correctly or it has not taken effect in your current shell/command prompt.
-
Try running:
~/MicroEmacs/bin/<platform>/mew
This should always work on Windows but may not on Unix systems, particularly macOS, where an X server (XQuartz) is required to support the window interface. Fixing issues causing mew to not run is beyond the scope of this document.
-
Optionally copy the binaries (mec & mew) into a directory on your path (or add ~/MicroEmacs/bin/<platform> to your path. This simplifies running MicroEmacs in a terminal.
-
Run mew, if working, mec otherwise and follow the setup steps to create a basic user configuration area, this will create the directory:
~/MicroEmacs/<user-name>
All your customisations should go in here. Run the command user-setup (in the Tools menu) to start customising the editor.
-
Enjoy fast, free editing!
Jasspa MicroEmacs 20240902
INTRODUCTION
MicroEmacs is an Emacs like text editor for developers, its great strength is its speed, fast key-bindings and powerful
macro language. If you are looking for a menu driven editor this is probably not for you!
Jasspa MicroEmacs also has a couple of other base limitations, firstly, no real Unicode support - so you you are constantly
editing multi-language files this is probably not the best tool for you. MicroEmacs also does not support long line
wrapping in its rendering, one line of a file will always be represented as one line on the screen regardless of how
long the line is - this is MicroEmacs, if these issues are blockers to you, try Emacs.
For move information visit our Github repository.
VERY QUICK START GUIDE
For your platform download the single-file binary zip file:
-
Jasspa_MicroEmacs_20240902_abin_<PLATFORM>_mecs.zip for console/terminal app, this should work on all computers of
given platform. -
Jasspa_MicroEmacs_20240902_abin_<PLATFORM>_mews.zip for window based app, this should give best user experience
but may not work on all computers (particularly macOS where XQuartz is required).
Extract the executable for the zip and run.
This is a truly portable version, it will not alter/add to your environment or registry and will only create/edit
files you explicitly ask it to. So this version is ideal for trying MicroEmacs without affecting your computer.
For a more complete experience execute command init-session, this creates a small user configuration directory in
your user area, allowing MicroEmacs to save setup changes and download supporting files such as the comprehensive help
docs and spelling dictionaries for numerous languages.
INSTALLERS
-
Homebrew installers for Linux and macOS, details to follow.
-
Jasspa_MicroEmacs_20240902_installer_windows.msi contains the binaries for Windows, the macros and help file,
simply download and run to create a fully working environment.
Spelling dictionary can be downloaded and installed by MicroEmacs as and when required.
SLOWER QUICK START GUIDE
To build a more complete, native environment do the following:
-
Create a main MicroEmacs directory to hold all required files, this is typically ~/MicroEmacs on Unix or
c:\Users\<user-name>\MicroEmacs on Windows, but the path can be anywhere. In following steps this path will be
referred to as ~/MicroEmacs -
Download the following zip package files:
a. Required: Binaries for your platform (Jasspa_MicroEmacs_20240902_bin_<PLATFORM>_binaries.zip)
b. Required: Macro files (Jasspa_MicroEmacs_20240902_macros.zip)
c. Help file (Jasspa_MicroEmacs_20240902_help_ehf.zip)
d. Spelling dictionaries for any language you require (Jasspa_MicroEmacs_20240902_spelling_<LANGUAGE>.zip)
e. OpenSSL dynamic libraries (Jasspa_MicroEmacs_20240902_bin_<PLATFORM>_openssl.zip) for https/ftps support (country
permitting) -
Extract downloaded zip files into the ~/MicroEmacs directory you created in (1), this should have created:
~/MicroEmacs/bin
- containing platform directories for each of the binary packages you downloaded and
extracted.~/MicroEmacs/macros
- containing many macro files (*.emf), the me.ehf help file and other supporting
files.~/MicroEmacs/spelling
- containing the dictionaries of the languages you downloaded. -
Set the following environment variable:
MEINSTALLPATH=~/MicroEmacs
Setting an environment variable is platform & shell dependent.
-
Run:
~/MicroEmacs/bin/<platform>/mec
The console version should run on all platforms, if the message '[Failed to load file me]' appears at the bottom of
the window then you have either not set the environment variable correctly or it has not taken effect in your
current shell/command prompt. -
Try running:
~/MicroEmacs/bin/<platform>/mew
This should always work on Windows but may not on Unix systems, particularly macOS, where an X server (XQuartz) is
required to support the window interface. Fixing issues causing mew to not run is beyond the scope of this
document. -
Optionally copy the binaries (mec & mew) into a directory on your path (or add ~/MicroEmacs/bin/<platform> to your
path. This simplifies running MicroEmacs in a terminal. -
Run mew, if working, mec otherwise and follow the setup steps to create a basic user configuration area, this will
create the directory:~/MicroEmacs/<user-name>
All your customisations should go in here. Run the command user-setup (in the Tools menu) to start customising the
editor. -
Enjoy fast, free editing!
Jasspa MicroEmacs 20240901
INTRODUCTION
MicroEmacs is an Emacs like text editor for developers, its great strength is its speed, fast key-bindings and powerful
macro language. If you are looking for a menu driven editor this is probably not for you!
Jasspa MicroEmacs also has a couple of other base limitations, firstly, no real Unicode support - so you you are constantly
editing multi-language files this is probably not the best tool for you. MicroEmacs also does not support long line
wrapping in its rendering, one line of a file will always be represented as one line on the screen regardless of how
long the line is - this is MicroEmacs, if these issues are blockers to you, try Emacs.
VERY QUICK START GUIDE
For your platform download the single-file binary zip file:
-
Jasspa_MicroEmacs_<VERSION>_abin_<PLATFORM>_mecs.zip for console/terminal app, this should work on all computers of
given platform. -
Jasspa_MicroEmacs_<VERSION>_abin_<PLATFORM>_mews.zip for window based app, this should give best user experience
but may not work on all computers (particularly macOS where XQuartz is required).
Extract the executable for the zip and run.
This is a truly portable version, it will not alter/add to your environment or registry and will only create/edit
files you explicitly ask it to. So this version is ideal for trying MicroEmacs without affecting your computer.
For a more complete experience execute command init-session, this creates a small user configuration directory in
your user area, allowing MicroEmacs to save setup changes and download supporting files such as the comprehensive help
docs and spelling dictionaries for numerous languages.
SLOWER QUICK START GUIDE
To build a more complete, native environment do the following:
-
Create a main MicroEmacs directory to hold all required files, this is typically ~/MicroEmacs on Unix or
c:\Users\<user-name>\MicroEmacs on Windows, but the path can be anywhere. In following steps this path will be
referred to as ~/MicroEmacs -
Download the following zip package files:
a. Required: Binaries for your platform (Jasspa_MicroEmacs_<VERSION>_bin_<PLATFORM>_binaries.zip)
b. Required: Macro files (Jasspa_MicroEmacs_<VERSION>_macros.zip)
c. Help file (Jasspa_MicroEmacs_<VERSION>_help_ehf.zip)
d. Spelling dictionaries for any language you require (Jasspa_MicroEmacs_<VERSION>_spelling_<LANGUAGE>.zip)
e. OpenSSL dynamic libraries (Jasspa_MicroEmacs_<VERSION>_bin_<PLATFORM>_openssl.zip) for https/ftps support (country
permitting) -
Extract downloaded zip files into the ~/MicroEmacs directory you created in (1), this should have created:
~/MicroEmacs/bin
- containing platform directories for each of the binary packages you downloaded and
extracted.~/MicroEmacs/macros
- containing many macro files (*.emf), the me.ehf help file and other supporting
files.~/MicroEmacs/spelling
- containing the dictionaries of the languages you downloaded. -
Set the following environment variable:
MEINSTALLPATH=~/MicroEmacs
Setting an environment variable is platform & shell dependent.
-
Run:
~/MicroEmacs/bin/<platform>/mec
The console version should run on all platforms, if the message '[Failed to load file me]' appears at the bottom of
the window then you have either not set the environment variable correctly or it has not taken effect in your
current shell/command prompt. -
Try running:
~/MicroEmacs/bin/<platform>/mew
This should always work on Windows but may not on Unix systems, particularly macOS, where an X server (XQuartz) is
required to support the window interface. Fixing issues causing mew to not run is beyond the scope of this
document. -
Optionally copy the binaries (mec & mew) into a directory on your path (or add ~/MicroEmacs/bin/<platform> to your
path. This simplifies running MicroEmacs in a terminal. -
Run mew, if working, mec otherwise and follow the setup steps to create a basic user configuration area, this will
create the directory:~/MicroEmacs/<user-name>
All your customisations should go in here. Run the command user-setup (in the Tools menu) to start customising the
editor. -
Enjoy fast, free editing!
Jasspa MicroEmacs 20240801
INTRODUCTION
MicroEmacs is an Emacs like text editor for developers, its great strength is its speed, fast key-bindings and powerful
macro language. If you are looking for a menu driven editor this is probably not for you!
Jasspa MicroEmacs also has a couple of other base limitations, firstly, no real Unicode support - so you you are constantly
editing multi-language files this is probably not the best tool for you. MicroEmacs also does not support long line
wrapping in its rendering, one line of a file will always be represented as one line on the screen regardless of how
long the line is - this is MicroEmacs, if these issues are blockers to you, try Emacs.
VERY QUICK START GUIDE
For your platform download the single-file binary zip file:
- Jasspa_MicroEmacs_<VERSION>_<PLATFORM>_mecs.zip for console/terminal app, this should work on all computers of
given platform.
- Jasspa_MicroEmacs_<VERSION>_<PLATFORM>_mews.zip for window based app, this should give best user experience
but may not work on all computers (particularly macOS where XQuartz is required).
Extract the executable for the zip and run.
This is a truly portable version, it will not alter/add to your environment or registry and will only create/edit
files you explicitly ask it to. So this version is ideal for trying MicroEmacs without affecting your computer.
For a more complete experience execute command init-session, this creates a small user configuration directory in
your user area, allowing MicroEmacs to save setup changes and download supporting files such as the comprehensive help
docs and spelling dictionaries for numerous languages.
SLOWER QUICK START GUIDE
To build a more complete, native environment do the following:
-
Create a main MicroEmacs directory to hold all required files, this is typically ~/MicroEmacs on Unix or
c:\Users\<user-name>\MicroEmacs on Windows, but the path can be anywhere. In following steps this path will be
referred to as ~/MicroEmacs -
Download the following zip package files:
a. Required: Binaries for your platform (Jasspa_MicroEmacs_<VERSION>_<PLATFORM>_binaries.zip)
b. Required: Macro files (Jasspa_MicroEmacs_<VERSION>_macros.zip)
c. Help file (Jasspa_MicroEmacs_<VERSION>_hlpehf.zip)
d. Spelling dictionaries for any language you require (Jasspa_MicroEmacs_<VERSION>_ls<LANGUAGE>.zip)
e. OpenSSL dynamic libraries (Jasspa_MicroEmacs_<VERSION>_<PLATFORM>_openssl.zip) for https/ftps support (country
permitting) -
Extract downloaded zip files into the ~/MicroEmacs directory you created in (1), this should have created:
~/MicroEmacs/bin
- containing platform directories for each of the binary packages you downloaded and
extracted.~/MicroEmacs/macros
- containing many macro files (*.emf), the me.ehf help file and other supporting
files.~/MicroEmacs/spelling
- containing the dictionaries of the languages you downloaded. -
Set the following environment variable:
MEINSTALLPATH=~/MicroEmacs
Setting an environment variable is platform & shell dependent.
-
Run:
~/MicroEmacs/\<platform>/mec
The console version should run on all platforms, if the message '[Failed to load file me]' appears at the bottom of
the window then you have either not set the environment variable correctly or it has not taken effect in your
current shell/command prompt. -
Try running:
~/MicroEmacs/\<platform>/mew
This should always work on Windows but may not on Unix systems, particularly macOS, where an X server (XQuartz) is
required to support the window interface. Fixing issues causing mew to not run is beyond the scope of this
document. -
Optionally copy the binaries (mec & mew) into a directory on your path (or add ~/MicroEmacs/bin/<platform> to your
path. This simplifies running MicroEmacs in a terminal. -
Run mew, if working, mec otherwise and follow the setup steps to create a basic user configuration area, this will
create the directory:~/MicroEmacs/\<user-name>
All your customisations should go in here. Run the command user-setup (in the Tools menu) to start customising the
editor. -
Enjoy fast, free editing!