From f25374d2a94ee9fa31b82156153b9282beeda474 Mon Sep 17 00:00:00 2001 From: Sanjeev Deori Date: Sun, 19 Oct 2025 19:53:10 +0530 Subject: [PATCH] Add: [Frontend] Mystical Digital Tarot Reader - Python GUI Application --- .../MiniProjects/TarotCardReader/README.md | 128 ++++++++++ .../MiniProjects/TarotCardReader/main.py | 228 ++++++++++++++++++ 2 files changed, 356 insertions(+) create mode 100644 Domains/Frontend/MiniProjects/TarotCardReader/README.md create mode 100644 Domains/Frontend/MiniProjects/TarotCardReader/main.py diff --git a/Domains/Frontend/MiniProjects/TarotCardReader/README.md b/Domains/Frontend/MiniProjects/TarotCardReader/README.md new file mode 100644 index 00000000..17556cfd --- /dev/null +++ b/Domains/Frontend/MiniProjects/TarotCardReader/README.md @@ -0,0 +1,128 @@ +**Contributor:** SanjeevDeori + +# āœØ Mystical Digital Tarot Reader + +A simple and fun digital tarot card reading application built with Python. Get mystical insights through beautiful tarot card spreads! + +## šŸŒŸ Features + +* **Single Card Reading** - Quick insight into your current energy +* **Three Card Reading** - Past, Present, and Future spread +* **Celtic Cross** - Comprehensive 5-card reading +* **Beautiful Dark Theme** - Celestial night-sky design with purple and gold accents +* **22 Major Arcana Cards** - All classic tarot cards with detailed meanings +* **No Installation Required** - Uses only Python's built-in libraries! +* **Smooth UI** - Scrollable reading area with color-coded text +* **Random Selection** - No duplicate cards in the same reading + +## šŸš€ How to Run + +### Prerequisites +- Python 3.x (tkinter comes pre-installed with Python) + +### Steps +1. **Download** or clone this repository +2. **Save** the code as `tarot.py` +3. **Open** your terminal/command prompt +4. **Navigate** to the directory containing `tarot.py` +5. **Run** the application: + +```bash +python main.py +``` + +That's it! The app window will open automatically. + +## šŸŽÆ How to Use + +1. **Launch** the application +2. **Click** one of the three reading buttons: + - šŸ”® **Single Card Reading** - One card for quick guidance + - šŸŽ“ **Three Card Reading** - Past, Present, Future + - ā­ **Celtic Cross** - 5-card comprehensive reading +3. **Read** the cards and meanings in the scrollable area below +4. **Reflect** on your question and the messages +5. **Click** another button anytime for a new reading! + +## šŸ“– Reading Types + +### šŸ”® Single Card Reading +Quick guidance for simple questions or daily inspiration. + +### šŸŽ“ Three Card Spread +- **Past** ā†’ What led you here +- **Present** ā†’ Your current situation +- **Future** ā†’ What's coming + +### ā­ Celtic Cross (5 Cards) +- **Present Situation** ā†’ Where you stand now +- **Challenge** ā†’ What crosses you +- **Foundation** ā†’ What lies beneath +- **Recent Past** ā†’ What's behind you +- **Potential Outcome** ā†’ What awaits + +## šŸŽ“ The 22 Major Arcana Cards + +The application includes all 22 Major Arcana tarot cards: + +1. The Fool +2. The Magician +3. The High Priestess +4. The Empress +5. The Emperor +6. The Hierophant +7. The Lovers +8. The Chariot +9. Strength +10. The Hermit +11. Wheel of Fortune +12. Justice +13. The Hanged Man +14. Death +15. Temperance +16. The Devil +17. The Tower +18. The Star +19. The Moon +20. The Sun +21. Judgement +22. The World + +Each card comes with its upright meaning and interpretation! + +## āš ļø Important Disclaimer + +**For entertainment purposes only!** + +This is a fun project for learning about tarot and relaxation - not for making serious life decisions. The readings are meant for self-reflection and entertainment. Always use your own judgment and consult professionals for important matters. + +## šŸ› ļø Technical Details + +- **Language:** Python 3.x +- **GUI Library:** tkinter (built-in) +- **Dependencies:** None! (Pure Python standard library) +- **Platform:** Cross-platform (Windows, macOS, Linux) + +## šŸ’” Tips for Users + +* **Read carefully** - Each card meaning is detailed +* **Take your time** - Reflect on how the cards relate to your situation +* **Ask clear questions** - Focus your intention before drawing +* **Remember** - It's about self-reflection, not fortune-telling +* **Have fun!** šŸŒ™āœØ + +## šŸ¤ Contributing + +Contributions, issues, and feature requests are welcome! Feel free to check the issues page. + +## šŸ‘¤ Author + +**Sanjeev Deori** +- GitHub: [@SanjeevDeori](https://github.com/SanjeevDeori) + + +--- + +*The future is not set in stone. Enjoy responsibly!* šŸ”®āœØ + +Made with šŸ’œ for Hacktoberfest and the Open Source Community \ No newline at end of file diff --git a/Domains/Frontend/MiniProjects/TarotCardReader/main.py b/Domains/Frontend/MiniProjects/TarotCardReader/main.py new file mode 100644 index 00000000..a3f32168 --- /dev/null +++ b/Domains/Frontend/MiniProjects/TarotCardReader/main.py @@ -0,0 +1,228 @@ +import tkinter as tk +from tkinter import ttk, scrolledtext +import random + +# Major Arcana Cards with meanings +TAROT_CARDS = { + "The Fool": "New beginnings, innocence, spontaneity, free spirit. Embrace the unknown with childlike wonder.", + "The Magician": "Manifestation, resourcefulness, power, inspired action. You have all the tools you need.", + "The High Priestess": "Intuition, sacred knowledge, divine feminine, the subconscious. Trust your inner voice.", + "The Empress": "Femininity, beauty, nature, nurturing, abundance. Connect with your creative side.", + "The Emperor": "Authority, establishment, structure, father figure. Take control and lead with wisdom.", + "The Hierophant": "Spiritual wisdom, tradition, conformity, morality. Seek guidance from established paths.", + "The Lovers": "Love, harmony, relationships, values alignment. Make choices from the heart.", + "The Chariot": "Control, willpower, success, determination. Victory through focus and discipline.", + "Strength": "Inner strength, courage, patience, compassion. Gentle power overcomes all obstacles.", + "The Hermit": "Soul searching, introspection, inner guidance, solitude. Look within for answers.", + "Wheel of Fortune": "Good luck, karma, life cycles, destiny. Change is the only constant.", + "Justice": "Justice, fairness, truth, cause and effect. Balance will be restored.", + "The Hanged Man": "Pause, surrender, letting go, new perspective. Sometimes stillness brings clarity.", + "Death": "Endings, transformation, transition, letting go. An ending makes room for new beginnings.", + "Temperance": "Balance, moderation, patience, purpose. Find the middle way in all things.", + "The Devil": "Shadow self, attachment, addiction, restriction. Break free from limiting beliefs.", + "The Tower": "Sudden change, upheaval, chaos, revelation. Destruction clears the way for rebuilding.", + "The Star": "Hope, faith, purpose, renewal, spirituality. The light at the end of the tunnel.", + "The Moon": "Illusion, fear, anxiety, subconscious, intuition. Not everything is as it seems.", + "The Sun": "Positivity, fun, warmth, success, vitality. Pure joy and positive energy shine through.", + "Judgement": "Judgement, rebirth, inner calling, absolution. Rise up and answer your calling.", + "The World": "Completion, accomplishment, travel, fulfillment. A cycle ends; celebrate your journey." +} + +class TarotReaderApp: + def __init__(self, root): + self.root = root + self.root.title("āœØ Mystical Digital Tarot Reader āœØ") + self.root.geometry("900x700") + self.root.configure(bg="#0a0e27") + + # Style configuration + self.setup_styles() + + # Create UI + self.create_header() + self.create_buttons() + self.create_reading_area() + self.create_footer() + + def setup_styles(self): + """Configure ttk styles for buttons""" + style = ttk.Style() + style.theme_use('clam') + + # Custom button style + style.configure('Mystical.TButton', + background='#2d1b69', + foreground='#e0d5f5', + borderwidth=2, + focuscolor='none', + font=('Georgia', 12, 'bold'), + padding=10) + + style.map('Mystical.TButton', + background=[('active', '#3d2b79'), ('pressed', '#1d0b59')]) + + def create_header(self): + """Create the header with title and subtitle""" + header_frame = tk.Frame(self.root, bg="#0a0e27") + header_frame.pack(pady=20) + + # Title + title = tk.Label(header_frame, + text="āœØ MYSTICAL TAROT READER āœØ", + font=("Georgia", 28, "bold"), + fg="#ffd700", + bg="#0a0e27") + title.pack() + + # Subtitle + subtitle = tk.Label(header_frame, + text="šŸŒ™ Discover the wisdom of the cards šŸŒ™", + font=("Georgia", 14, "italic"), + fg="#b8a3d6", + bg="#0a0e27") + subtitle.pack(pady=5) + + # Decorative stars + stars = tk.Label(header_frame, + text="ā­ āœØ šŸŒŸ āœØ ā­", + font=("Arial", 16), + fg="#9d7fd9", + bg="#0a0e27") + stars.pack() + + def create_buttons(self): + """Create reading type buttons""" + button_frame = tk.Frame(self.root, bg="#0a0e27") + button_frame.pack(pady=20) + + # Single Card Reading + btn_single = ttk.Button(button_frame, + text="šŸ”® Single Card Reading", + style='Mystical.TButton', + command=self.single_card_reading) + btn_single.grid(row=0, column=0, padx=10, pady=5) + + # Three Card Reading + btn_three = ttk.Button(button_frame, + text="šŸŽ“ Three Card Reading", + style='Mystical.TButton', + command=self.three_card_reading) + btn_three.grid(row=0, column=1, padx=10, pady=5) + + # Celtic Cross Reading + btn_celtic = ttk.Button(button_frame, + text="ā­ Celtic Cross (5 Cards)", + style='Mystical.TButton', + command=self.celtic_cross_reading) + btn_celtic.grid(row=0, column=2, padx=10, pady=5) + + def create_reading_area(self): + """Create the scrolled text area for displaying readings""" + # Frame for reading area + reading_frame = tk.Frame(self.root, bg="#0a0e27") + reading_frame.pack(pady=10, padx=20, fill=tk.BOTH, expand=True) + + # Label + label = tk.Label(reading_frame, + text="Your Reading Will Appear Below:", + font=("Georgia", 14, "bold"), + fg="#e0d5f5", + bg="#0a0e27") + label.pack(pady=5) + + # Scrolled text widget + self.reading_text = scrolledtext.ScrolledText(reading_frame, + wrap=tk.WORD, + width=80, + height=20, + font=("Georgia", 11), + bg="#1a1435", + fg="#e0d5f5", + insertbackground="#ffd700", + relief=tk.SOLID, + borderwidth=2) + self.reading_text.pack(pady=10, fill=tk.BOTH, expand=True) + + # Configure text tags for styling + self.reading_text.tag_configure("title", font=("Georgia", 16, "bold"), foreground="#ffd700") + self.reading_text.tag_configure("card_name", font=("Georgia", 13, "bold"), foreground="#9d7fd9") + self.reading_text.tag_configure("position", font=("Georgia", 12, "italic"), foreground="#b8a3d6") + self.reading_text.tag_configure("meaning", font=("Georgia", 11), foreground="#e0d5f5") + + def create_footer(self): + """Create footer with disclaimer""" + footer = tk.Label(self.root, + text="āš ļø For entertainment purposes only āš ļø\nReflect on the messages, but make decisions with wisdom.", + font=("Georgia", 9, "italic"), + fg="#8a7ba8", + bg="#0a0e27", + justify=tk.CENTER) + footer.pack(pady=10) + + def draw_cards(self, num_cards): + """Draw random cards without replacement""" + cards = list(TAROT_CARDS.keys()) + return random.sample(cards, num_cards) + + def display_reading(self, title, cards_info): + """Display the reading in the text area""" + self.reading_text.delete(1.0, tk.END) + + # Title + self.reading_text.insert(tk.END, f"\n{'='*60}\n", "title") + self.reading_text.insert(tk.END, f"{title}\n", "title") + self.reading_text.insert(tk.END, f"{'='*60}\n\n", "title") + + # Display each card + for position, card_name in cards_info: + # Position (if any) + if position: + self.reading_text.insert(tk.END, f"{position}\n", "position") + + # Card name + self.reading_text.insert(tk.END, f"šŸŽ“ {card_name}\n", "card_name") + + # Card meaning + meaning = TAROT_CARDS[card_name] + self.reading_text.insert(tk.END, f"{meaning}\n\n", "meaning") + self.reading_text.insert(tk.END, f"{'-'*60}\n\n", "meaning") + + # Closing message + self.reading_text.insert(tk.END, "\nāœØ May these insights guide your path āœØ\n", "title") + + def single_card_reading(self): + """Perform a single card reading""" + cards = self.draw_cards(1) + cards_info = [("", cards[0])] + self.display_reading("šŸ”® SINGLE CARD READING šŸ”®", cards_info) + + def three_card_reading(self): + """Perform a three card reading (Past, Present, Future)""" + cards = self.draw_cards(3) + cards_info = [ + ("šŸ“œ PAST - What Led You Here:", cards[0]), + ("ā³ PRESENT - Your Current Situation:", cards[1]), + ("šŸ”® FUTURE - What's Coming:", cards[2]) + ] + self.display_reading("šŸŽ“ THREE CARD READING šŸŽ“", cards_info) + + def celtic_cross_reading(self): + """Perform a Celtic Cross reading (5 cards)""" + cards = self.draw_cards(5) + cards_info = [ + ("1ļøāƒ£ PRESENT SITUATION - Where You Stand:", cards[0]), + ("2ļøāƒ£ CHALLENGE - What Crosses You:", cards[1]), + ("3ļøāƒ£ FOUNDATION - What Lies Beneath:", cards[2]), + ("4ļøāƒ£ RECENT PAST - What's Behind You:", cards[3]), + ("5ļøāƒ£ POTENTIAL OUTCOME - What Awaits:", cards[4]) + ] + self.display_reading("ā­ CELTIC CROSS READING ā­", cards_info) + +def main(): + """Main function to run the application""" + root = tk.Tk() + app = TarotReaderApp(root) + root.mainloop() + +if __name__ == "__main__": + main() \ No newline at end of file