History

Henrik Lissner 77e4cc4d58 💥 Remove :feature category :feature was a "catch-all" category. Many of its modules fit better in other categories, so they've been moved: - feature/debugger -> tools/debugger - feature/evil -> editor/evil - feature/eval -> tools/eval - feature/lookup -> tools/lookup - feature/snippets -> editor/snippets - feature/file-templates -> editor/file-templates - feature/workspaces -> ui/workspaces More potential changes in the future: - A new :term category for terminal emulation modules (eshell, term and vterm). - A new :os category for modules dedicated to os-specific functionality. The :tools macos module would fit here, but so would modules for nixos and arch. - A new :services category for web-service integration, like wakatime, twitter, elfeed, gist and pastebin services.		2019-04-24 18:16:04 -04:00
..
autoload.el	tools/vterm: minor refactor	2019-03-13 20:41:48 -04:00
config.el	💥 Remove :feature category	2019-04-24 18:16:04 -04:00
doctor.el	tools/vterm: minor refactor	2019-03-13 20:41:48 -04:00
packages.el	Include all files with vterm package	2019-02-18 18:49:02 -05:00
readme.org	More specific about "use vterm"	2019-02-22 00:58:31 +08:00

tools/vterm

Description

You have to compile emacs with --with-modules option.

Check the system-configuration-options variable to see if your emacs has this option.

On Archlinux or Manjaro, if you install emacs with pacman, this option is enabled.
On macOS:
- If you use Emacs For Mac OS X, this option is enabled.
- If you use emacs-plus, this option is enabled by default.
- If you use emacs-mac, this options is not enabled by default. You may have to reinstall emacs with the option:
```
brew install emacs-mac --with-modules
```

You need to have libvterm installed in your system.

On Ubuntu or Debian:

sudo apt install libvterm-dev

On ArchLinux or Manjaro:

sudo pacman -S libvterm

On macOS:

brew install libvterm

You have to compile and install the requied module vterm-module.so.

In order to compile it you need to have:

Compilation tools. This include make, cmake and a c compiler such as gcc.
Internet connection, because cmake will automatically download some requied libraries from the internet.

There are several ways to install the module:

You can use M-x vterm-module-compile to let emacs automatically compile and install the module. WARNING: Emacs will hang during the compilation. It may take a while.
A fully byte-compile will cause emacs to automatically compile and install the module if it cannot find an executable vterm-module.so file.
You can compile and install the module yourself. Go to the vterm installation directory, which is usually ~/.emacs.d/.local/packages/elpa/vterm-<version>, and run the following:
```
mkdir -p build
cd build
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo ..
make
```
You can also compile the module at other place, and install the compiled vterm-module.so file to your vterm installation folder, which is usually ~/.emacs.d/.local/packages/elpa/vterm-<version>/. Also make sure the module file is executable.