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 replay ~/terminal-logs/2025/08/10/kali-33608-203123

To instantly dump the log without delay:

kautolog replay -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.9.tar.gz (8.9 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.9-py3-none-any.whl (10.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kautolog-1.1.9.tar.gz
  • Upload date:
  • Size: 8.9 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.9.tar.gz
Algorithm Hash digest
SHA256 3600faa19a4489a4ff336f47adaa7c53feae8b04b2621904e85f9a6aa59c04f9
MD5 5cdc108537ef90ed3f7155565249c51d
BLAKE2b-256 8d1361aa928d108c921b861296edd0e681cca688ba462b3966eb4affb1fca064

See more details on using hashes here.

Provenance

The following attestation bundles were made for kautolog-1.1.9.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.9-py3-none-any.whl.

File metadata

  • Download URL: kautolog-1.1.9-py3-none-any.whl
  • Upload date:
  • Size: 10.5 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.9-py3-none-any.whl
Algorithm Hash digest
SHA256 cc76b7b6d95b8ded5ffa30f115c9688b6559a0ee93f28832168eabf74fd7588b
MD5 1a80fff14e5ef8335389d100d73eb476
BLAKE2b-256 75ff40568050fa241272a6e18f9ebd37d5bc28f0dc408010d726dafe3afb24c5

See more details on using hashes here.

Provenance

The following attestation bundles were made for kautolog-1.1.9-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