Comprehensive logging of all terminal input and output for each session based on Asciinema and wild zsh + Python scripting.
This tool is a strong modification of my former logging project https://github.com/cmprmsd/cLoggy with many features removed in order to focus on and extend the core features.
Each terminal in the context of root will create a .cast file and a .commands.log file.
For each sudo user a directory will be created:
Each excecuted command will be logged and written to the commands.log file with the current timestamp of execution. All raw input and output will be streamed to the .cast file which contains escape sequences for every change in the terminal.
The main feature of this plugin is the log organization, search and web player.
The search functionality can be used with hist e.g. hist <term> and hist <terms with spaces>.
This will search the executed commands but not the output.
It will output a dropdown selection menu that you can navigate with keyboard or mouse(wheel).
In order to search through both the executed commands and the terminal output you may specify -a as first argument.
You'll differentiate commands from output by the filename of each match.
Once you press enter on a selection, the link to the Cinelog Viewer will be printed to the terminal.
This feature is a simple webserver. Your selected cast will be viewed in this web player.
I applied some magic to summon the ingestion of chapter markers to the video timeline for each executed command. That way, you can easily navigate between commands via [ and ].
- Download and install zsh zim framework:
curl -fsSL https://raw.githubusercontent.com/zimfw/install/master/install.zsh | zsh - Remove
compinitfrom your .zshrc if needed - Install asciinema
apt install asciinema - Edit .zimrc and add
zmodule cmprmsd/cinelog - Run
zimfw installto download the plugin from GitHub - Start a new terminal
- Verify installation with
logs treeand verify if thehistcommand is available - Check if the Python webserver is running on port 10000
- For future updates
zimfw updateshould suffice
By default for each cwd a history file will be created in ~/.zsh_history.d/. Using the alias here the executed commands in this directory will be printed, which is helpful for less often used git repositories you don't know how you got working.
The terminal will by default output some information about the current networking stack, disk space and the log destination.
You can opt-out of several extra features by changing your config file in .config/cinelog/cinelog-settings.conf.
Thanks to Marcin ku1ik for his awesome asciinema suite!