Installation

Prerequisites

Before installing SiFi Bridge, ensure you have:

• Hardware: A SiFi Labs device
• Operating System: Linux (Ubuntu 22.04+, x86 or arm64), macOS (Intel or Apple Silicon), or Windows (x86)
• Bluetooth Low Energy (BLE) 5.0+

Installation

Install script

The easiest way of installing sifibridge is to use the installation script from the repository.

Windows

Open PowerShell and run:

irm https://raw.githubusercontent.com/SiFiLabs/sifi-bridge-pub/main/scripts/install.ps1 | iex

By default, sifibridge is installed in your user directory at $env:LOCALAPPDATA\Programs\SiFiBridge.

warning

The script does not add sifibridge to PATH. To do so, follow the instructions in the terminal. You may have to restart the terminal for changes to take effect.

macOS / Linux

Open a terminal and run:

curl -fsSL https://raw.githubusercontent.com/SiFiLabs/sifi-bridge-pub/main/scripts/install.sh | bash

By default, sifibridge is installed in your user directory at ~/.local/bin/sifibridge.

MacOS security permissions

On MacOS, you may need to allow SiFi Bridge in Security & Privacy settings. See here for more details.

Manual install

It is also possible to manually install sifibridge.

Windows

1. Download the latest release from the Releases page
2. Extract the .zip archive to a convenient location
3. Move the binary where most appropriate, such as %LOCALAPPDATA%\Programs\SiFiBridge or C:\Program Files\SiFiBridge
4. Add the directory to your PATH if needed

macOS / Linux

1. Download the latest release for your platform from the Releases page
2. Extract the .tar.gz archive to a convenient location
3. Move the binary where most appropriate, such as ~/.local/bin or /usr/local/bin
4. Make it executable: chmod +x sifibridge
5. Add the directory to your PATH if needed

Verify Installation

Once installed, verify that SiFi Bridge is working:

$ sifibridge --version
sifibridge 2.0.0

You should see the version number displayed.

Uninstall

Simply delete the executable file.

Troubleshooting

Unable to launch executable

Windows

Problem: sifibridge : The term 'sifibridge' is not recognized as the name of a cmdlet, ...

Solution: Add sifibridge to your Path variable.

1. Press the Windows Key to open the search bar.
2. Type environment into the search bar.
3. Select Edit the system environment variables from the results.
4. In the System Properties window that opens, click the Environment Variables... button at the bottom.
5. Find Path in the list of environment variables and click Browse...
6. Navigate to your user -> AppData -> Local -> Programs -> SiFiBridge. Press OK.

You may need to relaunch PowerShell. Now, sifibridge should work.

macOS / Linux

Problem: sifibridge: command not found

Solution: Add ~/.local/bin to your PATH variable.

Refer to your shell's documentation on how to add a directory to PATH. For bash:

echo 'export PATH="${PATH}:${HOME}/.local/bin"' >> ~/.bashrc
source ~/.bashrc

You may need to restart your terminal. Now, sifibridge should work.

Permission denied on Linux/macOS

Problem: Permission denied when running the executable

Solution: Make the file executable:

chmod +x ~/.local/bin/sifibridge

macOS security warning

Problem: "sifibridge cannot be opened because the developer cannot be verified"

Solution: Allow the app in System Preferences:

1. Go to System Preferences → Security & Privacy
2. Click "Open Anyway" next to the sifibridge warning
3. Or use: xattr -d com.apple.quarantine sifibridge

Bluetooth not working

Problem: Cannot detect devices via Bluetooth

Solution:

• Ensure Bluetooth is enabled on your system
• Check that your Bluetooth adapter is recognized
• Run sifibridge scan to test device discovery