Skip to main content
PeonPing ships with a rich library of sound packs featuring iconic game characters. Each pack contains voice lines organized by CESP categories.

​
Default Packs

The standard installer includes 5 curated packs:

peon (Default)

Character: Orc Peon (Warcraft III)Voice lines:
  • “Ready to work?”
  • “Work, work.”
  • “Okie dokie.”
  • “Me busy, leave me alone!”
Best for: Classic Warcraft nostalgia

peasant

Character: Human Peasant (Warcraft III)Voice lines:
  • “Yes, milord?”
  • “Job’s done!”
  • “Ready, sir.”
Best for: Professional tone with medieval charm

sc_kerrigan

Character: Sarah Kerrigan (StarCraft)Voice lines:
  • “I gotcha”
  • “What now?”
  • “Easily amused, huh?”
  • “I read you.”
Best for: Tactical, confident vibes

sc_battlecruiser

Character: Battlecruiser (StarCraft)Voice lines:
  • “Battlecruiser operational”
  • “Make it happen”
  • “Engage”
Best for: Military precision and power

glados

Character: GLaDOS (Portal)Voice lines:
  • “Oh, it’s you.”
  • “You monster.”
  • “Your entire team is dead.”
Best for: Sarcastic AI overlord energy

​
Browse All Packs

Explore 165+ packs with audio previews →

​
Popular Franchises

  • Warcraft — Peon, Peasant, Murloc, Wisp, Grunt, Footman, and more
  • StarCraft — Kerrigan, Battlecruiser, Marine, SCV, Zealot, Hydralisk
  • Red Alert — Soviet Commander, Allied Commander, Tanya, Engineer
  • Portal — GLaDOS, Wheatley, Cave Johnson
  • Zelda — Link, Navi, various NPCs
  • Dota 2 — Hero voice lines
  • Helldivers 2 — Squad callouts
  • Elder Scrolls — Guard, merchant, quest giver lines
  • Duke Nukem — Classic one-liners

​
Managing Packs

​
List Installed Packs

peon packs list
Output: 
Installed packs:
  peon (active)
  peasant
  sc_kerrigan
  sc_battlecruiser
  glados

​
Browse Registry

peon packs list --registry
Shows all 165+ packs available in the OpenPeon registry.

​
Install Packs

peon packs install glados,murloc,duke_nukem
Comma-separated list of pack names.

​
Switch Packs

# Switch to a specific pack
peon packs use glados

# Switch and install if not already installed
peon packs use --install murloc

# Cycle to next pack in rotation
peon packs next
Effect: Immediately changes the active pack. Next event uses the new pack’s sounds.

​
Remove Packs

peon packs remove glados,murloc
Deletes the specified packs from disk. Cannot remove the currently active pack.

​
Pack Rotation

Rotate between multiple packs automatically with each session:

​
Rotation Modes

Picks a random pack from the rotation list each session.Configuration:
{
  "pack_rotation": ["peon", "glados", "sc_kerrigan"],
  "pack_rotation_mode": "random"
}
Set via CLI:
peon rotation random

​
Check Current Mode

peon rotation
Output: 
Pack rotation mode: random
Rotation list: peon, glados, sc_kerrigan

​
Directory-Based Pack Rules

Automatically switch packs based on project directory:

​
Path Rules

{
  "path_rules": [
    { "pattern": "*/work/client-a/*", "pack": "glados" },
    { "pattern": "*/personal/*", "pack": "peon" },
    { "pattern": "*/services/*", "pack": "sc_battlecruiser" }
  ]
}
Matching:
  • First matching rule wins
  • Supports * and ? wildcards
  • Overrides pack_rotation and default_pack
  • Overridden by session_override assignments

​
Bind Pack to Directory

# Bind current directory
cd ~/work/client-a
peon packs bind glados

# Bind with pattern
peon packs bind --pattern "*/services" sc_battlecruiser

# Remove binding for current directory
peon packs unbind

# List all bindings
peon packs bindings
Output of peon packs bindings: 
Directory bindings:
  */work/client-a/* → glados
  */personal/* → peon
  */services/* → sc_battlecruiser

​
Pack Priority Hierarchy

When multiple rules apply, PeonPing uses this priority:
  1. Session override (/peon-ping-use <pack>)
  2. Path rules (directory pattern matching)
  3. Pack rotation (if pack_rotation is non-empty)
  4. Default pack (default_pack config key)
Fallback behavior: If a pack is invalid or missing, PeonPing falls back through the hierarchy until it finds a valid pack.

​
Creating Custom Packs

Build your own sound pack:
  1. Read the CESP spec: openpeon.com/spec
  2. Follow the creation guide: openpeon.com/create
  3. See contribution docs: CONTRIBUTING.md

​
Pack Structure

my-pack/
├── openpeon.json          # CESP manifest
├── session.start/
│   ├── greeting1.wav
│   └── greeting2.wav
├── task.complete/
│   ├── done1.wav
│   └── done2.wav
└── task.error/
    └── error1.wav

​
Install Your Pack

peon packs install-local ~/my-pack
peon packs use my-pack

​
Interactive Pack Picker

Use the web-based pack picker to generate a custom install command: peonping.com/#picker
  1. Browse all packs with audio previews
  2. Select your favorites
  3. Get a custom install command: 
    curl -fsSL https://peonping.com/install | bash -s -- --packs=peon,glados,murloc

​
Related Configuration

Sound Events

CESP categories and event triggers

Notifications

Customize notification themes per pack

Build docs developers (and LLMs) love

Get started for freeTalk to us