https://github.com/thekartikeyamishra/mood-dashboard
The Mood Dashboard is a Python-based interactive tool designed to lift your spirits and provide personalized recommendations based on your current mood. It combines fun and practicality, offering motivational quotes, jokes, and relaxing videos, along with a visual representation of mood distribution.
https://github.com/thekartikeyamishra/mood-dashboard
googlecolab ipywidgets jyputer-notebook matplotlib-pyplot python request
Last synced: 8 months ago
JSON representation
The Mood Dashboard is a Python-based interactive tool designed to lift your spirits and provide personalized recommendations based on your current mood. It combines fun and practicality, offering motivational quotes, jokes, and relaxing videos, along with a visual representation of mood distribution.
- Host: GitHub
- URL: https://github.com/thekartikeyamishra/mood-dashboard
- Owner: thekartikeyamishra
- Created: 2025-01-09T14:57:31.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-01-09T18:30:03.000Z (10 months ago)
- Last Synced: 2025-01-31T21:48:20.107Z (10 months ago)
- Topics: googlecolab, ipywidgets, jyputer-notebook, matplotlib-pyplot, python, request
- Language: Jupyter Notebook
- Homepage:
- Size: 28.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# **Mood Dashboard: A Fun and Useful Python Script**
## **Project Overview**
The **Mood Dashboard** is a Python-based interactive tool designed to lift your spirits and provide personalized recommendations based on your current mood. It combines fun and practicality, offering motivational quotes, jokes, and relaxing videos, along with a visual representation of mood distribution. The project is designed to run seamlessly in **Google Colab**, making it accessible and easy to use for everyone.
---
## **Features**
### 🎭 **Interactive Mood Selection**
- Users can select their mood from a dropdown menu.
- Moods include: `happy`, `sad`, `relaxed`, `stressed`, and `neutral`.
### 💡 **Personalized Suggestions**
- Based on the selected mood, the dashboard provides:
- **Motivational Quotes**: Boost your motivation when you're feeling happy.
- **Jokes**: Lighten your mood with humor when you're feeling sad.
- **Relaxing Videos**: Calm your mind if you're stressed or relaxed.
- **Random Suggestions**: A mix of quotes and jokes if your mood is neutral.
### 📊 **Visual Feedback**
- A dynamic bar chart shows simulated "Mood Distribution" to visualize mood trends.
- Highlights your selected mood for better engagement.
### 🌐 **Seamless Integration**
- Designed for **Google Colab**, making it highly interactive and user-friendly.
- No complicated setup required – just copy and paste the script.
---
## **Installation Instructions**
### Step 1: Clone the Repository
First, clone the repository to your local machine:
```bash
git clone https://github.com/thekartikeyamishra/Mood-Dashboard.git
cd Mood-Dashboard
```
### Step 2: Run in Google Colab
1. Open [Google Colab](https://colab.research.google.com/).
2. Upload the script file (`mood_dashboard.py`) or copy the code into a Colab notebook.
### Step 3: Install Dependencies
Run the following command in a Colab cell to install the required libraries:
```bash
!pip install matplotlib ipywidgets requests
```
### Step 4: Run the Script
Execute the script in the Colab notebook, and enjoy the interactive dashboard.
---
## **How to Use**
1. **Launch the Dashboard**:
- Once the script is running, you will see an interactive dropdown menu.
2. **Select Your Mood**:
- Choose one of the moods (`happy`, `sad`, `relaxed`, `stressed`, or `neutral`) from the dropdown.
3. **View Recommendations**:
- Based on your mood, you’ll receive:
- A motivational quote.
- A joke.
- A relaxing video link.
- The tool also generates a mood distribution chart to visualize mood trends.
4. **Explore and Enjoy**:
- Follow the suggestions, watch relaxing videos, and explore the bar chart for fun insights.
## **Examples**
### Example 1: Feeling Happy
**Input**: `happy`
**Output**:
- A motivational quote, such as:
```
Believe you can and you're halfway there. –Theodore Roosevelt
```
- A bar chart showing mood distribution.
### Example 2: Feeling Stressed
**Input**: `stressed`
**Output**:
- A relaxing video suggestion, such as:
```
Watch this: [Relaxing Video](https://www.youtube.com/watch?v=5qap5aO4i9A)
```
- A bar chart highlighting the "stressed" mood.
---
## **Use Cases**
### 1. **Personal Relaxation**
- Use it as a quick pick-me-up during stressful days or to relax after work.
### 2. **Educational Tool**
- Demonstrates Python’s capabilities in data visualization, user interaction, and API integration.
### 3. **Wellness App Prototype**
- Serves as a prototype for a mental wellness application, integrating humor and relaxation.
---
## **Potential Enhancements**
1. **Mood Tracking**:
- Save and analyze mood trends over time for personal insights.
2. **Multiple User Support**:
- Extend the tool to allow tracking moods for multiple users.
3. **Content Customization**:
- Enable users to add their own jokes, quotes, or video links.
4. **Save Visuals**:
- Add functionality to export mood distribution charts as images.
---
## **Contribute**
Contributions are welcome! Here's how you can help:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature-name
```
3. Commit your changes:
```bash
git commit -m "Add feature: feature-name"
```
4. Push to the branch:
```bash
git push origin feature-name
```
5. Open a pull request.
---
## **Support**
If you enjoy using the **Mood Dashboard**, please:
- Give the project a ⭐ on GitHub.
- Share it with friends and colleagues who might find it fun and useful.
---
Let’s make the world a little brighter, one mood at a time! 🌟