45 lines
1.1 KiB
Markdown
45 lines
1.1 KiB
Markdown
# Bard
|
|
|
|
Wikidata & Wikisource Powered Curated Random Poetry Discovery & Archival Engine.
|
|
|
|
Author: **Dr. Simon Vance (Simon the Coder)** (`simonthecoder`)
|
|
|
|
---
|
|
|
|
## Features
|
|
|
|
- **Taste Configuration:** Configure language / nationality (English, Turkish, Persian, French, German, etc.), historical era/century, and minimum popularity score (1 to 5).
|
|
- **Random Poem Discovery:** Displays random world masterworks and archival verses matching your preference.
|
|
- **Offline Library & Auto-Save:** When `--save on` is configured, every poem read is archived into local SQLite storage for offline reading.
|
|
- **Pre-Seeded Masterworks:** 100% functional offline from the first second.
|
|
|
|
---
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
# Read a random poem matching current configuration
|
|
bard
|
|
|
|
# Read a random Turkish poem from the 13th century
|
|
bard --lang turkish --era 13th
|
|
|
|
# Configure preferences interactively
|
|
bard config --interactive
|
|
|
|
# Toggle auto-saving on/off
|
|
bard config --save on
|
|
|
|
# Browse your saved offline library
|
|
bard library
|
|
|
|
# Read a specific saved poem from library
|
|
bard library 1
|
|
```
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
MIT License.
|