🎨 Mood Board CLI

Generate beautiful ASCII/emoji mood boards directly from your terminal.

✨ Overview

Mood Board CLI is a lightweight terminal tool that creates visually stunning mood boards using ASCII art and emojis. Whether you're feeling chill, energetic, productive, or creative — this tool generates a personalized mood board that captures your current vibe.

Perfect for:

• Daily mood tracking
• Terminal aesthetics enthusiasts
• Social media mood updates
• Personal reflection and mindfulness

📦 Installation

Using pip (recommended)

pip install mood-board

From source

git clone https://github.com/yourusername/mood-board.git
cd mood-board
pip install -e .

🚀 Quick Start

Basic usage

mood-board --mood chill relaxed

With all options

mood-board \
  --mood focused creative \
  --weather sunny \
  --activity coding \
  --music lofi \
  --quote \
  --date \
  --border unicode

Save to file

mood-board --mood energetic --quote -o today-mood.txt

🎭 Themes

The tool auto-detects themes from your mood keywords:

Keyword	Theme	Vibe
chill, calm, peaceful	🌊 Chill Vibes	Relaxed, dreamy, cozy
energetic, excited, motivated	⚡ Energetic	Wild, dynamic, pumped
productive, focused, work	📝 Productive Flow	Driven, efficient, organized
sad, nostalgic, reflective	🌧️ Melancholic	Thoughtful, lonely, serene
creative, inspired, artistic	🎨 Creative Spark	Imaginative, playful, curious
nature, grounded, outdoor	🌲 Nature Connection	Free, wild, blooming

🛠️ CLI Reference

usage: mood-board [-h] [--mood MOOD [MOOD ...]] [--theme THEME]
                  [--weather WEATHER] [--activity ACTIVITY] [--music MUSIC]
                  [--quote] [--output OUTPUT] [--date] [--border BORDER]

Argument	Description
--mood	One or more mood keywords (default: chill)
--theme	Preset theme: chill, energetic, productive, melancholic, creative, nature
--weather	Weather condition: sunny, rainy, cloudy, snowy, stormy, clear
--activity	Current activity: coding, reading, gaming, writing, music, etc.
--music	Music genre: lofi, jazz, rock, classical, ambient, etc.
--quote	Include a random inspirational quote
--output, -o	Save output to a file instead of printing
--date	Include today's date on the board
--border	Border style: none, ascii, unicode (default: unicode)

📸 Example Output

╔══════════════════════════════════════════════════╗
║         🌊  ☁️  🍃  MOOD BOARD: CHILL VIBES  🌊  ║
║       Saturday, June 25, 2026                    ║
╚══════════════════════════════════════════════════╝

  ☀️  Weather: Sunny
  💻  Activity: Coding
  🎧  Music: Lofi

  ── MOODS ──

    😌  Chill
    🕊️  Relaxed
    🌿  Peaceful

  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·
  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·

  ───────────────────────────────

  "The only way to do great work is to love what you do."

    — Steve Jobs

  ───────────────────────────────

  Generated with ❤️ by Mood Board CLI
  🎲 73% vibe accuracy
╚══════════════════════════════════════════════════╝

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Adding new themes

Edit mood_board/themes.py and add your theme to the THEMES dictionary:

"my-theme": {
    "label": "My Theme Label",
    "emojis": ["😀", "🎉"],
    "colors": ["red", "blue"],
    "border_char": "#",
    "mood_icons": {...},
    "background_pattern": "...",
},

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

🔗 Links

• GitHub Repository
• Issue Tracker
• PyPI

💬 Support

Found this useful? Give it a ⭐ on GitHub!

Built with ❤️ by the community.