README

Synopsis

Tool to record tmux / byobu session history to a tarball, and automation to maintain a backup of the current session to be retained indefinitely after reboot.

Status

polishing and testing before release.

systemd automaton WIP

install automation needs validation

Installation

Install dependancies: (Distros using dnf)

sudo dnf install tmux byobu

Install dependancies: (Distros using apt)

sudo apt-get update && apt-get upgrade -y;
sudo apt-get install -y tmux byobu

Setup script in user-specific executables dir (~/bin) for easy running:

mkdir -v ~/bin
cp -v  tmux-dump-session.sh ~/bin
chmod -v +x ~/bin/*.sh
printf '%s\n' 'export PATH="${HOME}/bin:${PATH}"'  | tee -a ~/.bashrc

cat bashrc-dropins.sh | tee -a ~/.bashrc
source ~/.bashrc

Configuration

Configuration is done via environment variables.

Manual usage

Just run the session dumper script and you'll get a copy of session history produced.

./tmux-dump-pane-history.sh

If script is in a dir on $PATH:

tmux-dump-pane-history.sh

Links

User-specific systemd timer + service:

• https://wiki.archlinux.org/title/Systemd#Writing_unit_files
• https://wiki.archlinux.org/title/Systemd/Timers
• https://man.archlinux.org/man/systemd.unit.5
• https://www.freedesktop.org/software/systemd/man/latest/systemd.service.html
• https://www.freedesktop.org/software/systemd/man/latest/systemd.unit.html
• https://www.freedesktop.org/software/systemd/man/latest/systemd.exec.html