segeljakt / xterm-js-rs

Rust-WebAssembly bindings to the xterm-js Javascript library

Home Page:https://xtermjs.org/

Repository from Github https://github.comsegeljakt/xterm-js-rsRepository from Github https://github.comsegeljakt/xterm-js-rs

πŸ•Έ xterm-js-rs πŸ¦€

This crate provides Rust-WebAssembly bindings to the xterm-js Javascript library and can be used to setup a custom web-based command-line for your crate, without much effort, running at the client-side.

πŸŽ₯ Example

To see it running in action on GitHub Pages: https://segeljakt.github.io/xterm-js-rs. Code for the example can be found here.

πŸš€ GitHub Actions and GitHub Pages

The GitHub Actions workflow for automatically deploying the website to GitHub Pages can be found here along with instructions to setup GitHub Pages.

πŸ”¬ Documentation

For an overview of what the bindings do, checkout the official API.

🎚 Addons

Conditionally, addons of xterm-js can be activated by compiling this crate with the corresponding features enabled:

  • xterm-addon-attach
  • xterm-addon-fit
  • xterm-addon-ligatures
  • xterm-addon-search
  • xterm-addon-serialize
  • xterm-addon-unicode11
  • xterm-addon-web-links
  • xterm-addon-webgl

⚠️ Information

If your npm-crate depends on this crate, then it must contain a package.json in the root directory and www directory which specifies the dependencies to the xterm-js library. As in the example:

πŸ‘· Help Wanted

Help with adding support for xterm-js-rs in existing Rust-REPL-libraries (linefeed, liner, rustyline, termwiz) is greatly appreciated!

πŸ˜• TODO

  • Add proper documentation, tests, and cleaner API.

About

Rust-WebAssembly bindings to the xterm-js Javascript library

https://xtermjs.org/

License:MIT License


Languages

Language:Rust 97.3%Language:JavaScript 1.7%Language:HTML 1.1%