NAME

pw - Module to get password from file

SYNOPSIS

greple -Mpw pattern file

VERSION

0.01

DESCRIPTION

This module searches id and password information those written in text file, and displays them interactively. Passwords are not shown on display by default, but you can copy them into clipboard by specifying item mark.

PGP encrypted file can be handled by greple standard feature. Command "gpg" is invoked for files with ".gpg" suffix by default. Option --pgp is also available, then you can type passphrase only once for searching from multiple files. Consult --if option if you are using other encryption style.

Terminal scroll buffer and screen is cleared when command exits, and content of clipboard is replaced by prepared string, so that important information does not remain on the terminal.

Id and password is collected from text using some keywords like "user", "account", "password", "pin" and so on. To see actual data, use pw_status function described below.

Some bank use random number matrix as a countermeasure for tapping. If the module successfully guessed the matrix area, it blackout the table and remember 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 position 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

• pw_print

  Data print function. This function is set for --print option of greple by default, and user doesn't have to care about it.

• pw_epilogue

  Epilogue function. This function is set for --end option of greple by default, and user doesn't have to care about it.

• pw_option

  Several parameters can be set by pw_option function. If you do not want to clear screen after command execution, call pw_option like:

    greple -Mpw::pw_option(clear_screen=0)
  

  or:

    greple -Mpw --begin pw_option(clear_screen=0)
  

  with appropriate quotation.

  Currently following options are available:

    clear_clipboard
    clear_string
    clear_screen
    clear_buffer
    goto_home
    browser
    timeout
    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
    debug
  

  Password is not blacked out when pw_blackout is 0. If it is 1, all password characters are replaced by 'x'. If it is greater than 1, password is replaced by sequence of 'x' indicated by that number.

  id_keys and pw_keys are list, and list members are separated by whitespaces. When the value start with '+' mark, it is appended to current list.

• pw_status

  Print option status. Next command displays defaults.

    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.