Start
Install on your computer
Choose the right download, verify it and handle first-launch prompts.
Hanterill is a desktop app for Windows, macOS and Linux. It runs on your computer. You do not need an account or an internet connection to use it with a vehicle.
Choose a download#
Open the download page and choose the file for your computer:
| Computer | File to choose | What to do |
|---|---|---|
| Windows | Setup installer or MSI | Open the downloaded file and follow the installer. |
| macOS | DMG for Apple Silicon or Intel | Open the file and drag Hanterill into Applications. |
| Linux | DEB, RPM, AppImage or archive | Choose the format you normally use for installing apps on your distribution. |
If you are unsure whether your Mac has Apple Silicon or Intel, open About This Mac from the Apple menu. Use the chip or processor shown there to choose the matching download.
Open the app for the first time#
Your computer may ask you to approve an app downloaded from the internet. Check that you selected the Hanterill file you intended to install before continuing.
macOS#
Open Applications, then open Hanterill. If macOS blocks it, open System Settings, go to Privacy & Security, and use the option to open Hanterill shown next to the warning. When Hanterill asks for permission to find devices on the local network, allow it so it can reach the car through the Ethernet cable.
Windows#
Open Hanterill from the Start menu after installation. Windows may show a security prompt when you first open it. Review the app name and choose the option to continue if it matches your download. The first time you look for a car, Windows Firewall may ask whether Hanterill can use the local network. Allow access for the network used by your wired adapter.
Linux#
Install the package that matches your distribution, then open Hanterill from your application menu. An AppImage is a portable file; your file manager may ask you to mark it as executable before it will open.
Linux: set up the Ethernet address#
Hanterill needs your wired adapter to have an IPv4 address in the 169.254.x.x range. On Ubuntu and other Linux systems, you may need to configure this yourself, even when the cable is connected and the link light blinks.
If Hanterill only shows lo / 127.0.0.1, it is showing your computer's internal loopback interface. Check the wired adapter's address using the steps below.
1. Find the wired adapter and check its address#
Plug in the cable and wake the car, then open a terminal:
ip -br linkLook for the wired adapter, often named enx…, enp… or eth0. The commands below use enx00e04c681f03 as an example. Replace it with your own adapter name each time; do not use lo or your Wi-Fi interface.
ip -4 addr show dev enx00e04c681f03Look for an inet 169.254.../16 line. If it is already there, select that adapter in Hanterill and choose Find vehicle. If there is no IPv4 address, use one of the two options below. If the link shows NO-CARRIER, check the cable and wake the car first.
2. Save the setting with NetworkManager#
These commands apply to systems managed by NetworkManager, including many Ubuntu desktop installations. Find the connection profile attached to your wired adapter:
nmcli -f NAME,DEVICE connection showThe profile name and adapter name are different things. Replace Wired connection 1 below with the profile name from the NAME column for your wired adapter:
nmcli connection modify "Wired connection 1" ipv4.method link-local ipv6.method link-local
nmcli connection up "Wired connection 1"If NetworkManager reports insufficient permissions, repeat the command with sudo. If nmcli is unavailable or NetworkManager is not running, use your distribution's network settings to select IPv4 Link-Local Only, or use the temporary option below.
The setting stays in this profile for future car connections. If you also use the profile for a home or office network, record its original settings before changing them and restore them afterwards. If both IPv4 and IPv6 originally used automatic addressing, restore them with:
nmcli connection modify "Wired connection 1" ipv4.method auto ipv6.method auto
nmcli connection up "Wired connection 1"Alternative: add an address for a test session#
To test the connection without editing a saved profile, add a temporary address:
sudo ip addr add 169.254.10.10/16 dev enx00e04c681f03Use this only on the adapter connected directly to the car, and only if that address is not already in use on the link. This is temporary; it is not saved across reboots and your network manager may remove it when reconnecting. To remove it yourself:
sudo ip addr del 169.254.10.10/16 dev enx00e04c681f033. Verify and connect#
Run ip -4 addr show dev enx00e04c681f03 again and confirm an inet 169.254.../16 line appears. Return to Hanterill's Connection screen, refresh the adapter list if needed, select the wired adapter and choose Find vehicle.
If the address is present but the car still does not answer, continue with Troubleshooting. This setup gives the computer a suitable network address; check Supported vehicles for what Hanterill can read from your model.
For the network settings used here, see the NetworkManager IPv4 reference and nmcli manual.
Check that installation worked#
Open the Connection screen. With no car plugged in you should still see your wired Ethernet adapters listed with a plain-language verdict for each (Wi-Fi and virtual adapters are filtered out), and a Link down style status while nothing is connected to the cable. That means the app is installed correctly and can see your network hardware.
When you are ready to connect a car, follow Getting started. If the car does not appear, use Troubleshooting.