blob: d96bf365e8d73ed52b3166eeb268f2bfc54e6a9a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
# Introduction
This emacs module implements a bridge to libvterm to display a terminal in a
emacs buffer.
## Warning
This is a **alpha-release**, so it will crash your emacs. If it does, please
report a bug!
# Installation
```
git clone https://github.com/akermu/emacs-libvterm.git
```
```
mkdir -p build
cd build
cmake ..
make
```
And add this to your `init.el`
```
(add-to-list 'load-path "path/to/emacs-libvterm")
```
# Debugging and testing
If you have successfully build the module, you can test the module by executing
the following command in the `build` directory:
```
make run
```
# Usage
```
M-x vterm-create
```
# Customization
## `vterm-shell`
Shell to run in a new vterm. Defaults to `$SHELL`.
## `vterm-keymap-exceptions`
List of keys, which should be processed by emacs and not by the terminal.
## Colors
Set the `:foreground` and `:background` attributes of the following faces to a
color you like:
- vterm
- vterm-color-black
- vterm-color-red
- vterm-color-green
- vterm-color-yellow
- vterm-color-blue
- vterm-color-magenta
- vterm-color-cyan
- vterm-color-white
# Limitations
- No support for scrolling (But you can use tmux/screen to emulate scrolling)
- Hijacks SIGUSR1
- Mouse support is non-existing
|
