Wisdom Quotes 📚

A beautiful command-line tool to display random famous quotes with ASCII art characters from both English and Chinese literature. Perfect for daily inspiration, terminal customization, or just discovering wisdom from across cultures and centuries.

✨ Features

• 15,421+ Quotes: Curated collection including:
  • 5,421 English famous quotes from historical figures
  • 10,000 Chinese classical poetry and literature excerpts
• ASCII Art Characters: Fun animated characters including cow, dragon, rabbit, and cat
• Smart Categorization: Filter by category (inspirational, philosophical, humorous, chinese, general)
• Beautiful Display: Elegant formatting with colors and Unicode art
• Lightning Fast: Instant random quote selection with no API calls
• Cross-platform: Works seamlessly on macOS, Linux, and Windows
• Offline First: All data embedded, no internet required
• Multilingual: Seamlessly blends English and Chinese wisdom

📦 Installation

Quick Install from crates.io

cargo install wisdom-quotes

Build from Source

git clone https://github.com/snakeek/wisdom-quotes.git
cd wisdom-quotes
cargo install --path .

🚀 Usage

Basic Commands

# Random quote (any language/category)
quotes

# Show quote with author attribution
quotes --author

# View collection statistics
quotes --stats

# Enable ASCII art mode (random character)
quotes --ascii

# Choose specific ASCII character
quotes --ascii --character cow --author

ASCII Art Characters

# Classic cow (cowsay style)
quotes --ascii --character cow

# Majestic dragon
quotes --ascii --character dragon

# Cute rabbit
quotes --ascii --character rabbit

# Simple cat
quotes --ascii --character cat

Category Filtering

# Inspirational quotes for motivation
quotes --category inspirational --author

# Chinese classical poetry and wisdom
quotes --category chinese --author

# Philosophical insights
quotes --category philosophical --author

# Light-hearted and humorous quotes
quotes --category humorous --author

# General wisdom and observations
quotes --category general --author

🎨 Example Output

ASCII Art Mode:

 ____________________________________________________
/ The only way to do great work is to love what you \
\ do. — Steve Jobs                                   /
 ----------------------------------------------------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

  🚀 励志名言

Regular English Quote:

════════════════════════════════════════════════════════════

  💭 The only way to do great work is to love what
  💭 you do.

      — Steve Jobs

════════════════════════════════════════════════════════════

Chinese Classical Poetry:

════════════════════════════════════════════════════════════

  💭 山有木兮木有枝，心悦君兮君不知。

      — 佚名《越人歌》

════════════════════════════════════════════════════════════

Statistics View:

$ quotes --stats

📊 名言分类统计
══════════════════════════════════════════════════
  🀄 中文名句: 10000 条 (64.8%)
  📝 通用类: 4043 条 (26.2%)
  🤔 哲学类: 774 条 (5.0%)
  🚀 励志类: 555 条 (3.6%)
  😄 幽默类: 49 条 (0.3%)
══════════════════════════════════════════════════
  总计: 15421 条名言

📂 Categories

🛠️ Command Reference

wisdom-quotes 0.2.0
A beautiful command-line tool to display random famous quotes with ASCII art

USAGE:
    quotes [OPTIONS]

OPTIONS:
    -c, --category <CATEGORY>    Filter by category [possible values: inspirational, 
                                philosophical, humorous, general, chinese]
    -a, --author                 Show author information
        --stats                  Show statistics of all categories
        --ascii                  Enable ASCII art mode
        --character <CHARACTER>  Choose ASCII character [possible values: cow, dragon, rabbit, cat]
    -h, --help                   Print help information
    -V, --version                Print version information

🌟 Use Cases

• Daily Inspiration: Add to your shell profile for daily wisdom
• Terminal Customization: Perfect for MOTD or terminal startup
• Writing Prompts: Spark creativity with random quotes
• Language Learning: Discover classical Chinese literature
• Meditation: Philosophical quotes for reflection

📖 Data Sources

This project builds upon excellent open-source datasets:

• English Quotes: JamesFT/Database-Quotes-JSON - Comprehensive collection of famous quotes
• Chinese Literature: caoxingyu/chinese-gushiwen - Classical Chinese poetry and literature database

🤝 Contributing

Contributions are welcome! Areas where you can help:

• Quote Quality: Improve categorization or fix attribution errors
• New Features: Random quote of the day, favorites system, search functionality
• Localization: Add support for other languages
• Performance: Optimize loading or display performance

Please feel free to:

1. Open an issue for bugs or feature requests
2. Submit a pull request with improvements
3. Share feedback on quote quality or categorization

📄 License

This project is dual-licensed under your choice of:

• Apache License, Version 2.0
• MIT License

🙏 Acknowledgments

• Thanks to all the philosophers, poets, and thinkers whose wisdom is preserved here
• Gratitude to the open-source community maintaining the quote databases
• Special appreciation for classical Chinese literature preservation efforts

"The best time to plant a tree was 20 years ago. The second best time is now." — Chinese Proverb