Metadata-Version: 2.1
Name: ttyGotcha
Version: 1.0.1
Summary: SSH-TTY control Interface
Home-page: https://github.com/caputomarcos/gotcha
Author: Marcos Caputo
Author-email: caputo.marcos@gmail.com
License: MIT
Keywords: hunter,security
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Security
Requires-Python: >=3.10.7
Description-Content-Type: text/markdown
License-File: LICENSE

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
    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
