motus logo

Dead simple password generator

release AGPL License Build status

Motus is a command-line application written in Rust that makes generating secure passwords a breeze.

Inspired by the user experience of the 1Password password generator, motus focuses on providing a simple and elegant user interface with sane defaults and comprehensive options. By default, motus copies the generated password to your clipboard, making it even more convenient to use.

```zsh

motus memorable fossil abreast overplant commute dish

motus random UDrZrJJTYElWeOFHZmfp

motus pin 1234421 ```

Features

Installation

on macOS

Using Homebrew:

bash brew tap oleiade/tap brew install motus

on Debian/Ubuntu Linux

Add the repository and install motus:

```bash

Download and install the repository's GPG key

curl -fsSL https://oleiade.github.io/deb/oleiade-archive-keyring.gpg | \ gpg --dearmor \ sudo tee /usr/share/keyrings/oleiade-archive-keyring.gpg > /dev/null

Add the repository to your system's sources

echo "deb [signed-by=/usr/share/keyrings/oleiade-archive-keyring.gpg] https://oleiade.github.io/deb stable main" \ sudo tee /etc/apt/sources.list.d/oleiade.list > /dev/null

Update your sources

apt update

Install motus

apt install motus ```

using Cargo

Alternatively, you can install using Cargo:

bash cargo install motus

Usage

```bash

motus --help Motus is a command-line tool for generating secure, random, and memorable passwords as well as PIN codes.

Usage: motus [OPTIONS]

Commands: memorable Generate a human-friendly memorable password random Generate a random password with specified complexity pin Generate a random numeric PIN code help Print this message or the help of the given subcommand(s)

Options: --no-clipboard Disable automatic copying of generated password to clipboard

  --seed <SEED>
      Seed value for deterministic password generation (for testing purposes)

-h, --help Print help (see a summary with '-h')

-V, --version Print version ```

Generate a memorable password

```bash

motus memorable fossil abreast overplant commute dish

Or customize the password generation

motus memorable --words 7 --separator numbers-and-symbols --capitalize Goes$Stood3Paving(Tipoff$Settle*Flip3Scone ```

Generate a random password

```bash

motus random UDrZrJJTYElWeOFHZmfp

Or customize the password generation

motus random --characters 42 --numbers --symbols 6HdwMjKQPYE3scIBlCps&1Ir5R8lQ85eIVtF!fpUSD ```

Generate a PIN

```bash

motus pin 1234421

Or customize the size of the PIN

motus pin --numbers 9 347751411 ```

Contributing

We welcome contributions to the project. Feel free to submit issues, suggest new features, or create pull requests to help improve motus.

License

motus is distributed under the AGPL-3.0 license.

Why the name?

motus used to be a tv game that I would call the ancestor of Wordle. Players had to guess words of a given size, and would pick up balls from a cup to decide how each round would move along. They would make that very distinct move to scramble the balls around every time, with a very distinct sound. When starting this project, I thought of the process of generating passwords as this comforting and satisfying act of diving into a huge cup full of numbered balls, and the childish feeling of it. This project is named in memory of Motus.