Homebridge PetLibro Smart Feeder

A Homebridge plugin that integrates PetLibro smart feeders with Apple HomeKit, allowing you to trigger manual feeding sessions directly from your iOS Home app.

Features

• 🍽️ Manual Feeding: Trigger feeding sessions from your Home app
• 📱 HomeKit Integration: Works seamlessly with Apple's Home ecosystem
• 🔄 Momentary Switch: Switch automatically resets after feeding
• 🛡️ Robust Error Handling: Graceful failures that won't break Homebridge
• 🔐 Secure Authentication: Uses the same API as the official PetLibro app

Supported Devices

This plugin works with PetLibro feeders that use the main PetLibro app (not PetLibro Lite):

• Granary Smart Feeder (PLAF103)
• Space Smart Feeder (PLAF107)
• Air Smart Feeder (PLAF108)
• Polar Wet Food Feeder (PLAF109)
• Granary Smart Camera Feeder (PLAF203)
• One RFID Smart Feeder (PLAF301)

Installation

Option 1: Homebridge Config UI X (Recommended)

1. Search for "PetLibro" in the Homebridge Config UI X plugin store
2. Install the plugin
3. Configure using the web interface

Option 2: Command Line

npm install -g homebridge-petlibro

Configuration

Using Homebridge Config UI X

After installation, configure the plugin through the Homebridge web interface. You'll need:

• Your PetLibro account email
• Your PetLibro account password
• Number of portions to dispense (optional, defaults to 1)

Manual Configuration

Add the following to your Homebridge config.json in the platforms section:

{
  "platforms": [
    {
      "platform": "PetLibroPlatform",
      "name": "Pet Feeder",
      "email": "[email protected]",
      "password": "your-petlibro-password",
      "portions": 1,
      "timezone": "America/New_York",
      "country": "US"
    }
  ]
}

Configuration Options

| Option | Required | Default | Description | |--------|----------|---------|-------------| | platform | Yes | | Must be "PetLibroPlatform" | | name | No | "Pet Feeder" | Display name in Home app | | email | Yes | | Your PetLibro account email | | password | Yes | | Your PetLibro account password | | portions | No | 1 | Number of portions per feeding (1-10) | | timezone | No | "America/New_York" | Your timezone | | country | No | "US" | Your country code | | deviceId | No | | Specific device ID (auto-detected) |

Important Setup Notes

Account Limitations

⚠️ PetLibro only allows one device to be logged into an account at a time.

Recommended Setup:

1. Create a second PetLibro account with a different email
2. In your main PetLibro app, share your feeder to the new account
3. Use the new account credentials in this Homebridge plugin

This allows both your mobile app and Homebridge to work simultaneously.

Verification Steps

Before configuring the plugin:

1. ✅ Verify your credentials work in the official PetLibro mobile app
2. ✅ Ensure you're using the main "PetLibro" app (not "PetLibro Lite")
3. ✅ Confirm your feeder is connected to WiFi and working normally

Usage

1. After configuration, your feeder will appear as a switch in the Home app
2. Tap the switch to trigger a manual feeding
3. The switch automatically turns off after 1 second (momentary behavior)
4. Check Homebridge logs to confirm feeding was successful

Troubleshooting

Authentication Issues

Problem: Plugin fails to authenticate

• ✅ Verify email/password work in the PetLibro mobile app
• ✅ Ensure only one device is logged into your PetLibro account
• ✅ Try creating a dedicated account for Homebridge (recommended)

Device Not Found

Problem: Plugin authenticates but can't find your feeder

• ✅ Confirm your feeder appears in the PetLibro mobile app
• ✅ Check that device sharing is set up correctly (if using separate account)
• ✅ Look at Homebridge logs for device discovery details

Feeding Not Working

Problem: Switch appears but feeding doesn't work

• ✅ Ensure feeder has food and is powered on
• ✅ Verify feeder connectivity in the PetLibro app
• ✅ Check Homebridge logs for API error messages
• ✅ Try manual feeding through the official app first

Common Error Messages

"Invalid account or password"

• Check credentials are correct
• Ensure no other device is logged into the account

"Device ID not found"

• Verify device sharing is configured properly
• Check that the feeder appears in your account

"Authentication failed: SYSTEM_ERROR"

• Usually indicates incorrect API credentials
• Verify you're using the main PetLibro app (not Lite)

Technical Details

This plugin uses the same API endpoints as the official PetLibro mobile application, reverse-engineered from the open-source HomeAssistant PetLibro integration.

API Endpoints Used

• Authentication: POST /member/auth/login
• Device Discovery: POST /device/device/list
• Manual Feeding: POST /device/device/manualFeeding

Contributing

Found a bug or want to contribute?

1. Check existing issues
2. Create a detailed bug report with:
   • Homebridge logs
   • Device model
   • Configuration (without credentials)
3. Test that your feeder works with the official PetLibro app

Legal Disclaimer

⚠️ This is an unofficial plugin, not affiliated with PetLibro.

• Use at your own risk
• API endpoints may change without notice
• Check PetLibro's Terms of Service before use
• The plugin is reverse-engineered from publicly available information

License

MIT License - see LICENSE file for details.

Acknowledgments

• Based on the HomeAssistant PetLibro integration by jjjonesjr33
• Built for the Homebridge platform

Enjoying this plugin? ⭐ Star the repository and consider supporting the project!