Skip to content

Repository files navigation

📚 quotes-cli

Quotes CLI Logo

VersionLicenseDownloadsGitHub starsMade with Node.js

Your daily dose of wisdom and inspiration, right from the terminal 🌟

InstallationFeaturesUsageDocumentationContributing


✨ Features

FeatureDescription
🎲 Random QuotesGet instant wisdom with random quotes
🏷️ Tagged QuotesFind quotes by specific categories
🔍 Smart SearchSearch by author or book titles
📚 Bulk FetchGet multiple quotes at once
🎯 Filtered BulkGet multiple quotes by tag or search

🚀 Installation

Prerequisites
  • Node.js installed on your system
  • npm or yarn package manager
  • Active internet connection
# Using npm
npm install -g quotes-cli

📖 Usage

🎯 Available Commands

CommandDescriptionExample
quote | qGet a random quotequotes-cli q
tag | t <name>Get a quote by tagquotes-cli t love
search | s <query>Search quotesquotes-cli s "Einstein"
bulk | b <number>Get multiple quotesquotes-cli b 5
bulk-tag | bt <name> <number>Get multiple quotes by tagquotes-cli bt inspiration 4
bulk-search | bs <query> <number>Get multiple quotes by searchquotes-cli bs "Mark Twain" 3

💫 Command Examples

Get a Random Quote

$ quotes-cli quote
┌─────────────────────────────────────────────────────┐
│ "Be yourself; everyone else is already taken." │
│ - Oscar Wilde │
└─────────────────────────────────────────────────────┘

Get Multiple Quotes by Tag

$ quotes-cli bulk-tag humor 3
╔════════════════════════════════════════════════════╗
║ "Laughter is timeless, imagination has no age, ║
║ and dreams are forever." ║
║ - Walt Disney ║
╚════════════════════════════════════════════════════╝
╔════════════════════════════════════════════════════╗
║ "A day without laughter is a day wasted." ║
║ - Charlie Chaplin ║
╚════════════════════════════════════════════════════╝
╔════════════════════════════════════════════════════╗
║ "Life is short. Smile while you still have teeth." ║
║ - Unknown ║
╚════════════════════════════════════════════════════╝

🏷️ Available Tags

Category 1Category 2Category 3Category 4
💝 love🌟 life💡 wisdom🎭 poetry
✨ inspiration😄 humor🤔 philosophy💑 romance
⛪ religion🎯 success📚 knowledge🤝 friendship
🎨 motivation😊 happiness🌈 hope✌️ peace

🛠️ Technical Notes

Command Options
Usage: quotes-cli [options] [command]
Options:
-V, --version output the version number
-h, --help output usage information
Commands:
quote | q Get a random quote
tag | t <name> Get a random quote from a tag
search | s <query> Get a random quote from an author or book
bulk | b <number> Get multiple random quotes (max 10)
bulk-tag | bt <name><number>
Get multiple quotes from a tag (max 10)
bulk-search | bs <query><number>
Get multiple quotes from a search query (max 10)
Limitations
  • Maximum 10 quotes per bulk request (applies to bulk, bulk-tag, and bulk-search)
  • Requires active internet connection
  • Real-time Goodreads scraping
  • Random page selection for variety

👥 Contributing

We love contributions! 💝

  1. 🍴 Fork the repository
  2. 🌿 Create your feature branch
  3. 💫 Make your changes
  4. 🚀 Submit a pull request

⚖️ Legal

Goodreads TOS

This tool scrapes data from Goodreads for personal use. Please comply with Goodreads' Terms of Service.

📜 License

MIT License

Copyright © 2024 anilpdv


Made with ❤️ by Anil Palli

⬆ back to top

About

quotes-cli is command line interface for getting random quotes by search,tag and popular.

Resources

Stars

8 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages