# letters

A Python app that displays random historic love letters from authentic sources, downloaded from [Project Gutenberg](https://www.gutenberg.org/).

## Usage

```bash
python3 love_letters.py              # Show a random love letter
python3 love_letters.py -n 3         # Show 3 random love letters
python3 love_letters.py --list       # List available collections
python3 love_letters.py --source keats_brawne   # Filter by source
python3 love_letters.py --refresh    # Re-download all sources
```

## Sources

| Collection | Author → Recipient | Period |
|---|---|---|
| The Love Letters of Henry VIII to Anne Boleyn | Henry VIII → Anne Boleyn | c. 1527–1528 |
| The Love Letters of Mary Wollstonecraft to Gilbert Imlay | Mary Wollstonecraft → Gilbert Imlay | 1793–1795 |
| Letters of Abelard and Heloise | Abelard & Heloise → each other | 12th century |
| Napoleon's Letters to Josephine | Napoleon Bonaparte → Josephine | 1796–1812 |
| Letters of John Keats to Fanny Brawne | John Keats → Fanny Brawne | 1819–1820 |

All texts are sourced from [Project Gutenberg](https://www.gutenberg.org/) and are in the public domain.

## Requirements

Python 3.10+ (no external dependencies). An internet connection is required on first run to download the letter collections; they are cached locally after that.