Skip to content

nycanshu/my-pet-buddy

Repository files navigation

My Pet Buddy - Virtual Pet Companion 🐱🐶

A delightful browser extension that brings adorable animated pets to your browser! Choose from cats, dogs, and other cute animals that parade along your screen, creating a fun and engaging browsing experience for pet lovers and animal enthusiasts.

Chrome Web Store Microsoft Edge Version License

file cover - 1

✨ Features

  • 🎨 Multiple Pet Types: Choose from cats, dogs, birds, rabbits, and more
  • 🖼️ PNG Image Support: High-quality pet images with smooth animations
  • 🎯 Interactive Pets: Hover over pets to see them pop and play
  • 📍 Position Control: Place pets at bottom, middle, or top of your screen
  • ⚡ Lightweight: Optimized for performance with minimal resource usage
  • 💾 Persistent Settings: Your preferences are saved across browser sessions
  • 🎨 Modern UI: Clean, professional popup interface with consistent design
  • 🔧 Easy Customization: Add new pet types by simply adding images to the pets folder

🚀 Quick Start Guide

🛒 Install from Browser Stores (Recommended)

Chrome Users:

  1. Visit Chrome Web Store:
    • Click the Chrome badge above or visit: Chrome Web Store
    • Click "Add to Chrome" button

Microsoft Edge Users:

  1. Visit Microsoft Edge Add-ons:

  2. Confirm Installation:

    • Review permissions and click "Add extension"
    • The extension will be automatically installed and enabled
  3. Start Using:

    • Click the "My Pet Buddy" icon in your browser toolbar
    • Toggle the extension ON/OFF using the switch at the top
    • Select your preferred pet position (Bottom/Middle/Top)
    • Choose your pet companion from the gallery
    • Navigate to any webpage to see your pets parading!

🔧 For Developers (Local Installation)

If you want to contribute or test locally:

  1. Clone the Repository:

    git clone https://github.com/nycanshu/my-pet-buddy.git
    cd my-pet-buddy
  2. Load in Browser:

    • Chrome: Navigate to chrome://extensions/
    • Edge: Navigate to edge://extensions/
    • Enable "Developer mode" (toggle in top-right corner)
    • Click "Load unpacked" and select the project folder
  3. Test the Extension:

    • Follow the same usage steps as above

🎮 How to Use

  1. Install: Get the extension from Chrome Web Store or Microsoft Edge Add-ons
  2. Enable: Toggle the switch in the popup to activate pets
  3. Choose Position: Select where you want pets to appear (Bottom/Middle/Top)
  4. Select Your Pet: Click on any pet from the gallery to choose your companion
  5. Enjoy: Navigate to any website and watch your pet parade along the screen!
  6. Interact: Hover over your pet to see it pop and play

🐛 Troubleshooting

  • Pets Not Appearing: Ensure the extension is enabled and a pet is selected
  • Images Not Loading: Check that images are in the pets/ folder with correct naming
  • Animation Issues: Verify that the webpage allows content scripts
  • Storage Issues: Clear extension data in Chrome settings if needed
  • Performance: This extension is optimized for minimal resource usage

🌐 Browser Compatibility

📋 Contribution Guidelines

see our CONTRIBUTING.md file.

📄 License

This project is open source and available under the MIT License.


🎉 Get Started Now!

Install from Chrome Web Store Install from Microsoft Edge

Made with ❤️ for pet lovers and animal enthusiasts!

Bring joy to your browsing experience with adorable virtual companions! 🐾

About

A delightful Chrome extension that brings adorable animated pets to your browser! Choose from cats, dogs, and other cute animals that parade along your screen, creating a fun and engaging browsing experience for pet lovers and animal enthusiasts.

Topics

Resources

Stars

8 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors