readme.md — bash — 80×24
> cat README.md

📖 ReadCalc Documentation

A terminal-themed reading time calculator that helps you estimate reading and speaking times for your content.

✨ Features

  • Word Count - Accurate word counting for any text
  • Reading Time - Estimates based on 225 words/minute
  • Speaking Time - Estimates based on 140 words/minute
  • Character Count - Total characters including spaces
  • Easter Eggs - Hidden commands and surprises 🎮
  • Terminal Aesthetic - Beautiful retro terminal design

🎮 Secret Commands

Clear the textarea and type any of these commands to discover hidden easter eggs:

Command Description
help Show all secret commands
matrix Enter the Matrix with digital rain
cow Fortune cow speaks wisdom
cat ASCII cat appears
rocket Launch to productivity
dev Developer dashboard
42 The answer to everything
clear Clear terminal with style
date Show current date/time
whoami Display user info
uname System information
sudo Try to escalate permissions (spoiler: it won't work)

🕹️ Hidden Easter Eggs

  • Konami Code - Type ↑↑↓↓←→←→BA for a colorful surprise
  • Click Master - Click the terminal title 10 times
  • 42 Words - Write exactly 42 words for a special message

⌨️ Keyboard Shortcuts

  • Ctrl/Cmd + Enter - Clear textarea and reset stats
  • Ctrl/Cmd + S - Log stats to console
  • ESC - Exit Matrix mode

🎯 Usage

  1. Paste or type your content into the textarea
  2. Stats update automatically as you type
  3. Try the secret commands for fun surprises
  4. Use keyboard shortcuts for quick actions

🛠️ Technical Details

  • Reading Speed: 225 words per minute (average adult)
  • Speaking Speed: 140 words per minute (average speech)
  • Built with: Vanilla JavaScript (no dependencies)
  • Hosted on: Cloudflare Workers
  • Analytics: Umami + Microsoft Clarity

📊 How It Works

ReadCalc uses simple but effective calculations:

Reading Time = Total Words ÷ 225 words/minute
Speaking Time = Total Words ÷ 140 words/minute

These are industry-standard averages used by content platforms and professional speakers.

🎨 Design Philosophy

ReadCalc embraces a retro terminal aesthetic because:

  • It's nostalgic and fun for developers
  • Minimalist design = fast performance
  • No distractions from your content
  • Easter eggs add personality and delight

🤝 Contributing

Found a bug or have a feature idea? Feel free to reach out!

Want to add your own easter egg? They're always welcome.

👨‍💻 About

Created by Dean Warwick

A simple, fast, and fun tool for content creators, writers, and developers.

← Back to Calculator