Jasima/godot-xterm
1
0
Fork 0
mirror of https://github.com/lihop/godot-xterm.git synced 2024-11-13 22:10:25 +01:00
Code Issues Projects Releases Packages Wiki Activity
Terminal emulator for the Godot game engine.
209 commits 13 branches 13 tags 138 MiB
GDScript 78.8%
C++ 15.8%
Python 2%
Shell 1.8%
cpp 1.2%
Other 0.4%
Find a file
Leroy Hopson 5f7dc2c247
Use default export templates for HTML5 
Changes Emscripten SDK version to match that used to compile the default export
templates used by Godot 3.4 (in this case 2.0.25 as can be seen here:
https://github.com/godotengine/build-containers/blob/3.4/Dockerfile.javascript).

This means we no longer need to compile custom export templates when
exporting HTML5 for Godot 3.4. Exports from other Godot versions may
requiring compiling the GDNative library with a different version of the
Emscripten SDK.
2022-08-03 12:29:10 +12:00
.github Use default export templates for HTML5 2022-08-03 12:29:10 +12:00
addons Use default export templates for HTML5 2022-08-03 12:29:10 +12:00
docs Use default export templates for HTML5 2022-08-03 12:29:10 +12:00
examples Ignore unused return value 2022-07-11 09:33:00 +12:00
misc Use default export templates for HTML5 2022-08-03 12:29:10 +12:00
test Stop testing for Godot version 3.2 2022-07-12 12:51:24 +12:00
themes Add retro term example scene 2021-07-25 07:50:36 +07:00
.gitattributes Add job to check GDScript format 2022-07-11 09:33:01 +12:00
.gitignore Add GUT (CLI only) and remove gd-plug 2022-07-11 09:33:00 +12:00
.gitmodules Use default export templates for HTML5 2022-08-03 12:29:10 +12:00
CHANGELOG.md Bump version to 2.1.0 2022-07-11 09:33:01 +12:00
default_env.tres Basics working, added pseudoterminal 2020-10-05 17:56:21 +07:00
export_presets.cfg Use default export templates for HTML5 2022-08-03 12:29:10 +12:00
icon.png Change to the old icon 2020-10-05 18:16:17 +07:00
icon.png.import Automatic editor updates v3.4.4-stable 2022-05-31 18:34:51 +07:00
LICENSE.md Update license information 2021-07-07 21:39:54 +07:00
project.godot Add GUT (CLI only) and remove gd-plug 2022-07-11 09:33:00 +12:00
README.md Update status badges 2021-12-17 15:48:06 +07:00
requirements.txt Update GDScript Toolkit 2022-07-11 09:33:01 +12:00

README.md

GodotXterm

Godot Version License Build and Test

GDNative terminal for Godot. Built using libtsm, libuv, and node-pty. Primarily developed and tested on Linux, it also supports macOS with partial support for Windows and HTML5. See the Features section for more detail.

https://user-images.githubusercontent.com/3696783/126894061-a69eb6ad-9979-4723-ade7-829494a9fc87.mp4

Documentation

Documentation is available in the wiki. If you have a question not answered by the docs, or would like more support, feel free to open a new discussion in the discussions section of this project.

Features

  • Terminal

    A Terminal emulator Control node.

    Supports ANSI and (some) XTerm Control Sequences which can be used to do things such as clear the screen, move the cursor, change printed text color, ring a bell, and so on. For an exhaustive list of terminal control sequences (not all of which are supported by GodotXterm) see https://invisible-island.net/xterm/ctlseqs/ctlseqs.html.

  • PTY

    Linux and macOS only.

    Node for forking processes (e.g. bash, nodejs, python) with pseudoterminal file descriptors. Can be used with the Terminal node to get an actual shell.

    Not currently supported on Windows, but it could be in the future using ConPTY or WinPTY. See issue #25.

  • Terminal Editor Plugin

    Linux and macOS only.

    Adds a panel to the Editor's bottom panel that can be used to spawn terminals in the editor. Similar to VSCode's integrated terminal and IntelliJ's embedded terminal.

  • Asciicast Import Plugin

    Adds support for importing asciinema v2 .cast files as animations that can be played by an AnimationPlayer that is a child of a Terminal node. Example .cast files can be downloaded from the asciinema website.

  • Xresources Import Plugin

    Adds support for importing color schemes from .xrdb or .Xresources files. Example xresources files can be exported from terminal.sexy. The iTerm2-Color-Schemes repo also has many example color scheme files in xrdb and Xresources format.

Installation

GodotXterm is available on the Godot Asset Library: https://godotengine.org/asset-library/asset/1007. For more ways to install see the Installation page on the wiki.

Demos

  • Online demo of an HTML5 export of this repo (using the GDNative export type, available since Godot 3.3). Make sure you click the screen at least once after loading.

  • Xterminate. A Linux, macOS, and Windows demo, which uses an older version GodotXterm in conjunction with Godot Python.

  • This repository also contains a number of demo scenes in the examples directory. The easiest way to run these scenes is to clone this repo and then download the libgodot-xterm-release.zip archive from the Releases section and extract its contents (.so, .wasm, .dll, and .dylib files) into the addons/godot_xterm/native/bin directory.

License

Copyright (c) 2020-2021, Leroy Hopson and contributors (MIT License).

Third-party components

The GDNative source code incorporates code snippets and source code from many third-party libraries. The licenses of these components can be found in the various sub-directories of this project (provided git submodules have been cloned). Many of these licenses must be distributed with source and binary distributions of this software. For convenience, the texts of these licenses have been bundled together (but clearly demarcated) in the THIRDPARTY_NOTICES.txt file.

Note: On platforms where the PTY node is not supported or if the library has been compiled with the option disable_pty=yes then only the licenses bundled in THIRDPARTY_NOTICES_nopty.txt are applicable.

Fonts

  • The Hack regular font is bundled with GodotXterm as the default Terminal font. This is also the default monospace font of the Godot editor. See the full license.

Nonbundled Resources

The following resources are not bundled with GodotXterm (i.e. are not included in the addons/godot_xterm directory) but are included in this repository for demo and testing purposes. They are:

Sounds

Fonts

  • The bold, italic, and bold italic styles of the Hack font which are covered by the same license as above.
  • Nerd Fonts. Combines symbols from a multitude of other fonts. See license information.
  • Noto Color Emoji. Released under the SIL Open Font License.
  • Unifont. Dual-licensed (since version 13.0.04) under the GNU GPL 2+ with the GNU font embedding exception and the SIL Open Font License (OFL) version 1.1. This project uses it under the terms of the SIL Open Font License.