🃏 TermiJack Casino

A stunning terminal-based blackjack game with rich colors, animations, and casino-quality experience

🎮 Quick Start • 🎯 Features • 📸 Screenshots • 📖 Documentation

---

🎲 Welcome to the Terminal Casino!

TermiJack brings the excitement of Las Vegas blackjack right to your terminal! Experience the thrill of 21 with beautiful ASCII art cards, smooth animations, and an intuitive interface that makes you feel like you're sitting at a real casino table.

---

🎯 Features

🃏 Game Features ♠️ Full Blackjack Rules - Hit, stand, blackjack detection 🎰 Smart Dealer AI - Proper casino dealer behavior 💳 Flexible Betting - Custom amounts with helpful shortcuts 🏦 Bankroll Management - Start with $1000, bankruptcy protection 🔄 Endless Play - Play as many rounds as you want

🎨 UI/UX Features 🌈 Rich Colors - Suit-appropriate card coloring ✨ Smooth Animations - Card dealing and drawing effects 📱 Responsive Layout - Adapts to different terminal sizes 🆘 Built-in Help - Contextual help system throughout ⚡ Fast Performance - Instant response and smooth gameplay

---

🚀 Quick Start

Download a Release (Recommended)

• Get the right executable for your OS from the Releases page.
• No Python or dependencies needed. Just run it!

Prerequisites

Python 3.8+

Installation

1. Clone the Repository

   git clone https://github.com/SajagIN/termijack.git
   cd termijack

2. Install Dependencies

   pip install rich

3. Start Playing!

   python main.py

Alternative: One-Line Install

git clone https://github.com/SajagIN/termijack.git && cd termijack && pip install rich && python main.py

---

🎮 How to Play

🃏 Game Controls

Betting Phase

• Enter any amount between $1 and your current chips
• Quick shortcuts:
  • min - Bet $1 (minimum)
  • max - Go all-in with everything
  • half - Bet half your chips
  • help - Show detailed betting help

Playing Phase

• H or hit - Take another card
• S or stand - Keep your current hand
• help - Show game rules and strategy tips

Game Management

• P or play - Start another round
• Q or quit - Leave the casino
• Ctrl+C - Emergency exit anytime

🎲 Blackjack Rules

Objective

Get as close to 21 as possible without going over, while beating the dealer's hand.

Card Values

• Number cards (2-10): Face value
• Face cards (J, Q, K): Worth 10 points each
• Aces: Worth 11 or 1 (automatically optimized)

Winning Conditions

• 🎉 Blackjack - 21 with exactly 2 cards (pays 2.5x)
• ✅ Regular Win - Beat dealer without busting (pays 2x)
• 🤝 Push - Tie with dealer (get your bet back)
• ❌ Bust - Go over 21 (lose your bet)

Dealer Rules

• Must hit on 16 or less
• Must stand on 17 or more
• No strategic decisions (house rules)

---

📸 Screenshots

🎪 Title Screen

🎰 Game Interface

---

🏗️ Architecture

TermiJack is built with a clean, modular architecture that separates concerns beautifully:

📦 TermiJack/
├── 🚀 main.py                # Game entry point
├── 🔧 ui.py                  # UI compatibility layer
├── 🃏 cards.py               # Card and deck logic
├── 🎲 game.py                # Blackjack game engine
└── 📁 ui/                    # User interface package
    ├── 🎭 main_ui.py         # Main UI controller
    ├── 🎨 card_renderer.py   # ASCII card graphics
    ├── 📐 layout_manager.py  # Screen layout system
    ├── ⌨️  input_handler.py  # Input processing
    ├── 📊 info_panels.py     # Information displays
    ├── ✨ animations.py      # Visual effects
    └── 📋 __init__.py        # Package setup

🎓 For Developers

🔧 Tech Stack

• Language: Python 3.8+
• UI Framework: Rich (Advanced terminal formatting)

🧪 Testing

# Test basic functionality
python -c "from ui import UI; from game import Game; print('✅ All systems operational!')"

# Test card rendering
python -c "from cards import Deck; d = Deck(); print('✅ Deck created with', len(d.cards), 'cards')"

---

📖 Documentation

• 📋 WORKING.md - Complete technical documentation (2,500+ words)
• 🎯 Game Rules - Built-in help system
• 🏗️ Architecture - System design overview
• 🔧 API Reference - Detailed component documentation

---

🌍 Compatibility

Platform	Terminal	Unicode	Colors	Status
🪟 Windows	PowerShell 7+ / Windows Terminal	✅	✅	🟢 Full Support
🪟 Windows	Command Prompt	⚠️	✅	🟡 Limited Unicode
🍎 macOS	Terminal.app / iTerm2	✅	✅	🟢 Full Support
🐧 Linux	Most terminals	✅	✅	🟢 Full Support

---

🎨 Customization

TermiJack currently doesn't support customization through TUI.

🎨 Change Card Colors

Edit ui/card_renderer.py:

# Change Hearts to pink instead of red
if suit_name == "Hearts":
    border_color = "bright_magenta"  # Changed from bright_red
    text_color = "bright_magenta"

💰 Modify Starting Money

Edit game.py:

class Player(Hand):
    def __init__(self, starting_cash: int = 2000):  # Changed from 1000

⚡ Adjust Animation Speed

Edit ui/animations.py:

def show_dealing_animation(self):
    # ...
    time.sleep(0.5)  # Faster - changed from 1.2

---

📊 Project Stats

Built with ❤️ for terminal game enthusiasts

---

📄 License

This project is licensed under the MIT License

MIT License - Feel free to use, modify, and distribute!
Perfect for learning, teaching, or just having fun. 🎲

---

⭐ Star this repo if you enjoyed TermiJack!