swordfish-rs

Cli tool for typing effect in Termainl for screencasts and demos:

1. 💬 Describe what you are doing
2. ⚡️ Run any terminal command and get their outputs to screen
3. 🤖 Reproducable steps - iterate on the screenplay file till perfection
4. 😎 Mimick real person behaviour with realtime typing into terminal

Demo

Example screenplay.yaml file:

- !clear
- !write {msec: 0, color: green, text:  "$ "}
- !write {msec: 20, text:    "i am going to list this dir"}
- !wait {msec: 1000}
- !erase {msec: 20, by_chars: xxxxxxxxxxxxxxxxxxxxxxxxxxx }
- !wait {msec: 1000}
- !write {msec: 20, text: ls}
- !wait {msec: 1000}
- !execute {line: ls -la}
- !wait {msec: 3000}
- !write {msec: 1000, color: green, text:  "$ "}
- !write {msec: 20, text: "bye, press any key..."}
- !pause

Running swordfish screenplay.yaml:

Quick start

Install

cargo install swordfish-rs

Usage

Create a screenplay file and run swordfish:

swordfish path/to/file.yaml

Commands

The follwoing comamnds are available, commands are witten with ! before the command name, for example !clear.

write

Write text to the terimal.

erase

Erase charecters to the left.

Use either amount or by_chars or both.

execute

Execute shell commands or other applications and show their output.

The output is presented, while the executed command itself will not show.

wait

clear

Clear screen command.

pause

Pause before next command and wait for user input (any key...)

prompt

Prompt specify a constant text that is shown after every execute and cis not affected by erase.