Metadata-Version: 2.4
Name: kautolog
Version: 1.1.7
Summary: Kali/Linux auto-logging of all terminal sessions using script(1), with optional tmux, logrotate, and rclone sync.
Author-email: Mark Sowell <mark@marksowell.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/marksowell/kautolog
Project-URL: Issues, https://github.com/marksowell/kautolog/issues
Keywords: kali,linux,logging,terminal,script,tmux,logrotate,rclone
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: typer>=0.12.0
Dynamic: license-file

# kautolog

[![PyPI version](https://img.shields.io/pypi/v/kautolog.svg)](https://pypi.org/project/kautolog/)

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:

```bash
pipx install kautolog
kautolog install
```

With extras:

```bash
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:

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

To instantly dump the log without delay:

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

## Uninstall

```bash
kautolog uninstall
```

Removes all shell hooks and scripts cleanly.

If you installed using pipx:

```bash
pipx uninstall kautolog
```

## Log Format

Logs are saved to:

```bash
~/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](https://github.com/marksowell/kautolog/blob/main/LICENSE)
