https://github.com/jixiuf/emacs-tsmterm
https://github.com/jixiuf/emacs-tsmterm
emacs libtsm terminal-emulators
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jixiuf/emacs-tsmterm
- Owner: jixiuf
- License: gpl-3.0
- Created: 2018-10-28T11:30:00.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-11-01T09:02:03.000Z (over 7 years ago)
- Last Synced: 2025-01-21T19:11:25.648Z (over 1 year ago)
- Topics: emacs, libtsm, terminal-emulators
- Language: C
- Size: 71.3 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Introduction
This emacs module implements a bridge to libtsm to display a terminal in a
emacs buffer.
## Warning
This is not finished, so it will crash your emacs. If it does, please
report a bug!
# Installation forked version libtsm
https://github.com/jixiuf/libtsm
# Installation
```
git clone https://github.com/akermu/emacs-tsmterm.git
```
```
mkdir -p build
cd build
cmake ..
make
```
And add this to your `init.el`:
```
(add-to-list 'load-path "path/to/emacs-tsmterm")
(require 'tsmterm)
```
If you want to have the module compiled, wrap the call to `require` as follows:
```
(add-to-list 'load-path "path/to/emacs-tsmterm")
(require 'tsmterm)
```
# 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
## `tsmterm`
Open a terminal in the current window.
## `tsmterm-other-window`
Open a terminal in another window.
# Customization
## `tsmterm-shell`
Shell to run in a new tsmterm. Defaults to `$SHELL`.
## `tsmterm-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:
- tsmterm
- tsmterm-color-black
- tsmterm-color-red
- tsmterm-color-green
- tsmterm-color-yellow
- tsmterm-color-blue
- tsmterm-color-magenta
- tsmterm-color-cyan
- tsmterm-color-white