.\" Generated by scdoc 1.11.2
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "progpick" "1" "2022-06-17"
.P
.SH NAME
.P
progpick - Bruteforce with a stream of permutations of a specific pattern
.P
.SH SYNOPSIS
.P
\fBprogpick\fR [-vqc] [-e \fIcmd\fR] \fIPATTERN\fR
.P
.SH DESCRIPTION
.P
\fBprogpick\fR is a program to generate permutations of an explicitly provided
pattern.\& It'\&s useful if you forgot some details about a passphrase but you
still remember most of it.\&
.P
.SH OPTIONS
.P
\fB-v\fR, \fB--verbose\fR
.RS 4
Verbose logs (can be used multiple times, maximum: 4)
.P
.RE
\fB-q\fR, \fB--quiet\fR
.RS 4
Do not print progress bar
.P
.RE
\fB-c\fR, \fB--count\fR
.RS 4
Count total number of permutations instead of printing them
.P
.RE
\fB-e\fR \fIcmd\fR, \fB--exec\fR \fIcmd\fR
.RS 4
Send permutations to stdin of a subprocess.\& \fIcmd\fR is parsed into a list of
arguments and then executed directly instead of going through /bin/sh, so
shell quoting works, but other shell features don'\&t.\&
.P
.RE
\fB-h\fR, \fB--help\fR
.RS 4
Prints help information.\&
.P
.RE
.SH EXAMPLES
.P
Generate all combinations from a-z with a length of 5
.P
.RS 4
\fBprogpick '\&{a.\&.\&z}{a.\&.\&z}{a.\&.\&z}{a.\&.\&z}{a.\&.\&z}'\&\fR
.P
.RE
With progress bar
.P
.RS 4
\fBprogpick '\&{a.\&.\&z}{a.\&.\&z}{a.\&.\&z}{a.\&.\&z}{a.\&.\&z}'\& > /dev/null\fR
.P
.RE
Without progress bar
.P
.RS 4
\fBprogpick -q '\&{a.\&.\&z}{a.\&.\&z}{a.\&.\&z}{a.\&.\&z}{a.\&.\&z}'\& > /dev/null\fR
.P
.RE
To make a character optional
.P
.RS 4
\fBprogpick '\&{a.\&.\&z}{{a.\&.\&z},}'\&\fR
.P
.RE
From a-z and 0-9
.P
.RS 4
\fBprogpick '\&{{a.\&.\&z},{0.\&.\&9}}'\&\fR
.P
.RE
Run a script for each result
.P
.RS 4
\fBprogpick '\&a{b,c{d,e{f,g}}}'\& | while read -r x; do\fR
.RS 4
\fB.\&/script "$x"\fR
.RE
\fBdone\fR
.P
.RE
Send the result to stdin of a script
.P
.RS 4
\fBprogpick -e '\&.\&/script.\&sh'\& '\&a{b,c{d,e{f,g}}}'\&\fR
.P
.RE
Attempt to open a luks partition
.P
.RS 4
\fBsudo progpick -e '\&cryptsetup open --test-passphrase /dev/sdc1'\& '\&a{b,c{d,e{f,g}}}'\&\fR
.P
.RE
.SH AUTHORS
.P
This program was originally written and is currently maintained by kpcyrd.\&
Bug reports and patches are welcome on github:
.P
.RS 4
\fIhttps://github.\&com/kpcyrd/progpick\fR