HPM - Need help to add driver I created

[albertjmulder]

So I am a newbie and created 2 drivers with the help of GPTChat and want to publish the drivers so they are available in HPM, I tried to go through the readme and such but got completely lost.

Can someone help me out. Can you list all the files I need to have and link me to your files you made so I can use them as an example.

I seen stuff about Master Manifest, Intermediate Manifest, Package Manifest, Bundle Manifest, and file.js

Stuff about ID number for the drivers, Categories, Tags

just lost, seems like the info is a bit scattered and not newbe friendly.

I kind get github so that part I belive we can skip, just need to know what files I need and where they belong

[sburke781]

Tagging @csteele as an "interested party"

The up-shot is that if you have found the documentation or info hard to follow, then it would be good to share more details about where/how you tried to work out what to do, so it can be improved for other new users.

For those considering including their creations in HPM, see the main HPM topic on the Community:

[RELEASE] Hubitat Package Manager (HPM) -- HubitatCommunity

A v1.9.3 version has been pushed to HubitatCommunity, improved displayHeader to include the Main Menu Option selected refactored delete app to use new endpoint I've created a Video that shows the step by step on an Empty hub. I wiped one of my hubs and show the Installation of Hubitat Package Manager and then using it for the first and second time. HPM Installation - First Time Users In order to save some space, the video moves at a rapid pace. Use the browser's speed control OR the Pause…

My general understanding is:

• You setup a repository JSON file that lists out each of your drivers / apps with links to their manifests
• In GitHub you create a fork of the HPM repository and update the HPM setup to include your repository, creating a Pull Request as a way of requesting inclusion of your repository in HPM
• Your package manifest(s) (one for each driver or app you create) includes key info like the version number, release notes and list of files included

If you want a ( questionable ) example, you can look at my repository and linked package manifests, but others may be more aligned to the... better practices.... that should be followed.

Repository - hubitat/repository.json at master · sburke781/hubitat · GitHub
Simple Driver Examples:

• Mitsubishi (Unified) Thermostat Driver - hubitat/UnifiedThermostat/packageManifest.json at master · sburke781/hubitat · GitHub
• EcoWitt Manifest - ecowitt/packageManifest.json at main · sburke781/ecowitt · GitHub

Bundle and Non-Code File Example

• Mobile Controller - MobileController/hubitat/packageManifest.json at master · sburke781/MobileController · GitHub

There are utilities for simplifying the process, but early on I opted just to take an example and tweak the id's a bit each time, plus other relevant information.

[thebearmay]

From another thread:

Help for newbe who wants to put a custom device driver into the public domain

I would suggest you 'start from the end." Create the PackageManifest.json first. (Call it anything, but PackageManifest is common.) It's the json that tells HPM what you define as the package. Might be one file, might be a hundred, split between driver code, app code, files and bundles. Put that file adjacent to your source code. That provides you the Location you will need for the next file: repository.json or repo.json. Anything you want to name it, but a variation of repo is c…

[csteele]

Were you successful at creating the JSON files? I haven't seen a request to update the Master Repository with those two lines identifying yourself and the location of your manifests.

Example:

  {
  	"name": "LinptechES1",
  	"location": "https://raw.githubusercontent.com/csteele-PD/Hubitat-public/master/linptechRepo.json"
  },

Creating a Pull Request (PR) is too much Git'ish'ness in my opinion, so I do accept requests here too. Just send me your two lines as a PM (private message) and I'll react to it.

[albertjmulder]

I have not had a chance to get back to checking this out. My dog got very sick so i have been tending to her care. Have another vet apointment monday.

But when i get time i will.

[thebearmay]

Sounds like your priorities are right. Holler if you get stuck.