https://github.com/pirtleshell/owl-wisdom
A wise owl spouts quotes to your terminal, inspired by cowsay :books:
https://github.com/pirtleshell/owl-wisdom
cli cowsay fun quotes terminal-app
Last synced: 5 months ago
JSON representation
A wise owl spouts quotes to your terminal, inspired by cowsay :books:
- Host: GitHub
- URL: https://github.com/pirtleshell/owl-wisdom
- Owner: pirtleshell
- License: mit
- Created: 2016-12-16T22:00:25.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2019-05-22T19:40:21.000Z (over 6 years ago)
- Last Synced: 2025-04-17T21:30:01.881Z (6 months ago)
- Topics: cli, cowsay, fun, quotes, terminal-app
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/owl-wisdom
- Size: 46.9 KB
- Stars: 5
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# owl-wisdom
> A wise owl spouts quotes to your terminal, inspired by cowsay :books:
## About
After making an ASCII owl, the desire came to let it inspire me. The module builds a quote database by fetching the [BrainyQuotes quotes of the day](https://www.brainyquote.com/quotes_of_the_day.html) once a day, any day you ask the owl for some wisdom. It adds those quotes to the database and chooses a random quote with which to learn you.
Inspired and powered by [cowsay](https://github.com/piuccio/cowsay). Quote fetching is a rewrite of [quoter](https://www.npmjs.com/package/quoter).
## Install
```sh
$ npm install -g owl-wisdom
```
## Use
```sh
$ owl-wisdom
```
**Get inspired every time you open your terminal by putting it in your `.bashrc`**:
```sh
$ echo owl-wisdom >> ~/.bashrc
```
Besides the owl, all the creatures of cowsay are available, or you can add a path to [your own cow file](https://github.com/paulkaefer/cowsay-files):
```sh
# your own cowfile
$ owl-wisdom path/to/file.cow
# or an included cowsay file:
$ owl-wisdom stegosaurus
```
## More
```
$ owl-wisdom -h
Usage: owl-wisdom [cowFile]
cowFile An optional cowfile name or path to cow file for non-owl insight
--limit [int] Get or set the maximum number of quotes to keep in the database,
default 100
--count Find out how many quotes are in your database
--update Force a quote database update.
--where Owl tells you the location of quote database
More help:
-h, --help Let's not insult your intelligence here...
-l List included cow files
```
## The Quote Database
The database is saved as `.quoteDb.json` in your home directory. Here's what it looks like so you could link in and add your own quotes if so desired. It is simply a JSON file:
```js
{
ids: ['42'], // used to ensure the same quote isn't added multiple times
quotes: [ // an array of objects that contain a quote and author
{
quote: 'We are ways for the Cosmos to know itself.',
author: 'Carl Sagan'
}
],
lastUpdate: '2016-12-16', // recorded so it only updates once a day
limit: 100 // the maximum quotes to store in the database.
}
```
## License
MIT © 2016 [Robert Pirtle](https://pirtle.xyz)