Skip to content

caputomarcos/gotcha

Repository files navigation

GOTCHA - The SSH-TTY control Interface

Requirements

  • Python 3.10.7
  • Linux syscall tracer (strace) <https://strace.io/>
  • Root Privileges Required.

Installation

From source:

git clone https://github.com/caputomarcos/gotcha.git
cd gotcha
python3 -m venv venv
source venv/bin/activate
pip install -r requirements-dev.txt
make build && make pyinstaller
sudo make install

From pypi:

sudo su -
pip3 install ttyGotcha

Usage:

$ gotcha
    usage: gotcha [-h] [-v] [-q] [-l] [-s [{1,2,3}]] [-t [tty]] [-a] [--replay [session]] [--speed [speed]] [--snapshot [session]]

    ·:.                                                            .:·

         ██████╗  ██████╗ ████████╗ ██████╗██╗  ██╗ █████╗ ██╗██╗██╗
        ██╔════╝ ██╔═══██╗╚══██╔══╝██╔════╝██║  ██║██╔══██╗██║██║██║
        ██║  ███╗██║   ██║   ██║   ██║     ███████║███████║██║██║██║
        ██║   ██║██║   ██║   ██║   ██║     ██╔══██║██╔══██║╚═╝╚═╝╚═╝
        ╚██████╔╝╚██████╔╝   ██║   ╚██████╗██║  ██║██║  ██║██╗██╗██╗
         ╚═════╝  ╚═════╝    ╚═╝    ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝╚═╝

    .:·                                                             ·:.

    options:
    -h, --help            show this help message and exit
    -v, --verbose         Turn on verbose output
    -q, --quiet           Enable quiet mode
    -l, --list            List available SSH Sessions
    -s [{1,2,3}], --session-files [{1,2,3}]
                            List Session Files
    -t [tty], --tty [tty]
                            Point GOTCHA to specific TTY
    -a, --auto            Lazy mode, auto-attach to first found session
    --replay [session]    Play previously recorded session
    --speed [speed]       Playback Speed
    --snapshot [session]  Export Session Output to Text Format


        *** root privileges required for this software. ***

WITH sudo:

sudo gotcha
usage: gotcha [-h] [-v | -q] [-l | -s [{1,2,3}] | -t [tty] | -a | --replay [session]]

Community Distributions

Feel free! All contributions are welcome. =)

TO DO

-v, --verbose Turn on verbose output
-q, --quiet Enable quiet mode