From 2d37a9fb398a7f15df2479a46b645044170f8b7c Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Sun, 7 Nov 2021 11:15:49 +0200
Subject: add asciinema readme

---
 doc/asciinema/README.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 doc/asciinema/README.md

(limited to 'doc')

diff --git a/doc/asciinema/README.md b/doc/asciinema/README.md
new file mode 100644
index 0000000..061657d
--- /dev/null
+++ b/doc/asciinema/README.md
@@ -0,0 +1,41 @@
+asciinema
+=========
+
+The animated Gifs you find in the DTail docs were created using:
+
+* [asciinema](https://asciinema.org) 
+* [asciicast2gif](https://github.com/asciinema/asciicast2gif)
+
+On Fedora Linux 35.
+
+## Installing prerequisites
+
+On Fedora Linux 35 install `asciinema`:
+
+```shell
+% sudo dnf install -y asciinema
+```
+
+and `asciicast2gif` (for simplicity, the Docker image was used):
+
+```shell
+% docker pull asciinema/asciicast2gif
+```
+
+This of course assumes that Docker is up and running on your machine (out of scope for this documentation).
+
+## Record a shell session
+
+This is as simple as running
+
+```shell
+% asciinema rec recording.json
+```
+
+This will launch a sub-shell to be recorded. Once done, exit the sub-shell with `exit`.
+
+## Convert the recording to a gif
+
+```shell
+% docker run --rm -v $PWD:/data asciinema/asciicast2gif -s 2 recording.json recording.gif
+```
-- 
cgit v1.2.3