mirror of
https://github.com/lihop/godot-xterm.git
synced 2024-11-14 14:30:24 +01:00
e732712b55
Replaces the Hack font with JetBrains Mono which is the new default code editor font in Godot 4.
120 lines
7.7 KiB
Markdown
120 lines
7.7 KiB
Markdown
# Introduction
|
|
|
|
## 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 ["XTerm Control Sequences"](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](https://docs.microsoft.com/en-us/windows/console) or [WinPTY](https://github.com/rprichard/winpty).
|
|
See issue [\#25](https://github.com/lihop/godot-xterm/issues/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](https://asciinema.org).
|
|
|
|
- ### Xresources Import Plugin
|
|
Adds support for importing color schemes from `.xrdb` or `.Xresources` files.
|
|
Example xresources files can be exported from [terminal.sexy](https://terminal.sexy).
|
|
The [iTerm2-Color-Schemes repo](https://github.com/mbadolato/iTerm2-Color-Schemes) also has many example color scheme files in [xrdb](https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/xrdb) and [Xresources](https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/Xresources) format.
|
|
|
|
## Screenshots
|
|
|
|
| | |
|
|
| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
|
|
| <a href="./_static/images/screenshot_editor.png"></a> | <a href="./_static/images/screenshot_the_guest.png"></a> |
|
|
| <a href="./_static/images/screenshot_retro_term.jpg"></a> | <a href="./_static/images/screenshot_xterminate.png"></a> |
|
|
|
|
## Demos and Examples
|
|
|
|
The GodotXterm repository contains several example scenes in the {{ '[`/examples`]({}/examples)'.format(repo) }} directory.
|
|
If cloning the repo, you will need to either build the GDNative binaries from source or copy pre-compiled binaries into your project.
|
|
See the [Setup section](/setup/index.md) for more details.
|
|
|
|
Other examples of GodotXterm usage are available online:
|
|
|
|
- [**Live Demo**](https://lihop.github.io/godot-xterm-dist/demo): A Web export of the GodotXterm repo's example scenes.
|
|
|
|
:::{error}
|
|
The Web export made with the latest version of the plugin has been verified to work with Google's Chrome browser, and known not to work with Firefox.
|
|
Some aspects of this may be due to the poor compatibility of Godot 4's Web exports with various browsers.
|
|
If you are wanting to export to web, consider using an older version of the plugin built for Godot 3.
|
|
:::
|
|
|
|
- [**The Guest**](https://lihop.itch.io/the-guest): A Linux only submission to the [Linux Game Jam 2022](https://itch.io/jam/linux-game-jam-2022). Uses GodotXterm in conjunction with the [gdtemu addon](https://github.com/lihop/gdtemu) and Linux's Kernel-based Virtual Machine, to provide the player with an interactive VM that can be used in the game world.
|
|
|
|
- [**Xterminate**](https://lihop.itch.io/xterminate): A Linux, macOS, and Windows demo which uses an older version GodotXterm in conjunction with [Godot Python](https://github.com/touilleMan/godot-python).
|
|
|
|
Are you using GodotXterm in your project and want it listed here? Please [open a pull request](https://github.com/lihop/godot-xterm/pulls) to have it added.
|
|
|
|
## Supported Godot Versions
|
|
|
|
GodotXterm aims to support the current stable release of Godot, but may lag slightly.
|
|
Currently, Godot 3.x versions are supported with support for Godot 4 coming soon.
|
|
|
|
:::{tip}
|
|
Godot 3.3.x versions are no longer officially supported but _may_ work if the GDNative libraries are compiled using an older version of godot-cpp.
|
|
:::
|
|
|
|
## Installation
|
|
|
|
GodotXterm is available on the [Godot Asset Library](https://godotengine.org/asset-library/asset/1007).
|
|
For more ways to install see the [Setup section](/setup/index.md).
|
|
|
|
## Help
|
|
|
|
Documentation is available here on [Read the Docs](https://docs.godot-xterm.nix.nz).
|
|
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](https://github.com/lihop/godot-xterm/discussions) section of the project repo.
|
|
|
|
## License
|
|
|
|
Copyright (c) 2020-2024, Leroy Hopson and [contributors](https://github.com/lihop/godot-xterm/graphs/contributors) (MIT License).
|
|
|
|
See the {{ '[full license]({}/LICENSE.md)'.format(repo) }}.
|
|
|
|
### 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]({}/addons/godot_xterm/THIRDPARTY_NOTICES.txt)'.format(repo) }} 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]({}/addons/godot_xterm/THIRDPARTY_NOTICES_nopty.txt)'.format(repo) }} are applicable.
|
|
:::
|
|
|
|
### Fonts
|
|
|
|
- The [JetBrains Mono](https://www.jetbrains.com/lp/mono/) NL (no ligatures) Regular font is bundled with GodotXterm as the default Terminal font.
|
|
This is same as the default monospace font used by the Godot editor.
|
|
It is released under the terms of the {{ '[SIL Open Font License]({}/addons/godot_xterm/themes/fonts/jet_brains_mono/OFL.txt)'.format(repo) }}.
|
|
|
|
### 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 the project repository for demo and testing purposes. They are:
|
|
|
|
#### Fonts
|
|
|
|
- The **bold**, _italic_, and **_bold italic_** styles of the JetBrains Mono NL font, covered by the same font license as above.
|
|
- Nerd Fonts. Combines symbols from a multitude of other fonts. See {{ '[license information]({}/themes/fonts/nerd_fonts/README.md)'.format(repo) }}.
|
|
- Noto Color Emoji. Released under the {{ '[SIL Open Font License]({}/themes/fonts/noto_color_emoji/LICENSE_OFL.txt)'.format(repo) }}.
|
|
- 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]({}/themes/fonts/unifont/LICENSE_OFL-1.1.txt)' }}.
|
|
|
|
#### Sounds
|
|
|
|
- {{ '[bell.wav]({}/themes/audio/bell.wav)'.format(repo) }} by [InspectorJ](https://www.jshaw.co.uk), downloaded from [freesound.org](https://freesound.org/people/InspectorJ/sounds/484344/), released under [CC-BY-3.0](https://creativecommons.org/licenses/by/3.0/).
|