Skip to main content

Installation

Prerequisites​

  • Operating system: Windows 10/11, macOS 12+, or Linux (Ubuntu 20.04+)
  • Hardware: HMCLS device
  • Network: Ethernet connection — device and PC on the same subnet

Download​

Download the latest release for your platform from the project's releases page. Three package formats are available:

PlatformFormat
Windows.msi installer
macOS.dmg disk image
Linux.AppImage or .deb

Installation Steps​

Windows​

  1. Download the .msi installer.
  2. Double-click the file and follow the setup prompts.
  3. Launch HMCLS from the Start Menu.

macOS​

  1. Download the .dmg file.
  2. Open it and drag HMCLS to your Applications folder.
  3. On first launch, right-click the app and choose Open (required to bypass Gatekeeper on first run).

Linux​

AppImage:

chmod +x hmcls.AppImage
./hmcls.AppImage

Debian/Ubuntu package:

sudo dpkg -i hmcls.deb

Build from Source​

If you want to build from source, you need Node.js (v18+), Rust, and the Tauri prerequisites for your OS.

cd hmcls-app
npm install
npm run tauri build

The compiled binary appears in src-tauri/target/release/.

First Launch​

On first launch the app opens to the main dashboard and looks for a board on the network. If it finds exactly one, it connects by itself; otherwise open the Board window and pick or enter the address shown on the device screen. See Connecting to a Device to configure your network and connect.