# Celtic Heraldry Ultimate - Project Overview

## What Was Created

I've successfully blended your two projects together! Here's what you now have on your desktop:

## 📁 Main Files Created

### ⭐ COLORFUL TERMINAL VERSIONS (RECOMMENDED!) ⭐

These preserve all the original ANSI color codes from the COA-CMD-Tool art:

#### 1. **celtic_gallery_colorful.py** - Full Color Celtic Art Gallery
**Run with:** `RUN_COLORFUL_GALLERY.bat`

A pure terminal menu system featuring:
- 🍀 **Irish Shamrock** - GREEN, authentic from COA-CMD-Tool
- ✝️ **Celtic Cross Small** - GREEN, compact version
- ✝️ **Celtic Cross Large** - GREEN, detailed intricate design
- ✝️ **Celtic Cross JGS** - GREEN, by Joan Stark
- 🔷 **Celtic Knot Pattern 1** - CYAN, interlaced design
- 🔷 **Celtic Knot Pattern 2** - MAGENTA, extended weave
- ✨ **Elaborate Cross** - YELLOW, ornate design
- ✋ **Red Hand of Ulster** - RED/MULTI-COLOR, ancient Irish symbol

**Why use this version?** It preserves ALL the beautiful colors from the original art!

#### 2. **psalm_84_colorful.py** - Colorful Psalm 84
**Run with:** `RUN_PSALM84_COLORFUL.bat`

The Psalm 84 display matching your image:
- ✅ **GREEN** Celtic knot borders on both sides
- ✅ **YELLOW** text for the psalm body
- ✅ **RED** highlights for special letters (O, B)
- ✅ "Psalm 84" heading in **RED**
- ✅ Repeating Celtic pattern that cycles through 8 variations

### 📱 TUI VERSIONS (Nice UI, but loses some colors)

These use the Textual TUI framework for a modern interface:

#### 3. **celtic_heraldry_ultimate.py** - TUI Master Application
**Run with:** `RUN_CELTIC_ULTIMATE.bat`

Complete blended TUI application with keyboard navigation:
- Irish Heraldry Search (622 entries)
- Celtic Art Gallery (6 patterns)
- Psalm 84 Display
- Irish Symbols

⚠️ **Note:** TUI framework strips embedded ANSI colors, so Celtic art appears in single colors.

#### 4. **psalm_84_display.py** - TUI Psalm Display
**Run with:** `RUN_PSALM84.bat`

TUI version with nice borders and layout.

⚠️ **Note:** Colors are applied via TUI markup, not original ANSI codes.

## 🎨 Features Integrated

### From Book of Kells TUI (book_of_kells_tui.py):
- All Celtic ASCII art patterns
- Celtic cross by Joan Stark (jgs)
- Multiple knot weave patterns
- Border designs
- Elaborate decorative cross
- Massive Celtic weave pattern

### From COA-CMD-Tool:
- Complete Irish Heraldry database (622 entries)
- Coat of arms ASCII art
- Surname search functionality
- Motto translations and language attributions
- Historical origin data (Milesian/Norman)
- Shamrock and Celtic cross symbols

## 🚀 How to Run

### ⭐ RECOMMENDED: Colorful Terminal Versions

**For the Full Celtic Art Gallery with ALL colors:**
```batch
RUN_COLORFUL_GALLERY.bat
```
Double-click to see shamrocks, Celtic crosses, and Red Hand in full color!

**For Psalm 84 matching your image exactly:**
```batch
RUN_PSALM84_COLORFUL.bat
```
Double-click to see the exact recreation with green borders, yellow text, red letters!

### 📱 Alternative: TUI Versions

**For modern TUI interface (loses some colors):**
```batch
RUN_CELTIC_ULTIMATE.bat  # Full app with menus
RUN_PSALM84.bat          # Just Psalm 84
```

### Command Line
```bash
# Colorful versions (RECOMMENDED)
python celtic_gallery_colorful.py
python psalm_84_colorful.py

# TUI versions
python celtic_heraldry_ultimate.py
python psalm_84_display.py
```

## 🎮 Navigation

### Main Menu (celtic_heraldry_ultimate.py)
- Press **1** - Irish Heraldry Search
- Press **2** - Celtic Art Gallery
- Press **3** - Psalm 84 Display
- Press **4** - Irish Symbols (Shamrock & Cross)
- Press **Q** - Quit

### Inside Each Section
- Press **ESC** or **Q** - Go back to previous menu
- Type in search box - Search for Irish surnames
- Number keys - Navigate galleries

## 🎨 Color Scheme

The application uses a beautiful color palette:
- **Gold** - Titles and headers
- **Green** - Celtic borders and Irish symbols
- **Cyan/Blue** - Descriptive text and options
- **Yellow** - Sacred text (Psalms)
- **Red** - Emphasis and special letters
- **Magenta/White** - Various UI elements

## 📊 What's Included

### Celtic Art Patterns (6 Total)
1. Celtic Cross (compact, by Joan Stark)
2. Celtic Knot Pattern 1 (basic interlaced)
3. Celtic Knot Pattern 2 (extended weave)
4. Celtic Border Pattern (repeating design)
5. Large Celtic Knotwork
6. Massive Celtic Weave (extensive pattern)

### Heraldry Database
- 622 authentic Irish heraldic entries
- 566 unique Irish surnames
- ~94% complete motto translations
- Coat of arms ASCII art for many families
- Historical origin data (Milesian/Norman)

### Special Displays
- Psalm 84 with Celtic borders (matching your image!)
- Traditional Irish shamrock
- Celtic cross (detailed and small versions)

## 🔧 Technical Details

- Built with **Textual** TUI framework
- Uses Rich markup for colors and formatting
- Modular screen-based architecture
- Keyboard-driven navigation
- Responsive layouts
- Scrollable content areas

## 📝 File Structure

```
C:\Users\Squir\Desktop\
├── celtic_heraldry_ultimate.py     # Main blended app
├── psalm_84_display.py             # Standalone Psalm display
├── book_of_kells_tui.py           # Original Celtic art app
├── RUN_CELTIC_ULTIMATE.bat        # Launch main app
├── RUN_PSALM84.bat                # Launch Psalm display
└── COA-CMD-Tool/                  # Original heraldry tool
    ├── heraldry_database_real.py  # 622 Irish entries
    ├── coat_of_arms_art_real.py   # ASCII art
    └── [other files]
```

## 🎉 What's Different from Originals?

### Enhanced from Book of Kells:
- Integrated with heraldry search
- Added Psalm 84 display
- Unified navigation
- Combined menu system

### Enhanced from COA-CMD-Tool:
- Added beautiful Celtic art gallery
- Improved visual presentation
- Integrated sacred text display
- Unified with Celtic aesthetic

### Brand New:
- Psalm 84 display with Celtic borders (from your image)
- Unified main menu
- Seamless navigation between all features
- Consistent color theme throughout

## 🙏 Credits

- **Celtic ASCII Art**: From Book of Kells TUI collection
- **Joan Stark (jgs)**: Celtic Cross ASCII art
- **Irish Heraldry Data**: COA-CMD-Tool database (622 entries)
- **Psalm 84 Design**: Recreated from your provided image

## 📚 Next Steps

You can now:
1. Run `RUN_CELTIC_ULTIMATE.bat` to explore everything
2. Search for Irish surnames (try O'Brien, Kennedy, Burke)
3. Browse all 6 Celtic art patterns
4. View the beautiful Psalm 84 display
5. Enjoy the Irish symbols (shamrock and cross)

---

**IN PRINCIPIO ERAT VERBVM**

※ Beannachtaí (Blessings) ※