🛠️ Usage Guide

Learn how to use Flowey like a pro!

📝 Basic Usage

Simple Message

The most basic way to use Flowey:

flowey "Your message here"

Example:

$ flowey "Determination fills your soul!"

Random Quote

Let Flowey surprise you with a random Undertale quote:

flowey

Example Output:

$ flowey
 ___________________________________
| It's a beautiful day outside.      |
| Birds are singing, flowers are     |
| blooming...                        |
|___________________________________|

🎭 Character Selection

Choose a Specific Character

Use the -c or --character flag:

flowey -c CHARACTER_NAME "message"
flowey --character CHARACTER_NAME "message"

Examples:

# Sans being Sans
flowey -c sans "you're gonna have a bad time."

# Papyrus being enthusiastic
flowey -c papyrus "NYEH HEH HEH!"

# Toriel being caring
flowey -c toriel "My child, stay safe out there."

# Asgore being awkward
flowey -c asgore "Howdy!"

Random Character

Let fate decide with the -r or --random flag:

flowey -r "message"
flowey --random "message"

📋 Command Line Options

Short	Long	Description	Example
`-c`	`--character`	Set character	`-c sans`
`-a`	`--assets`	Set assets directory	`-a /path/to/flowies`
`-r`	`--random`	Select random character	`-r`
`-l`	`--list`	List available characters	`-l`
`-q`	`--quiet`	Run quietly (no message box)	`-q`
`-g`	`--generate`	Generate new character file	`-g`
`-v`	`--version`	Show version information	`-v`
`-h`	`--help`	Show help message	`-h`

🔧 Advanced Usage

List Available Characters

See what characters you have installed:

flowey --list

Example Output:

Available characters:
- flowey
- sans
- papyrus
- toriel
- asgore
- frisk

Custom Assets Directory

Specify a custom location for character files:

flowey -a /path/to/custom/flowies "message"

Quiet Mode

Show only the character art without the message box:

flowey -q -c flowey

Reading from STDIN

Pipe text to Flowey:

echo "Hello from the Underground!" | flowey
cat message.txt | flowey -c sans

🎨 Creating Custom Characters

Generate Character from Image

Create new character files from images (requires chafa):

flowey --generate

💡 Tip:

Install chafa first:

# Ubuntu/Debian
sudo apt install chafa

# Arch Linux
sudo pacman -S chafa

# macOS
brew install chafa

The generator will prompt you for:

Image path: Path to your source image
Output file: Name for the .flowey file
Author: Your name (optional)

💡 Pro Tips

🌟 Useful Tricks

Create Aliases

Add to your ~/.bashrc or ~/.zshrc:

alias flowey-sans='flowey -c sans'
alias flowey-papyrus='flowey -c papyrus'
alias flowey-random='flowey -r'

Fortune Integration

Combine with fortune for random quotes:

fortune | flowey -c sans

Daily Quote

Add to your shell startup file:

flowey -r

Git Integration

Use in your commit hooks:

#!/bin/bash
git log -1 --pretty=%s | flowey -c flowey

📚 Examples Gallery

Character Showcase

# Flowey being devious
flowey -c flowey "In this world, it's kill or be killed!"

# Sans with his classic line
flowey -c sans "it's a beautiful day outside..."

# Papyrus being confident
flowey -c papyrus "I, THE GREAT PAPYRUS, WILL CAPTURE A HUMAN!"

# Toriel being motherly
flowey -c toriel "Stay safe, my child."

# Asgore being formal
flowey -c asgore "Human... it was nice to meet you."

# Frisk staying determined
flowey -c frisk "* You are filled with determination."

"You feel like you understand Flowey a little better now."