Karl V. P. B.
kOJo8gNx 4u
pS $n} Nd mZ-
Mjgjt Z/wP&
g0KUoG
+33 A BB BB BB BB
local-part@domain

                                            `a Paris, le 2 juillet 2026

                         K a r l   V .   P .   B . ' s
                       ,-----, ,-----,         ,-----,
                      / /'/ / / /_/ / ,-,-,-, / /''-'
                     / / | | / ,---' / / / / / /_/'/
                    '-'  '-''-'     '-----' '-----'
                   random password generator  1.67

                           instructions manual

    RPwG is a French-American cross-layout--'QWAZERTY'--random password
generator. This program is written in Python 3. It randomly generates
passwords of length and cross-layout portability at the user's
discretion. NB: though cross-layout passwords are cool and thus will
make you get laid with bimbos, cross-layout portability reduces the set
of available characters, and the more different layouts are set, the
more the character set is restricted, so the adverse effect on security
should be compensated for by a higher password length.
    The files in this ZIP constitute the official release of RPwG.
They are not documented currently. RPwG is made self-explanatory. A few
points should be noted, particularly by a novice user.

          rpwg.py
                  --length=${n}   (-l ${n})
                  --mode="${s}"   (-m ${s})
                  --layout="${s}" (-k ${s})
                  --interactive   (-i)
                  --random        (-r)
                  --help          (-h)

          --length=${n}, -l ${n}
            Set the length of the password. l is an integer number. If
            the user does not set the mode along, the program randomly
            sets it.

          --mode="${s}", -m ${s}
            Set the portability of the password. s is a string of
            characters: 'q'--"QWAZERTY"--and 'c'--'cross',
            'cross-layout'--for cross-layout compatibility or anything
            else for none. If the user does not set the length along,
            the program randomly sets it.

          --layout="${s}", -k ${s}
            Set a layout. The user must set it at least twice with
            different layouts. s is a string of characters, e.g. "us"
            for ANSI QWERTY or "apfr" for Apple AZERTY. Refer to the
            table below for the aliases of all keyboard layouts. If the
            user does not set two different layouts, the program
            historically defaults to ANSI QWERTY (United States
            English) and Apple French.

                     | alias      |        layout |
                     |------------|---------------|
                     | us, apus   |   ANSI QWERTY |
                     | uk, gb     |    ISO QWERTY |
                     | apuk, apgb | Apple British |
                     | fr         |    ISO AZERTY |
                     | apfr       |  Apple French |
                     | de         |    ISO QWERTZ |
                     | apde       |  Apple German |

          --random, -r
            Randomize both the length and portability of the password.
            This option overrides --interactive.

          --interactive, -i
            Fire up the good ol' interactive prompt. This option
            overrides other options, is overridden by --help.

          --help, -h
            Tell the user how to use RPwG. This option overrides all
            others.

          An online version 2 for freedom from Ruby was planned to
sport a graphical user interface, was to be written in JavaScript,
HTML5 and CSS3, would mimic a command-line interface on a Twiggy Mac.
The user would have had to only enter the length of the password and
set none to any amount of layouts. Although that version was 100%
graphically designed, it has been canceled until further notice.
    Since RPwG first was designed to make passwords without characters
of variable positions between the ANSI QWERTY and the ISO AZERTY
layouts, running the script without any option defaults to
French-American random password generation, whereas specifying two or
more keyboard layouts will incrementally refine the resulting password.
As RPwG 2.0 will emphasize security, the user will be alerted of the
lower security, as the level of layout divergence increases, and the
program will display various stats.

    Should problems arise with this software, please communicate them
to the author, or open an issue at https://github.com/kvpb/rpwg/issues.

                                             ^J:                       
                            ^   .:^^.      ^?7.                        
                          ^?Y~!!~~7J. ~!:~YY.               ...........
                        ^55?57.  ~Y5~!5?~:J~~~~^.  .:^^^~~~~~~~~~~~~~!!
                       7G?:  !~    ..       .  ~J  ::.... ....::^^^.   
                       .   ...^^^^^^^~~~~~~~!7J??!~~~~~~~~~~^^::.      
                         !?!^^^^:::....:::^~~~^                        
                         ~7~^^^^^^~~~~^^^::.