Skip to content

Feature request: Keep keymaps in sync between two UHKs (home and office) #3058

Closed

Description

@yuh7

Hi! I own two UHK v2 keyboards, one at home and one at the office, and would like to keep their keymaps and layers consistent.

When I change a keymap or layer at home, I would like to have that change available on my office keyboard without manually exporting and importing the configuration each time.

Desired behavior

An opt-in way to share a configuration between two UHKs through Agent. Ideally, Agent would detect changes made on the other computer and offer to apply them to the connected keyboard. A confirmation step would be perfectly fine for my use case; fully automatic application is not essential.

Possible approach

One option might be to let users choose a shared configuration file or folder, synced between computers using a service of their choice. Agent could export changes there and offer to import updates when needed.

This is only a suggestion, and I’m open to other approaches. Conflicting changes and accidental overwrites would need to be handled carefully.

Related discussion

I found #1851 , which discusses configuration backups to Google Drive. My main use case is keeping two keyboards consistent, rather than backing up configurations.

Is there an existing recommended workflow or a plan for this use case? If not, would you be open to considering a feature along these lines?

I’d be happy to work on an implementation and submit a PR if we can agree on the general direction and scope first.

Thanks for your work on UHK and Agent!

Activity

  1. mondalaci commented on Sep 23, 2026

    @mondalaci
    Member

    Thanks for your suggestion!

    The easiest and most flexible way to implement this feature is to make the configuration file path configurable. This way, you could specify a Google Drive, Dropbox, OneDrive, or any other such path. Sounds good?

  2. yuh7 commented on Sep 28, 2026

    @yuh7
    Author

    Thanks, that sounds good to me!

    For my home/office setup, it would also be helpful if Agent could detect changes to the shared configuration file on startup or when a keyboard is connected, and ask whether to apply them to the keyboard.

    What do you think would be a reasonable initial scope: just making the configuration file path configurable, or also including change detection and a prompt to apply the configuration?

  3. added a commit that references this issue on Oct 5, 2026
  4. mondalaci commented on Oct 5, 2026

    @mondalaci
    Member

    Resolved by #3063

    The next Agent release will contain it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions