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.7.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.7-py3-none-any.whl (10.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kautolog-1.1.7.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.7.tar.gz
Algorithm Hash digest
SHA256 11f486836973342fe8ce8f40c5a84b31242cf802747ed7968bcbc1380d43b673
MD5 8fa3e4dc4e1f51f18feb77570914d7c4
BLAKE2b-256 dced067ed2484dfe0c0b9a3893937af0825a926dd5a4082674b7c3be237d35a8

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: kautolog-1.1.7-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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 dca343de797e89ead66bfa6de949c1104e52469c32dc1569e6492e41e0e89d05
MD5 2d86b7622a245b2f76115be89d904423
BLAKE2b-256 02abe446e830282e970d4a83faa5bfacb3fdca12ddbb9c690d143071293add1e

See more details on using hashes here.

Provenance

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