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

Uploaded Python 3

File details

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

File metadata

  • Download URL: kautolog-1.1.8.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.8.tar.gz
Algorithm Hash digest
SHA256 11e4217c5477e2b7422de444d2392c601fcc2403986342bf3df4a9af8ebde538
MD5 a677ebb15a8c298dc30288a52ce023b3
BLAKE2b-256 7c9b0e1e2e9a0dcbbee723e956004d53f71909147caae6806ddd8bad4f0de58b

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: kautolog-1.1.8-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.8-py3-none-any.whl
Algorithm Hash digest
SHA256 94a8142b26195ee4ac566fccb6765ff9c95e662bd92d132c65a683dad3f0cdeb
MD5 91fabd50d13042101494b7fef775afe4
BLAKE2b-256 1e9fc9a2a0f4f1a2f7e4e872ff7867ed95c67c8de7e283381723db04936fb5cb

See more details on using hashes here.

Provenance

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