📚 Passpraise Documentation

What is Passpraise?

Passpraise is a unique passphrase generator that creates memorable, secure passwords by combining information about notable people from history. Instead of random character strings that are impossible to remember, Passpraise generates passphrases like:

How It Works

Passpraise uses a sophisticated algorithm to generate passphrases from a database of notable people. Here's the process:

1. Person Selection

The system randomly selects a person from the database based on your filters (continent, country, field, century, awards).

2. Element Pool Creation

From the selected person, various elements are extracted:

• Name: First name, last name, or full name
• Birth Year: The year they were born
• Awards: Notable awards they received
• Title/Occupation: Their profession or role
• Country: Their country of origin
• Field: Their area of work (Science, Arts, etc.)
• Initials: First letters of their names

3. Element Selection

Based on your settings (number of parts, which elements to include), the algorithm selects the most appropriate elements.

4. Processing & Assembly

Selected elements are:

• Processed (capitalized, cleaned, formatted)
• Shuffled for randomness
• Joined with separators (if enabled)
• Enhanced with complexity requirements (uppercase, numbers, special chars)

5. Validation

The generated passphrase is validated against your complexity rules. If it doesn't meet requirements, the system either regenerates or injects missing elements.

Privacy & Security

Features

Complexity Rules

Customize your passphrases with granular complexity requirements:

• Uppercase: Require at least one uppercase letter (A-Z)
• Lowercase: Require at least one lowercase letter (a-z)
• Number: Require at least one number (0-9)
• Special Characters: Require at least 2 special characters
• Separator: Include separators between words

Filters

Filter the person database by:

• Continent: Africa, Asia, Europe, North America, South America, Oceania
• Country: Specific countries
• Field: Science, Literature, Politics, Arts, Technology, etc.
• Century: 1700s, 1800s, 1900s, 2000s
• Awards: Only people with notable awards

Element Selection

Choose which elements to include in your passphrases:

• First Name
• Last Name
• Birth Year
• Awards
• Title/Occupation
• Country
• Field
• Initials

Customization

• Parts: Choose 2-5 parts for your passphrase
• Length: Set minimum character length per part (3-50)
• Exclude Characters: Specify characters to avoid (useful for systems with restrictions)

Additional Features

• X-Ray Mode: Visualize character types in your passphrase
• Copy to Clipboard: One-click copying
• Educational Info: Learn about the person behind each passphrase
• Wikipedia Links: Direct links to learn more
• Theme Support: Auto, Light, Dark, and High Contrast modes
• Accessibility: Full keyboard navigation and screen reader support
• Hashing Tools: Built-in generator for bcrypt, Argon2, and scrypt hashes

Hashing Tools

Passpraise includes a dedicated tool for developers and security professionals to generate secure password hashes directly in the browser.

Supported Algorithms

• bcrypt: The industry standard for password hashing. Configurable cost factors (10-14).
• Argon2id: The winner of the Password Hashing Competition. Memory-hard and GPU-resistant. Configurable memory cost.
• scrypt: A memory-hard key derivation function. Configurable N parameter.

Features

• Real-time Generation: Hashes update automatically as you type (with debouncing).
• Zero-Knowledge: Uses WebAssembly and JS libraries locally.
• Copy Tools: One-click copying for both the passphrase and individual hashes.
• Dev-Friendly: Perfect for generating test data or development seeds.

→ Open Hashing Tools

Usage Guide

Basic Usage

1. Visit passpraise.com
2. Click the Generate button to create passphrases
3. Click on any passphrase to copy it to your clipboard
4. Click the info icon (ℹ️) to learn about the person

Customizing Your Passphrases

1. Click Controls to open the settings panel
2. Adjust complexity rules at the top (Uppercase, Lowercase, Number, Special chars, Separator)
3. Use filters to narrow down the person database
4. Adjust sliders for parts count and minimum length
5. Click Include elements to choose which information to use
6. Click Generate to create new passphrases with your settings

Using the Exclude Field

Some systems don't allow certain characters. Use the Exclude field to avoid them:

Suggesting New People

1. Click Suggest a Person
2. Enter a Wikipedia link for a notable person
3. Submit your suggestion
4. Our team will review and potentially add them to the database

Understanding Complexity Rules

Complexity rules ensure your passphrases meet specific security requirements. Here's how they work:

Uppercase (A-Z)

When enabled, ensures at least one uppercase letter is present. Names are typically capitalized by default.

Lowercase (a-z)

When enabled, ensures at least one lowercase letter is present. Most word elements are lowercase.

Number (0-9)

When enabled, ensures at least one number is present. Birth years provide numbers naturally.

Special Characters

When enabled, ensures at least 2 special characters are present. Separators count as special characters.

Separator

When enabled, adds random separators between passphrase parts. Separators are randomly chosen from a large set.

Filters & Options Explained

Geographic Filters

Continent: Narrows down to people from specific continents. Useful for regional diversity.

Country: Further narrows to specific countries. Great for national heroes or specific cultural contexts.

Field Filter

Filter by area of work:

• Science: Scientists, researchers, inventors
• Literature: Authors, poets, playwrights
• Politics: Leaders, activists, diplomats
• Arts: Artists, musicians, performers
• Technology: Engineers, computer scientists, innovators
• And many more...

Century Filter

Filter by birth century:

• 1700s: Historical figures from the 18th century
• 1800s: 19th century pioneers
• 1900s: 20th century icons (largest group)
• 2000s: Contemporary figures

Awards Filter

When enabled, only shows people with notable awards (Nobel Prize, Oscar, Hugo Award, etc.). Great for generating passphrases based on highly accomplished individuals.

Element Selection

Control which information elements can be used:

• First Name: Use person's first name
• Last Name: Use person's last name
• Birth Year: Include birth year (adds numbers)
• Awards: Use award names (Nobel, Oscar, etc.)
• Title/Occupation: Use their profession
• Country: Use country name
• Field: Use field of work
• Initials: Use name initials

Best Practices

Creating Strong Passphrases

• Use at least 3-4 parts for better security
• Enable multiple complexity rules (uppercase, lowercase, numbers, special chars)
• Use separators to increase character variety
• Aim for 20+ characters total length
• Don't disable too many element types - more variety = stronger passphrases

Making Passphrases Memorable

• Use filters to select people you're interested in or familiar with
• Read the educational information to create a mental story
• Choose people from your field of interest (science, arts, etc.)
• Use the Wikipedia link to learn more about the person

Password Management

• Never reuse passphrases across different services
• Use a password manager to store your passphrases securely
• Generate a unique passphrase for each account
• Consider using Passpraise to create a master passphrase for your password manager
• Regularly update critical passphrases (email, banking, etc.)

System Compatibility

• Check if your system has character restrictions
• Use the Exclude field to avoid problematic characters
• Some systems have maximum length limits - adjust parts and length accordingly
• Test your passphrase in a non-critical context first

Frequently Asked Questions

Is Passpraise really secure?

Yes! All generation happens in your browser - we never see or store your passphrases. The randomness comes from your browser's cryptographic random number generator, which is secure. However, the strength of your passphrase depends on your settings (length, complexity, etc.).

How many possible passphrases can be generated?

With over 1,000 people in the database and multiple elements per person, combined with random selection, shuffling, and separators, the number of possible passphrases is in the trillions. The exact number depends on your filter and element settings.

Can I use Passpraise offline?

Once you've loaded the page, the generator works offline. However, you need an initial internet connection to load the database and code.

Why focus on notable people?

Memorable passphrases are easier to remember than random strings. By basing them on real people and their achievements, you create mental associations that aid memory. Plus, you might learn something new!

How do I suggest adding someone?

Click "Suggest a Person" on the main page and submit a Wikipedia link. We review all suggestions and add notable figures who meet our criteria.

What makes a passphrase "strong"?

A strong passphrase has:

• Sufficient length (20+ characters)
• Multiple character types (uppercase, lowercase, numbers, special chars)
• Randomness (unpredictable combinations)
• Uniqueness (not reused across services)

Can I use the API for commercial purposes?

Yes! Our API is free and open for both personal and commercial use. Just respect the rate limits (100 requests/hour). See the API documentation for details.

Is the database biased toward certain groups?

We strive for diversity across continents, countries, fields, and time periods. However, historical records naturally reflect historical biases. We actively work to include underrepresented groups and welcome suggestions.

How often is the database updated?

We regularly review and add new notable figures based on user suggestions and our own research. The database grows continuously.

What browsers are supported?

Passpraise works on all modern browsers (Chrome, Firefox, Safari, Edge) on desktop and mobile. We recommend keeping your browser updated for the best experience and security.