Quotations

A tool to display random inspirational quotes and famous dialogues from movies and TV shows on your CLI.

This is a re-implementation of funmotd, originally written in Python. 🐍

Features ✨

• ✈️ Works entirely offline.
• 📦 Single binary, no dependencies.
• 🔞 Option to enable NSFW quotes.
• 🖥️ Useful as Message of the Day (MOTD) in your terminal when you open it.

Installation ⚙️

Choose the one that best suits your preference! 🎯

1. Homebrew 🍺

brew tap veerendra2/tap
brew install quotations

2. Download Binaries 📥

• Download the latest binary from the Releases page.
• Move it to a directory included in your $PATH, such as /usr/local/bin/.

mv quotations /usr/local/bin/
chmod +x /usr/local/bin/quotations

Usage 🚀

Run the following command to see available options:

quotations --help
Usage: quotations [flags]

Flags:
  -h, --help             Show context-sensitive help.
  -n, --nsfw             Enable NSFW quotes
  -e, --entertainment    Display entertainment (movies and tv shows) quotes (default)
  -i, --inspirational    Display inspirational (famous figures) quotes

Configuration 🔥

To display a random quote each time you open your terminal, add the following line to your shell configuration file (e.g., ~/.bashrc, ~/.zshrc, or ~/.profile).

# Example for bash
echo "/usr/local/bin/quotations" >> ~/.bashrc

# To include NSFW quotes
echo "/usr/local/bin/quotations --nsfw" >> ~/.bashrc

# By default it displays entertainment quotes
# To display inspirational quotes
echo "/usr/local/bin/quotations --inspirational" >> ~/.bashrc

Then, reload your shell configuration:

source ~/.bashrc

Add Quotes with Script

pip3 install -r requirements.txt

# See comments in the script for help
python3 quotes_updater.py

Contributing 🤝

Contributions are welcome! Feel free to submit issues, pull requests, or even suggest new quotes. 💡

License 📜

This project is licensed under the MIT License. See the LICENSE file for details.