Skip to content

alejaranda/spg

Repository files navigation

spg — Simple Password Generator 🦀

CI Release License: MIT Rust

A fast, minimal CLI tool to generate secure passwords — built in Rust.

Features

  • 🔐 Cryptographically random password generation
  • 🔣 Optional special characters
  • 📋 Automatically copies the password to your clipboard
  • ⚙️ Configurable length

Installation

Download binary (recommended)

Go to Releases and download the binary for your platform:

Platform File
Linux x86_64 spg-vX.X.X-x86_64-unknown-linux-gnu.tar.gz
Linux ARM64 spg-vX.X.X-aarch64-unknown-linux-gnu.tar.gz
macOS Intel spg-vX.X.X-x86_64-apple-darwin.tar.gz
macOS Apple Silicon spg-vX.X.X-aarch64-apple-darwin.tar.gz
Windows x86_64 spg-vX.X.X-x86_64-pc-windows-msvc.zip

Then extract and move the binary to your PATH:

# Linux / macOS
tar -xzf spg-*.tar.gz
sudo mv spg /usr/local/bin/

From source

git clone https://github.com/alejaranda/spg
cd spg
cargo install --path .

Usage

spg [OPTIONS]

Options:
  -l, --length <LENGTH>   Length of the generated password [default: 12]
  -s, --symbols           Include special symbols [default: true]
  -h, --help              Print help
  -V, --version           Print version

Examples

# Generate a 12-character password with symbols (default)
spg

# Generate a 24-character password
spg --length 24

# Generate a password without special characters
spg --no-symbols

# Combine options
spg -l 32 --no-symbols

The generated password is printed to stdout and automatically copied to your clipboard.

Development

cargo build       # build
cargo test        # run tests
cargo clippy      # lint
cargo fmt         # format

License

This project is released under the MIT License.

About

🦀 Simple password generator written in Rust.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors

Languages