/ 
App-Greple-pw-1.02
/ 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. 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
timeout
debug
parse_matrix
parse_id
parse_pw
id_keys
id_chars
id_color
id_label_color
pw_keys
pw_chars
pw_color
pw_label_color
pw_blackout

Parameter Details

Option naming

Configuration parameters use underscores (clear_screen, id_keys), while command-line options use hyphens (--clear-screen, --id-keys).

Boolean parameters

Parameters like clear_screen, debug can be set to 0/1. Command-line options support negation with --no- prefix (e.g., --no-clear-screen).

List parameters

id_keys and pw_keys are lists of keywords separated by spaces:

--config id_keys="USER ACCOUNT LOGIN EMAIL"
--config pw_keys="PASS PASSWORD PIN SECRET"
Password display control

pw_blackout controls password display: 0=show passwords, 1=mask with 'x', >1=fixed length mask.

PwBlock integration

Parameters parse_matrix, parse_id, parse_pw, id_*, and pw_* are passed to the PwBlock module for pattern recognition and display control.

pw_status

Print current configuration status. Next command displays current settings:

greple -Mpw::pw_status= dummy /dev/null

This shows which parameters are set to non-default values and which are using defaults.

BROWSER INTEGRATION

The pw module includes browser integration features for automated input. Browser options are available:

--browser=name

Set the browser for automation (chrome, safari, etc.):

greple -Mpw --browser=chrome
--chrome, --safari

Shortcut options for specific browsers:

greple -Mpw --chrome     # equivalent to --browser=chrome
greple -Mpw --safari     # equivalent to --browser=safari

During interactive mode, you can use the input command to send data to browser forms automatically.

EXAMPLES

Search for passwords in encrypted files
greple -Mpw password ~/secure/*.gpg
Use with specific browser and no screen clearing
greple -Mpw --chrome --no-clear-screen password data.txt
Configure custom keywords and timeout
greple -Mpw --config id_keys="LOGIN EMAIL USER" --config timeout=600 password file.txt
Check current configuration
greple -Mpw::pw_status= dummy /dev/null

SEE ALSO

App::Greple, App::Greple::pw

https://github.com/kaz-utashiro/greple-pw

AUTHOR

Kazumasa Utashiro

LICENSE

Copyright (C) 2017-2025 Kazumasa Utashiro.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.