• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..03-May-2022-

cmake_support/H26-Jul-2019-6556

.gitignoreH A D26-Jul-2019152 1713

COPYINGH A D26-Jul-201934.3 KiB675553

README.mdH A D26-Jul-20193 KiB10975

audio_random.cppH A D26-Jul-20192.2 KiB9560

audio_random.hH A D26-Jul-20191.6 KiB6534

audio_random_alsa.cppH A D26-Jul-20193.6 KiB12083

audio_random_alsa.hH A D26-Jul-20191.3 KiB4218

audio_random_oss.cppH A D26-Jul-20191.8 KiB6943

audio_random_oss.hH A D26-Jul-20191.2 KiB3916

audio_random_portaudio.cppH A D26-Jul-20192 KiB7745

audio_random_portaudio.hH A D26-Jul-20191.3 KiB4218

config.h.cmakeH A D26-Jul-2019822 3523

diceware8k.cH A D26-Jul-201965.2 KiB8,2038,197

main.cppH A D26-Jul-20193.3 KiB12086

main_qt.cppH A D26-Jul-2019186 129

mainwindow.cppH A D26-Jul-20193.4 KiB12182

mainwindow.hH A D26-Jul-20191.2 KiB5425

mainwindow.uiH A D26-Jul-201913.4 KiB502501

md5.cH A D26-Jul-201915 KiB463292

md5.hH A D26-Jul-20194.1 KiB12757

spass_utils.cppH A D26-Jul-20192.9 KiB11371

spass_utils.hH A D26-Jul-20191.4 KiB4619

README.md

1Readme - spass
2==============
3
4Secure password/passphrase generator.
5
6![image]
7
8Authors
9-------
10
11-   Author: [Guy Rutenberg]
12-   Word list by [Arnold G. Reinhold]
13
14Usage
15-----
16
17By default spass will generate passwords. You can control the length
18using the `-l` modifier. Examples:
19
20    $ spass
21    mqGP0GEZ
22    $ ./spass -l 10
23    @-9Me6VNnT
24
25If you pass the `-p` modifier, spass will output a passphrase instead of
26a password:
27
28    $ ./spass -p -l 4
29    pecan suey faith signor
30
31For more options see `spass --help`.
32
33Installation
34------------
35
36### Dependencies
37
38 -   CMake-2.8
39 -   PortAudio
40 -   libasound2-dev
41 -   libboost-program-options-dev
42 -   qtbase5-dev
43
44### Linux
45
46Just run:
47
48    mkdir build
49    cd build
50    cmake ..
51    make
52    sudo make install
53
54Or use one of the provided binary packages.
55
56### Windows
57
58Compiling Boost and PortAudio from source is easy. PortAudio uses CMake
59(just generate and compile), and compiling boost is a matter of:
60`bootstrap` and `.\b2`.
61
62If you use Visual Studio Express 2012, you may need to set the
63`Boost_COMPILER` variable in CMake to `-vc110`, else it won\'t be
64detected properly.
65
66In order to select the right Qt installation, set `QT_QMAKE_EXECUTABLE`
67to point to the correct path to `qmake.exe`. CMake will use it to infer
68the rest of the paths.
69
70Due to a bug in CMake (actually a regression) setting the SubSystem
71doesn\'t work as it should. It should be set manually in the Project
72Properties-\>Linker-\>System to \"Windows\" (at least for release).
73
74### Configuration
75
76`cmake` can receive the following options:
77
78    WITH_PORTAUDIO          use PortAudio as the audio backend instead of ALSA
79                            [default=OFF]
80    WITH_OSS                use Open Sound System (OSS) as the audio backend
81                            instead of ALSA [default=OFF]
82    WITH_ALSA               use Advanced Linux Sound Architecture (ALSA) as the
83                            audio backend [default=ON]
84    WITH_GUI                Build the graphical frontend [default=ON]
85
86The options are exclusive, e.g. only one of them can be used each time.
87If no option is provided, the ALSA is used.
88
89Security
90--------
91
92The security of a password generator like spass, is determined by the
93quality of its underlying random number generator. spass employs a true
94random number generator based on noise obtained via the microphone. The
95noise goes through an unbiasing phase and then every 512 bits are
96compressed into 128 bits using a hash function. After those two phases
97the output bits should have full entropy.
98
99See also [Audio Based True Random Number Generator POC].
100
101The words for the passphrases are taken from a list containing 8192 w
102
103  [image]: https://user-images.githubusercontent.com/1255135/61715209-473d1b80-ad65-11e9-9db4-3cb880346c5b.png
104  [Guy Rutenberg]: http://www.guyrutenberg.com
105  [Arnold G. Reinhold]: http://world.std.com/~reinhold/index.html
106  [Audio Based True Random Number Generator POC]: http://www.guyrutenberg.com/2010/05/14/audio-based-true-random-number-generator-poc/
107
108
109