Metadata-Version: 2.4
Name: passme
Version: 1.2.5
Summary: Password management with command line
Author: Katsutoshi Seki
License: MIT
Project-URL: Homepage, https://sekika.github.io/passme/
Project-URL: Source, https://github.com/sekika/passme
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Security
Classifier: Topic :: Security :: Cryptography
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Operating System :: OS Independent
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Natural Language :: English
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: ConfigObj
Requires-Dist: clipboard
Requires-Dist: setuptools
Dynamic: license-file

# Passme: Password generation for desktop and mobile

**Passme** generates strong, unique passwords for many sites without storing the passwords themselves. It is available as a Python command-line tool, a Flutter-based iOS app, and a JavaScript version for web browsers.

[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/sekika/passme/blob/master/README.md)
[![ja](https://img.shields.io/badge/lang-ja-blue.svg)](https://github.com/sekika/passme/blob/master/README-ja.md)

<img alt="Passme illustration" src="https://sekika.github.io/passme/passme.svg" style="width: min(100%, 600px);  height: auto; margin:auto; display: block" />

Instead of an encrypted vault, Passme generates passwords deterministically every time using a site-specific seed (**sitekey**) stored in a configuration file and a **master password** that only you know.

> **Sitekey + Master password = Password**

**[Read the Full Documentation](https://sekika.github.io/passme/)**

## Key Features

*   **Stateless:** Passwords are calculated on the fly. If you have your sitekey file and your master password, you can generate your passwords anywhere.
*   **Secure:** Offline brute-force attacks are difficult because the attacker cannot verify a guessed password without trying it on the actual login page (unless they already know one of your passwords).
*   **Flexible:** You can customize the length, character set (alphanumeric, symbols, etc.), and hashing algorithm for each site.
*   **Portable:** Generate passwords on your phone with the [iOS app](https://apps.apple.com/us/app/password-passme/id6830239169) or a generated [HTML/JavaScript file](https://sekika.github.io/passme/javascript/), without installing Python on the phone.
*   **No Vendor Lock-in:** Uses standard, open algorithms. Even if this software is discontinued, you can recover your passwords using the known calculation logic.

## Available Versions

* **Python / CLI:** Manage sitekeys and generate passwords on your computer. See the installation and quick start below.
* **iOS app:** Install from the [App Store](https://apps.apple.com/us/app/password-passme/id6830239169) and import your sitekey file. See the [mobile guide](https://sekika.github.io/passme/mobile/).
* **JavaScript:** Generate an HTML file with `passme html` and use it in a browser, including on mobile devices. See the [JavaScript guide](https://sekika.github.io/passme/javascript/).

## Installation (Python / CLI)

The command-line version requires Python 3.

```bash
pip install passme
```

## Quick Start (Python / CLI)

### 1. Initialization
Run `passme` to set up your sitekey file location.

```bash
> passme
Filename to save site keys: /path/to/your/sitekeys.txt
```

### 2. Add a Site
Create a new entry for a service (e.g., Google). You can define the character set and length.

```bash
> passme add
Site name: google
Character (an): 
Password length (14): 
...
```

### 3. Generate a Password
To retrieve the password, simply type `passme` followed by the site name.

```bash
> passme google
Master password: [Input your master password]
(Generated password is copied to clipboard)
```

## Security Warning

*   **Do not forget your master password.**
*   **Do not lose your sitekey file.**

Since Passme does not store your passwords, there is no "Forgot Password" recovery mechanism. Losing either your master password or the sitekey file means losing access to all your generated accounts. It is highly recommended to manage your sitekey file in a **private** git repository.

## Documentation

For detailed usage, configuration options, mobile usage (iOS app and JavaScript version), and security details, please refer to the documentation:

[**https://sekika.github.io/passme/**](https://sekika.github.io/passme/)

## History

Since its [public release](https://sekika.github.io/2025/12/25/passme/) in 2017, the author has migrated from existing password management systems to Passme and has been using it securely through 2026. Currently, over 100 site passwords are managed using this tool.

## License

This software is released under the [MIT License](LICENSE.txt).

Author: [Katsutoshi Seki](https://github.com/sekika)
