Important announcement!!!

• Due to a company named “寻猫记” (which is 100% holding by 小佩, aka petkit in China), involved into some sort of selling cats issue (maybe not illegal, but in a very disgusting way) and I'm not happy with it, if you know to read Chinese, you can find out more detailed info at this web page.
• so here is my announcement:

1. permanently stop this plugin develop ,unpublish from npmjs.com and no more further issue will be answerd.

2. highly recommended you the pet owner and pet lovers stop buying any petkit products.

3. it better feed your soul mate with natural food, like raw meat or dried meat.

4. thank you for your support.

homebridge-petkit-feeder-mini

Setup Guide | Contribute

1) Description

control your petkit feeder mini from homekit, get full use of iOS automation.

features

• uses a fan speed to control the meal amount;
• uses a switch to commit the drop;
• uses a switch to control the Petkit feeder mini light mode;
• uses a switch to control the Petkit feeder mini manual lock;
• uses a occupancy to indicate food storage status;
• uses a filter maintenance to indicate desiccant status(include auto reset desiccant left days, this may not show in homekit);
• uses a battery service to indicate device power status(only for Petkit Feeder Mini, include power level, charging status and low battery alert in Homekit)
• can fetch device info from Petkit server and shows in Homekit.

limitations

• enable/disable meal plan for the day(may be in the next major version, currently no plan to do it).
• currently this plugin for homebridge just tested with Petkit-feeder-mini (official store link), and this plugin currently only tested and works in Asia(include China mainland) and North America, other area may need more work.
• to continuously use this plugin you should login Petkit app and never logoff, this plugin uses session id from the app and it will change every time you logoff and relogin.
• because version 2.x.x is developed on a dynamic platform plugin, and not implement auto remove deleted device(s), so you may need to delete cached accessories manually.
• ......

2) How to setup

Firstly, setup your Petkit mobile app.

Goto App Store, download Petkit mobile app, register, login, add device. before use this plugin you MUST make sure the app works fine with you.

• for China mainland users, download “小佩宠物”
• for those Asia users outside China mainland, you should download "PetKit(International)"
• for users not from Asia, like America, Europe, etc. you also should download "PetKit(International)", but the API url address may not the same, this plugin may or may not works with you, if you are experienced in network, you could use "Quantumult X" to capture app network records, submit the api address to me or just create a PR or just modify this plugin for your own.

Secondly, prepare to capture Petkit app http request.

Please goto this wiki page to find more detail.

Finally, retrieve infomation.

you should provide one critical infomation to this plugin: X-Session, if you have more than one Petkit feeder mini device, then you should alse provide deviceId in the header field of the config.json file.

Be aware of that, to minimize the effect to the Petkit server with unnecessary http requests, the plugin just update device status more than 10s interval, which means the status will bufferd at lease 10s.

• X-Session: this value will change every time you login you Petkit app, so do not logoff your Petkit app unless necessary.
• deviceId: this value indicate which device you wanna to control. If you just have one Petkit feeder mini, you can ignore this value.

here is a example of Quantumult X capture data page:

you can find X-Session data from the request header area and deviceId in response data area.

3) Configure

config.json field

devices field

headers field

we recomand you entered all the headers you captured. If you don't want to do so, please ensure header "X-Session" is correctly entered.

example of config.json file

"platforms": [{
  "log_level": 2,
  "devices": [
      {
        "headers": [
          {
            "key": "X-Session",
            "value": "xxxxxx"
          }
        ],
        "location": "cn",
        "model": "FeederMini",
        "enable_http_retry": false,
        "http_retry_count": 3,
        "DropMeal_name": "DropMeal",
        "MealAmount_name": "MealAmount",
        "FoodStorage_name": "FoodStorage",
        "DesiccantLevel_name": "DesiccantLevel",
        "ManualLock_name": "ManualLock",
        "LightMode_name": "LightMode",
        "Battery_name": "Battery",
        "enable_polling": true,
        "polling_interval": 60,
        "enable_desiccant": true,
        "alert_desiccant_threshold": 7,
        "enable_autoreset_desiccant": true,
        "reset_desiccant_threshold": 5,
        "enable_manualLock": true,
        "enable_lightMode": true,
        "reverse_foodStorage_indicator": true,
        "fast_response": true
      }
  ],
  "platform": "petkit_feeder_mini"
}]