📦 Installation Guide

Get Flowey up and running on your system

Home Usage Characters

⚙️ System Requirements

  • Perl 5.10 or higher
  • CPAN package manager
  • Terminal with ANSI color support
  • Git (for source installation)

🚀 Installation Methods

Method 1: From Source (Recommended)

This is the recommended method for most users:

# Clone the repository
git clone https://github.com/lazypwny751/flowey.git

# Navigate to the directory
cd flowey

# Install Perl dependencies
cpan install Getopt::Long::Descriptive

# Make executable (if needed)
chmod +x flowey.pl

# Test installation
./flowey.pl "Hello, Underground!"

Method 2: Pre-built Packages

For Debian-based distributions:

Ubuntu/Debian:

# Download the package
wget https://github.com/lazypwny751/flowey/releases/download/v1.0.0/flowey-ubuntu_1.0.0_all.deb

# Install the package
sudo dpkg -i flowey-ubuntu_1.0.0_all.deb

# Fix dependencies if needed
sudo apt-get install -f

Linux Mint:

# Download the package
wget https://github.com/lazypwny751/flowey/releases/download/v1.0.0/flowey-mint_1.0.0_all.deb

# Install the package
sudo dpkg -i flowey-mint_1.0.0_all.deb

# Fix dependencies if needed
sudo apt-get install -f

Method 3: Direct Download

For a quick single-file installation:

# Download the script directly
curl -O https://raw.githubusercontent.com/lazypwny751/flowey/main/flowey.pl

# Download character files
mkdir -p flowies/undertale
cd flowies/undertale
curl -O https://raw.githubusercontent.com/lazypwny751/flowey/main/flowies/undertale/flowey.flowey
curl -O https://raw.githubusercontent.com/lazypwny751/flowey/main/flowies/undertale/sans.flowey
# ... download other character files

# Install dependencies
cpan install Getopt::Long::Descriptive

# Make executable
chmod +x flowey.pl

🔧 Post-Installation Setup

Setting up PATH (Optional)

To use Flowey from anywhere in your system:

# Copy to system path
sudo cp flowey.pl /usr/local/bin/flowey
sudo cp -r flowies /usr/share/flowey/

# Or create a symbolic link
sudo ln -s $(pwd)/flowey.pl /usr/local/bin/flowey

Configuring Assets Directory

If you installed manually, you may need to specify the assets directory:

# Use the -a flag to specify assets directory
./flowey.pl -a ./flowies "Your message here"

# Or set environment variable
export FLOWEY_ASSETS_DIR="$(pwd)/flowies"
./flowey.pl "Your message here"

✅ Verification

Test Your Installation

Run these commands to verify everything is working:

# Check version
flowey --version

# List available characters
flowey --list

# Test with a message
flowey "Determination fills your soul!"

# Test specific character
flowey -c sans "you're gonna have a bad time."

🐛 Troubleshooting

Common Issues

Permission Denied

# Make the script executable
chmod +x flowey.pl

Module Not Found

# Install missing Perl modules
cpan install Getopt::Long::Descriptive
cpan install File::Find

No Characters Found

# Check assets directory
flowey --list

# Specify correct path
flowey -a /path/to/flowies "message"

ANSI Colors Not Working

Make sure your terminal supports ANSI colors. Try a different terminal emulator or check your TERM environment variable.

🆘 Getting Help

If you're still having issues:

"You feel like you're going to have a good time configuring this."