New releases will be announced at my main site (see http://outlyer.net/etiq/projects/relevation/), this page and the freshmeat page.
Relevation is a tool to retrieve passwords stored in a password file in the format used by Revelation, from the command-line instead of through a GUI.
Only retrieval is implemented, Revelation must be used to actually edit the file.
An optional configuration file ~/.relevation.conf can be used to save the typing of filename and/or password on each run.
It follows an INI-style format:
[relevation] file=~/mypasses password=my pass
Both fields are optional. The [revelation] header is required.
Comment lines can be added by preceding them with a semicolon (';') or hash ('#').
Inline comments can be added by preceding the comment with whitespace and a semicolon (' ;').
There's currently no actual documentation but the manual page is available online and a list of usage examples is provided below.
Here's a few examples of each of the modes of operation.
These examples assume the existence of a configuration file, otherwise the command-line will require filename and password, e.g. $ relevation -f ~/mypasswords.revelation -p mypassword.
All passwords here were generated randomly, no need to try them anywhere :P.
Relevation v1.0, (c) 2011 Toni Corvera
-------------------------------------------------------------------------------
-> Search all: 201 matches
Type: website
Name: Example 1
Description:
Url: http://www.example.com/
Username: ex1
Password: zoh3haeH
.
. [entries abridged in this example]
.
Type: website
Name: Example 2
Description: Example site 2, secured
Url: https://2.example.com
Username: ex2
Password: Bootie9p
-------------------------------------------------------------------------------
<- (end of 201 results for {all})
$ relevation twitter
Relevation v1.0, (c) 2011 Toni Corvera
-> Search "twitter" ('not folder' entries): 1 matches
-------------------------------------------------------------------------------
Type: website
Name: Twitter
Description:
Url: http://twitter.com/
Username: meeeeee@example.com
Password: ag9thaeP
-------------------------------------------------------------------------------
<- (end of 1 result for {"twitter" ('not folder' entries)})
$ relevation -t email google.com
Relevation v1.0, (c) 2011 Toni Corvera
-> Search "google.com" ('email' entries): 1 matches
-------------------------------------------------------------------------------
Type: email
Name: Main email address
Description:
Email: outlyer@gmail.com
Hostname: mail.google.com
Username: guesswhat
Password: edeeKo7m
-------------------------------------------------------------------------------
<- (end of 1 result for {"google.com" ('email' entries)})
$ relevation -t email
Relevation v0.3, (c) 2011 Toni Corvera
-> Search email entries: 2 matches
-------------------------------------------------------------------------------
Type: email
Name: Main email address
Description:
Email: outlyer@gmail.com
Hostname: mail.google.com
Username: guesswhat
Password: edeeKo7m
-------------------------------------------------------------------------------
Type: email
Name: Example backup email
Description: Just in case
Email: backup@example.com
Hostname:
Username: backup$example
Password: quoo3Yez
-------------------------------------------------------------------------------
<- (end of 2 results for {email entries})
$ relevation -x Relevation v1.0, (c) 2011 Toni Corvera <?xml version="1.0" encoding="utf-8" ?> <revelationdata version="0.4.11" dataversion="1"> . . . <entry type="website"> <name>some site</name> <description>this is some site</description> <updated>1255603263</updated> <field id="generic-url">http://www.example.com</field> <field id="generic-username">myuser</field> <field id="generic-password">JaTei7ye</field> </entry> . . [entries abridged in this example] . <entry type="email"> <name>my address</name> <description>main address</description> <updated>1247495779</updated> <field id="generic-email">me@example.com</field> <field id="generic-hostname">example.com</field> <field id="generic-username">meee</field> <field id="generic-password">Zuuth3Ai</field> </entry> . . . </revelationdata>
There's a bug tracker located at b.outlyer.net.
To report a bug use the bug tracker or drop me an e-mail.
First public release.