[RELEASE] Lock User Management (LUM)

This application appears to have a multitude of functions for locks and I have been debating if it will meet my use case. I am trying to obtain some additional information regarding the capability of this application to control some of the settings of the Schlage Z-Wave Connect Century (BE469).

Can this application allow the disabling and enabling of the Lock and Leave setting based on user codes entered onto the keypad?

Example: Having a guest code inputted turns on a guest mode for the home and disables lock and leave so that when the guest leaves they have to input the code again (Not simply hit the Schlage button on outside) to lock the door. The code being input again by the guest would turn off guest mode and re-enable lock and leave setting.

@rboy @maddie Could I request a bit more flexibility with the ADT Panel be added into the lock/unlock actions?

I have a webcore piston that automatically sets the location mode to away/home and either locks or unlocks the door based on presence. When this piston fires, the app views the lock method as manual. This is causing issues in this scenario because the only option to arm from a manual lock entry is armStay. I’d still like to keep the option to have armStay on a manual lock so that when I’d turn the lock from inside it would armStay.

I think the way to accomplish this would be to have the option of “When in modes XYZ, armAway” and “When in modes ABC, armStay” and “When in modes LMN, do nothing”. I could build this out through a webcore piston to accomplish what I need, but I think this could be a valuable option for all users.

@RBoy does this mean you’re can integrate your paid code into GitHub? That would be so awesome!



Doubtful - GitHub Free is for noncommercial (read: unpaid) personal ventures. It would definitely be a violation of the ToS for that kind of account. GitHub Enterprise might work, depending on the security model but I dont know how much that license would be or if it would be commercially viable for thier company… In either case, unsure if ST can/would support logging into a secured GitHub Repo to pull - which is what they’d need to make this successful in ANY licensing model.


@RBoy @maddie @tonesto7 I want to start by saying thank you for your amazing and relentless work, dedication and support offered to the ST community. Also big thanks and appreciation for @JDRoberts for being one of the greatest helpers around.

I want to kindly ask for your help regarding notifications with a Z-wave Yale nexTouch lock. Here’s what I have:

  • Amazon Echo gen 1

  • Yale Lock nexTouch with Door Position Sensor

  • DTH - Universal Z-Wave Lock With Alarms

  • App - Lock User Management

  • ST Classic app (Hub v2)

  • Echo Speaks by @tonesto7

  • Landroid

I want to have automatically played personalized notifications when a certain person unlocks the door, via Echo Speaks or Landroid or webcore.

Example: When the door is unlocked by John that has his own 4 digit pin assigned, the Amazon Echo to say “Hello John, welcome home!” And when the door is unlocked by someone else to have Amazon Echo speak that person’s name in the announcement. So when Jane comes home and unlocks the door, the Echo to say “Hello Jane, welcome home!”

I am attaching screenshots to show that the play notifications option is grayed out and can’t click on it. Maybe I am missing something, could please anyone help me with this?

My understanding is that this smartapp can turn on a switch when a particular user code is used. Is that correct?

  • Turning on/off switches when a user successfully unlocks a door (configurable per door)

If that’s so, you can do your notifications much more simply now that Amazon has created the equivalent of text to speech for their routines. :sunglasses:

You will create a virtual contact sensor which also has capability switch. That way when you use any smartapp to turn on the switch, the sensor will automatically show as open. Turn off the switch, and the sensor will show as closed. This will look like two different devices to Both SmartThings and Alexa, but they will automatically be linked.

You will then use the Amazon Alexa app to create an Amazon routine (not a smartthings routine) which will be triggered when the virtual contact sensor is open. And you can have your echo devices speak whatever you want to have them speak, either just one of them or multiples.

So you won’t need webcore or LANnouncer or Echo Speaks. Just the virtual device, a simple Amazon routine, and the app from this thread to turn the switch on when a specific user code is entered. :sunglasses:

See the FAQ:



Yes, it can turn on and off a switch and more, but I want to use it as a personalized announcement to an Echo Speaker. I wanna be able to select a speaker from the LUM notification options.

Did you read the FAQ I linked to? That’s all you need, is a switch to go on. Each switch can trigger one echo routine. Each echo routine can speak one custom phrase, but on as many of your echo devices as you like.

If you’d rather do it some other way, hopefully the other people will be able to help you.


Yes, I understand that, but how alexa can know the name of the person that unlocks the door (by the code)? This information is in the Lock User Management

You have to just type it into your custom phrase.

So your Amazon routine becomes

If sensor A is open, then say “welcome home, Jane.”

And your smartthings logic is: when Jane’s user code is entered into the lock, turn on switch A ( which automatically makes sensor A look like it is open)

And then you have a different Amazon routine

If sensor B is open, then say “welcome home, John.”

And your smart things logic is: when John’s user code is entered into the lock, turn on switch B (which automatically makes sensor B look like it is open)

So you have one virtual device and one Amazon routine for each custom phrase.

It’s easy to do, but it might be more tedious to set up than something that lets you use variables.


Thanks a lot for your quick response. The solution you proposed it works, but the thing is I have many user names stored (wife, kids, grandparents, friends, etc) and I think it will be a little tricky to have your proposed set up. I’d like to just keep it simple and have the option from LUM.

1 Like

To use the setup with the virtual switches, you would essentially need to create a switch and an amazon routine for each user stored in your lock. This could be 10 or 15 virtual switches and routines. It would be much simpler to be able to select the Echo speaker through the lock app and be done with it.

I believe I saw over on the Echo Speaks thread that Rboy submitted a patch to allow this to happen. If it get’s integrated then I’d expect to see this capability on the next Echo Speaks version.

For now I’m using webCoRe to accomplish this based on the user code that’s input.


Now works, Thanks to @RBoy and @tonesto7 But I cannot personalize…

@MRobi Can you share the WebCoRe piston, please!

Here you go. This disarms the ADT alarm system, announces the user name of the code used, and also texts/push notification to the wife and I. Code 1 and 2 are ours, 3 through 5 are various visitors who may have access while we are away (ie: on vacation).



I have just installed a Keyless Connected Yale Smartlock (YD-01-CON-NOMOD-CH) and connected it to Smartthings via the Z-Wave Module 2.

I has been working fine using the default Smartthings device handler and Smart Lock modules and I could add and remove user pins via the Smartthings app. However I wanted to be able to receive mobile notifications on who unlocked the door. I tried using the some automation in the Smart Home Monitor but the only notification I could get it to send was “The Front Door is unlocked”, ie it didn’t say who had unlocked the door even though the history in the Smart Locks would show “Front Door Lock – Unlocked by “<user>””.

I came across the RBoys Apps and though this might solve the problem. I paid for the apps and installed the “Universal Enhanced Z-Wave Lock” device handler successfully but when I installed the “Lock User Management” Smart App it crashed and asked me to contact the developer. Unfortunately I didn’t catch the error message at the time and now if I try to start the LUM it immediately exits without any messages.

I am fairly new to SmartThings but in the IDE Logs I can see these messages

1:51:47 PM: error java.lang.NullPointerException: Cannot get property ‘1’ on null object @line 3478 (codeCheck)
1:51:47 PM: warn Heartbeat not called in last 15 minutes, rescheduling heartbeat
1:51:47 PM: trace The date/time on the hub now is Sun Jan 13 2019 13:51 GMT
1:51:44 PM: debug cmd: MeterReport(scale2: false, scale: 2, rateType: 1, precision: 1, meterValue: [0, 0], deltaTime: 0, meterType: 1, size: 2, scaledPreviousMeterValue: 0.0, scaledMeterValue: 0.0, previousMeterValue: [0, 0])
1:51:02 PM: error java.lang.ClassCastException
1:51:02 PM: trace state.previousMaxUserNames: 10, maxUserNames: 10
1:51:02 PM: trace Configured lock fixed code length: null, max code length: 8, min code length: 4
1:51:02 PM: trace [locks:[Front Door Lock], updateNotifications:true, detailedNotifications:false, maxUserNames:10, sendDelay:15, retries:5]

Anybody any idea what I am doing wrong?

I am based in the UK if it makes any difference

Thanks in advance for any help


1 Like

Looks like the app/settings are corrupted or not saved properly. One option is to Uninstall it from the IDE from under My Locations -> SmartApps link next to your location name and then reinstall it from the ST mobile app.

This can happen if you have made changes to the users and locks but did not tap Save at the end (probably pressed Back).

The other option is you can update your code to todays version. It has a check for this situation and will automatically reinitialize the app when it detects an unsaved/uninitialized change made to the settings. You don’t need to reinstall the app if you update to this version. It should automatically detect the unsaved settings/corruption and fix them within a few minutes.

I uninstalled following your instructions and reinstalled and that fixed the problem. I have now updated to the new version as well. Thanks very much. I think that is the quickest fix and release I have ever seen :slight_smile:

One thing I have noticed over the default Smartthings Smart Lock module is that the users pin codes are visible after they are saved. Is there a way to hide these as some of my users don’t want me to know their pin codes?

Thanks very much

1 Like

The purpose of this app is allow the administrator (SmartThings app owner) to see and change the pins for users. The basic version of this app (which behaves like the stock SmartLocks app) does not show the pin but then there is no way to recall a pin, know who is using what pin, check if there are pin conflicts etc which are handy tools when managing more than one or two users.
When you start creating multiple scheduled users, presence based users and other advanced features of users and actions it helps to be able to see and change the pin assigned to users. For example, if you have two users with the same pin, the app will notify you and ask you to change it because it will create havoc with the lock and may even cause a malfunction with certain lock models if multiple users have the same pin. Lots of built in scenarios like this which are handled by the app so that your users have a smooth experience.


I just installed BigTalker 2.
I found how to play the Door unlock/locked notifications through BigTalker “Front door has been unlocked”.

Is it possible to modify this message?
It would be nice if it said “Welcome Home Mitch” (or whoever the user who unlocked it is).


1 Like

I am looking for the same… will be awesome if @RBoy can integrate a option like in BigTalker 2.

1 Like