Skip to main content

Kali/Linux auto-logging of all terminal sessions using script(1), with optional tmux, logrotate, and rclone sync.

Project description

kautolog

PyPI version

Auto-log everything you see in every terminal tab on Kali/Linux using script(1). Captures prompt, commands, output, ANSI colors, and ncurses apps with optional timing/replay, tmux per-pane logs, logrotate, and rclone cloud sync.

Install

Recommended:

pipx install kautolog
kautolog install

With extras:

kautolog install --with-tmux --with-sync remote:terminal-logs --interval 10

This will:

  • Hook into both ~/.bashrc and ~/.zshrc for Zsh and Bash auto-logging.
  • Install kautolog-replay script into ~/.local/bin.

Replaying logs

To replay a session with timing:

kautolog -r ~/terminal-logs/2025/08/10/kali-33608-203123

To instantly dump the log without delay:

kautolog -i ~/terminal-logs/2025/08/10/kali-33608-203123

Uninstall

kautolog uninstall

Removes all shell hooks and scripts cleanly.

If you installed using pipx:

pipx uninstall kautolog

Log Format

Logs are saved to:

~/terminal-logs/YYYY/MM/DD/hostname-PID-TIMESTAMP.log
~/terminal-logs/YYYY/MM/DD/hostname-PID-TIMESTAMP.timing

If --with-tmux is used, each tmux pane logs independently.

License

The scripts and documentation in this project are released under the MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kautolog-1.1.6.tar.gz (9.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kautolog-1.1.6-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

Details for the file kautolog-1.1.6.tar.gz.

File metadata

  • Download URL: kautolog-1.1.6.tar.gz
  • Upload date:
  • Size: 9.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for kautolog-1.1.6.tar.gz
Algorithm Hash digest
SHA256 c7b141b2c273fbeed2d3a9c6b79405f05fa0be7b5e365dc2ddd665ce78698ce4
MD5 46ae48be341fcbdf2c375a7c927a8870
BLAKE2b-256 3be1307a2f5c5d8de0f9ca33745634908c43062dfccf12fa41feb8f35bcd011b

See more details on using hashes here.

Provenance

The following attestation bundles were made for kautolog-1.1.6.tar.gz:

Publisher: publish.yml on marksowell/kautolog

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file kautolog-1.1.6-py3-none-any.whl.

File metadata

  • Download URL: kautolog-1.1.6-py3-none-any.whl
  • Upload date:
  • Size: 10.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for kautolog-1.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 8dafd59ec008b2db270243efdd98f1e0e0239fdfabc7c9f2a0d51c0bb4c1dadc
MD5 7b7bae61f3ee20cc3346ac06bf0cc4d3
BLAKE2b-256 c8e32e14f8f6cebff687b486569dcb93ba8c94150601c6b4b71a175d60f80ebc

See more details on using hashes here.

Provenance

The following attestation bundles were made for kautolog-1.1.6-py3-none-any.whl:

Publisher: publish.yml on marksowell/kautolog

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page