Home

Welcome to the Easy Password wiki!

Easy Password implements a password generation scheme inspired by http://xkcd.com/936/. For further discussions about the comic, please refer to the xkcd forum here: http://forums.xkcd.com/viewtopic.php?f=7&t=73384. This wiki is dedicated to using Easy Password. Except for the funny stuff.

1. Installation

Compiled distributions can be downloaded by clicking the "Source" link in the header, and then the "Downloads" button which is on the right side of the page.

1. 1. Windows Installation

To install on windows, download and run the windows installer. This will install in C:\Programs, and add a shortcut with an uninstall link to your Start menu.

1. 1. Mac Installation

To install on a mac, download the Mac distribution. This is a zip file containing a folder named "EasyPassword". Drag this entire folder to the applications folder.

1. 1. Other GUI Installation

On other platforms, download the executable jar with the name that starts with "xkcd936swing". Depending upon the platform, you can run it either by double clicking it, or typing "java -jar xkcd936swing*.jar" at the command line.

1. 1. Command line installation

To run at the command line, download the executable jar with name begging in "xkcd936cli". This can be run as "java -jar xkcd936cli*.jar <text></text>"

1. Running
   1. Files

Graphical versions of EasyPassword scan a directory named "dict" on startup. Add plain text files to this directory to increase the number of words that EasyPassword will choose from. Within the app there are buttons to download the King James version of the bible and War and Peace from Gutenberg to help you get started. You can click "Scan" to rescan the dict folder, use the checkboxes to select which books will be chosen from.

1. 1. Choice of input files

I find it helpful to use several books that I've read that are available from Gutenberg (all the more reason to read the classics!). It may be an ever better idea to use four random names, see http://forums.xkcd.com/viewtopic.php?f=7&t=73384&p=2740553#p2740553

1. 1. Options

There are also options

• Lowercase all words - lowercase words before adding to the dictionary. This will slightly lower the strength of your password.
• Space between words - add spaces between words. This makes it easier to see the word boundaries.
• Number of words in password. The more words the string the password.

Click the "Make new password" button will generate new passwords and calculate stats which describe the strength of the password. Alphanum string means a random string of mixed-case letters and numbers. Random string is a string draw from letters, numbers, and the symbols "!@#$%^&*()//~`-=+_.

1. Support

Please submit bug reports and feature requests as "Issues" using the issues tab. This being github, you may also fork and fix bugs and implement features. Please submit a pull request when you think your code is ready to be merged back in.

1. License

Easy Password is distributed under the MIT License, http://www.opensource.org/licenses/MIT

Copyright (c) <2011>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.