Files
bard/README.md
T

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.