How to use GitHub in a simple way as a non-dev to install apps

I spend now probably 2 hours trying to figure this out myself but neither SmartThings, nor this forum, nor youtube (and of course google) provide so far really easy to understand guidance… So lets try this awesome community :slight_smile:


  • have couple of smart things at home such as HUE, harmony remote, etc
  • bought SmartThings whilst waiting for some Xiaomi shipment
  • SmartThings hub/app (UK version) setup works (little bit buggy outside of available countries but got it working)
  • wanted to add this: [RELEASE] Xiaomi Sensors and Button (beta) and problems started :slight_smile:
  • created github account successfully


In regards to:

  1. is this guide relevant for non-developers at all?
  2. do I need to fork SmartThingsPublic or can I somehow use the main version? Do I need this btw at all?
  3. do I need to setup anything locally github wise or just work via my online github account?
  4. If I just want to add this [RELEASE] Xiaomi Sensors and Button (beta) how can I do it in the easiest way possible whilst still using github (so not copypasting code manually)?

I have to say that the overall experience outside of the in-app options is really bad in terms of user experience and guidance. You search this community, find a thread, all you get is a github link and from there you have to figure out what to do and how on your own :slight_smile:

Thanks for your help!

Does the developer of that device handler support the github integration? If not then everything else is irrelevant.

Edit: looks like from @anon36505037’s updated post that that github repo is supported with the IDE integration.

@anon36505037 thanks for the quick reply.

A) this link here didn´t do anything for me besides redirecting me to the community page:
Just as a test, I moved ahead anyways and enabled github via the top right button in the IDE. Adding afterwards the a4refillpad stuff worked.

How do I see if I am in the EU graph?

B) I added from repo and the device handlers but two are colored blue. “Indicates that the file exists in your GitHub repository, and has been modified in the IDE but not committed to the repository.”

I don´t get this since my github repository was before empty (deleted the old forked repo before). Also if I login to github after the above step, I don´t see anything in github.

Compare versions shows me btw that the original version has 2 empty rows at the end of the code, whilst my local one doesn´t. So doesn´t seem to be an issue, it´s still strange to have something blue after the initial update from repo…

C) Ok got it, there is nothing inside my own repository since I don´t have an own fork? So if I want to adjust the code (settings, etc) what will I need to do? Just edit in the IDE editor? What happens if there is a new version, how do I update whilst keeping any changes made?

Thanks so far guys, already happy that I got so far. Still waiting for Xiaomi shipment so can´t even test the hardware yet :slight_smile:

D) How do I get rid of the blue entries? Tried to click the “update” button but it didn´t help. Overwrite local version via editor?

Ok moved on and have new question :slight_smile:
How do I add a forked version or add the changes?

I want to add this to the a4refillpad original version: