unding - dark magic, encrypted wallet
version 0.012
This is an executable script, not a library. If you are a first time user, you might want to consult the "SETUP" section in this document first.
Encrypt a file. Content will be stored in unding. Attention: File will remain on disk!
./unding /path/to/file
Or you might want to encrypt output from another program. You can do so, using a dash.
cat secret | perl unding -
Decrypt and display content stored in unding.
./unding
In all cases you must enter a password.
Since this script needs write access on it self (yes!), it's best you copy it to your local directory before using. You can explicitly do this via the --init option:
--init
unding --init
If you want to take this script with you (e.g. on a flash drive) and run it on different machines (e.g. for looking at your encrypted secrets), you might also want to take all module dependencies with you. You can create a copy of this script which includes all needed modules inside itself. You need to install App::FatPacker and then just run something similar to the following (here with redirection of stdout):
stdout
/usr/bin/unding --fatinit > my_packed_unding
You might also want to use the fatpack interface of App::FatPacker manually though.
fatpack
Why «dark magic»? The script uses a technique which making use of, is higly disencouraged by intelligent programmers: Write to the DATA section in Perl
Why the name «unding»? unding derives from the German Un-Ding, meaning the negation of a thing, a Not-Thing (nothing). The negation can be meant pejoratively, relating to the dark magic invoced. But also descriptively, because the script transforms a thing (text) into a nothing (cypher text).
unding
So what's in for me? The dark magic offers you your encrypted secrets together with the code to decrypt it in one single file. All you need to de- and encrypt is this file and a Perl environment. No separation of ciphertext and cryptologic.
This is an early release. Use it at your own risk.
After encryption, the script does not delete the original file. You have to do this yourself. This may be considered a feature, since it might prevent loss of data.
Under Windows your password input is visible! As soon there is a technical solution, of how to hide the password on Windows, it will be implemented. Patches welcome.
Boris Däppen <bdaeppen.perl@gmail.com>
This software is copyright (c) 2018 by Boris Däppen.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install App::Unding, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::Unding
CPAN shell
perl -MCPAN -e shell install App::Unding
For more information on module installation, please visit the detailed CPAN module installation guide.