view release on metacpan or  search on metacpan

README.md  view on Meta::CPAN

[![Actions Status](https://github.com/kaz-utashiro/greple-pw/workflows/test/badge.svg)](https://github.com/kaz-utashiro/greple-pw/actions) [![MetaCPAN Release](https://badge.fury.io/pl/App-Greple-pw.svg)](https://metacpan.org/release/App-Greple-pw)
# NAME

pw - Interactive password and ID information extractor for greple

# SYNOPSIS

    # Basic usage
    greple -Mpw pattern file

    # Search in encrypted files
    greple -Mpw password ~/secure/*.gpg

    # Configure options
    greple -Mpw --no-clear-screen --chrome password data.txt
    greple -Mpw --config timeout=600 --config debug=1 password file.txt

# VERSION

Version 1.02

# DESCRIPTION

The **pw** module is a **greple** extension that provides secure, interactive
handling of sensitive information such as passwords, user IDs, and account
details found in text files. It is designed with security in mind, ensuring
that sensitive data doesn't remain visible on screen or in terminal history.

## Key Features

- **Interactive password handling**

    Passwords are masked by default and can be safely copied to clipboard
    without displaying the actual content on screen.

- **Secure cleanup**

    Terminal scroll buffer and screen are automatically cleared when the
    command exits, and clipboard content is replaced with a harmless string
    to prevent sensitive information from persisting.

- **Encrypted file support**

    Seamlessly works with PGP encrypted files using **greple**'s standard
    features. Files with "_.gpg_" extension are automatically decrypted,
    and the **--pgp** option allows entering the passphrase once for
    multiple files.

- **Intelligent pattern recognition**

    Automatically detects ID and password information using configurable
    keywords like "user", "account", "password", "pin", etc. Custom
    keywords can be configured to match your specific data format.

- **Browser integration**

    Includes browser automation features for automatically filling web
    forms with extracted credentials.

Some banks use random number matrices as a countermeasure for tapping.
If the module successfully guesses the matrix area, it blacks out the
table and remembers them.

      | A B C D E F G H I J
    --+--------------------
    0 | Y W 0 B 8 P 4 C Z H
    1 | M 0 6 I K U C 8 6 Z
    2 | 7 N R E Y 1 9 3 G 5
    3 | 7 F A X 9 B D Y O A
    4 | S D 2 2 Q V J 5 4 T

Enter the field positions to get the cell items like:

    > E3 I0 C4

and you will get the answer:

    9 Z 2

Case is ignored and white space is not necessary, so you can type like
this as well:

    > e3i0c4

# INTERFACE

- **config**

    Module parameters can be configured using the **config** interface from
    [Getopt::EX::Config](https://metacpan.org/pod/Getopt%3A%3AEX%3A%3AConfig).  There are three ways to configure parameters:

    - Module configuration syntax

        Use the **::config=** syntax directly with the module:

            greple -Mpw::config=clear_screen=0

    - Command-line config option

        Use the **--config** option to set parameters:

            greple -Mpw --config clear_screen=0 --

        Multiple parameters can be set:

            greple -Mpw --config clear_screen=0 --config debug=1 --

    - Direct command-line options

        Many parameters have direct command-line equivalents:

            greple -Mpw --no-clear-screen --debug --browser=safari --

    Currently following configuration options are available:

        clear_clipboard
        clear_string
        clear_screen
        clear_buffer
        goto_home
        browser