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 replay script into ~/.local/bin.

Replaying logs

To replay a session with timing:

replay ~/terminal-logs/2025/08/10/kali-33608-203123

To instantly dump the log without delay:

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.4.tar.gz (8.7 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.4-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kautolog-1.1.4.tar.gz
  • Upload date:
  • Size: 8.7 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.4.tar.gz
Algorithm Hash digest
SHA256 8e54abdb1e00309cf60a8c86920c4d825db3949b6b68e7f08fb8e68b402129a4
MD5 eb3251979a1211f08b447bd1a82244ee
BLAKE2b-256 de3d95ba712790ae3fe5b12657704f28ead939295fb3bf4945618426dd36d804

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: kautolog-1.1.4-py3-none-any.whl
  • Upload date:
  • Size: 10.1 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 7337f84c11214a32f808245db15b2b19d869a880448af659f507f6e5efcbd83b
MD5 60bc6def6c1d7ef31fe8e358ba549f7d
BLAKE2b-256 3cdaac56f302d0f67204d45e17cb0eeb9e2cacb4c0747377330c29abd3abcf24

See more details on using hashes here.

Provenance

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