search

elahd / pylaundry

Python library for viewing laundry room and account status for facilities using ESD payment equipment.
MIT License
4 stars 0 forks source link

Feature Request: Support Hercules CP app #24

Open funkymonkeymonk opened 2 years ago

funkymonkeymonk commented 2 years ago

Thanks for creating this. Fellow New Yorker here who would love to integrate this with my home assistant setup. It seems like the new Hercules laundry rooms are using the Hercules CP app. I tried it out figuring that I'd see if it worked and it didn't. I'm interested in following in your footsteps and seeing if I can get this working with my laundry room. Do you have any idea pointers? I'm going to dig into the code to try to understand what you did and if I can make anything work I'll send a PR.

elahd commented 2 years ago

Hey -- my laundry room uses the Hercules CyclePay app, too, so this library has actually only been tested with an account created through that app.

What errors do you get when you run example.py? Also, try adding the following to your Home Assistant's configuration.yaml file (after installing the integration), then reboot.

logger:
  default: warn
  logs:
    custom_components.cyclepay: debug
    pylaundry: debug

That'll show detailed debug logs for both the HA integration and pylaundry in your HA logs.

funkymonkeymonk commented 2 years ago

I will follow the diagnostic steps and respond but I've been a bit busier than I expected. One thing that i wanted to point out was that I think we're talking about different Hercules CP apps. The app you mention in your README does not use the same credentials/login as this one that I have to use for my facility. I tried switching apps and I couldn't log in with the other using the same username and password.

Edit: Fixing markdown issues because I always forget proper linking syntax.

elahd commented 2 years ago

Got it. It looks like your laundry room uses payment systems made by Kiosoft while mine uses systems made by ESD. These manufacturers white label apps for Hercules that have confusingly similar names but entirely different backends.

If you're able to poke around the app to capture traffic, I can help integrate the new endpoint into the library.

funkymonkeymonk commented 2 years ago

Awesome thanks. this gives me an excuse to set up something that captures traffic on my home network anyway. 😈 Exactly what I needed another project.

I'll get back to you when I have something of value, it may be a bit.

Billyboii commented 4 months ago

Hey! Just finding this thread. I would also be interested in this as a feature, even if it ended up being it's own repo since it integrates with a different app. That being said I was just able to do some traffic capture on the Hercules CP Mobile app and while I can find requests for getting account balances and app information, I'm not seeing any information about the status of current washing/drying cycles. I have a feeling that this is just a timer/estimate stored locally in the app. I was able to confirm this by loading my account on another phone and seeing that the cycles did not carry over but all the account data did.