Import plugins

GodotXterm includes custom import plugins that automatically handle specific file formats commonly used with terminals. These plugins integrate with Godot’s import system to convert external files into native Godot resources that can be used directly in your project.

Asciicast

Asciinema is a terminal session recorder that creates lightweight, text-based recordings of terminal sessions. Instead of video files, it produces JSON-based recordings that capture the exact terminal output and timing.

The Asciinema import plugin allows you to import asciicast recording files (.cast files) as Godot Animation resources. You can download example recordings from asciinema.org or create your own using the asciinema rec command.

To use asciicast files in your Godot project:

  1. Copy any .cast file into your project directory.

  2. Add a Terminal node and AnimationPlayer to your scene, setting the AnimationPlayer’s root node to the Terminal (default if the AnimationPlayer is added as a child of Terminal).

  3. In the AnimationPlayer’s libraries, add the imported .cast file as an animation.

  4. The animation will call the Terminal’s write() method with the recorded terminal output and timing.

Asciicast .cast imported and used via AnimationPlayer on a Terminal node

X resources

X resources is a configuration system used by X11 applications, particularly terminal emulators, to define colors, fonts, and other appearance settings. The X resources import plugin automatically converts X resource files (.xrdb, .Xresources, .xresources) into Godot Theme resources. Once imported, these resources can be applied to the Terminal node’s Theme property in the inspector.

Imported Xresources theme selected in the Terminal node's Theme property

Popular sources for Xresources color schemes: