Skip to content

LtBeer/Snowflake110-Configurator

Repository files navigation

Snowflake110 - Alpine A110 Configurator

Version: 0.1 beta

Snowflake110 Configurator is a desktop app for Alpine A110 owners. It connects through a wired USB OBD adapter, checks if the vehicle is ready, reads the current ECU configuration, applies selected changes, and verifies the result. There is also simple beta telemetry with CSV logging.

The app is designed for simple, reversible customisation rather than raw diagnostic hacking.

Disclaimer

This software can write configuration values to vehicle ECUs. Use it entirely at your own risk.

The author is not responsible for vehicle damage, failed writes, warning lights, diagnostic trouble codes, loss of functionality, or legal/regulatory issues. Keep the vehicle battery stable, follow the app instructions, save original values, change one setting at a time, and obey local laws.

Supported vehicles

Snowflake110 Configurator is intended for the Alpine A110 / XEF platform.

This version has only been tested on a Phase 1 / pre-facelift Alpine A110. Post-facelift cars may not be able to use all features because of the Renault Security Gateway. Those cars may require a security gateway bypass adapter; this still needs to be confirmed, tested, and documented in a future release.

Support may vary by model year, market, ECU software version, vehicle equipment, and security gateway configuration.

Recommended adapters

The recommended adapter is OBDLink EX. It is expensive, but it is the best option for this project because it is reliable, fast, and well suited to diagnostic traffic.

OBDLink SX is also a good wired USB option.

Generic wired USB ELM327 adapters may work, but they are very slow and not recommended. Avoid very cheap no-name clones where possible; many have poor timing, tiny buffers, fake firmware versions, or incomplete command support.

Bluetooth and WiFi adapters are not currently supported. They may be supported in the future, but wired USB is strongly preferred for ECU writes.

Features

main window

Snowflake110 Configurator includes connection checks, ECU identification, configuration backup/readback, feature customisation, cluster settings, and live telemetry. Feature and telemetry pages are visible before connecting, but their controls stay disabled until the app is connected to the car.

The main configurable features are folding mirrors, start-stop, parking brake when car off, keyless entry always active, daytime running lights, comfort flashers, and automatic interior lighting.

The cluster section supports distance units, volume units, temperature units, cluster language, and seatbelt warning sound/flashing configuration. Cluster changes use a separate apply step because the cluster has to reboot to apply staged config changes.

Telemetry is read-only. The first public build reads basic live values from the main OBD connection where available, including voltage, RPM, speed, coolant temperature and intake temperature. Additional Alpine-specific values will depend on ECU/CAN access and adapter support.

TPMS values may be unavailable or stale until the vehicle has been driven for a short while; they are still work in progress.

Requirements

To run from source, you need Python 3.10 or newer, Tkinter, pyserial, and a compatible wired USB OBD adapter. On Windows, Python from python.org normally includes Tkinter. On macOS, use the official Python installer if your system Python does not include it.

Install dependencies with:

python -m pip install -r requirements.txt

Running from source

Windows:

py -m venv .venv
.venv\Scripts\activate
py -m pip install --upgrade pip
py -m pip install -r requirements.txt
py run_configurator.py

macOS:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python run_configurator.py

Building standalone apps

PyInstaller cannot reliably cross-build. Build the Windows app on Windows and the macOS app on macOS.

Windows single-file EXE:

py -m venv .venv
.venv\Scripts\activate
py -m pip install --upgrade pip
py -m pip install -r requirements.txt
py -m pip install pyinstaller
py -m PyInstaller --onefile --windowed --name Snowflake110Configurator --icon snowflake110.ico --add-data "snowflake110.png;." --add-data "snowflake110.ico;." run_configurator.py

The output will be:

dist\Snowflake110Configurator.exe

macOS app bundle:

chmod +x build_mac_app.sh
./build_mac_app.sh

The output will be:

dist/Snowflake110Configurator.app

The macOS build uses snowflake110.icns for the Finder/Dock icon and writes logs to:

~/Library/Logs/Snowflake110Configurator/snowflake110_configurator.log

For public macOS distribution, Developer ID signing and notarisation are recommended. The build script performs only ad-hoc signing for local testing.

macOS Python / Tkinter note

The macOS build requires a Python installation with working Tkinter/Tk. The build script will try to find a suitable Python automatically. If needed, install the current universal2 macOS Python from python.org and rebuild with:

PYTHON_BIN=/Library/Frameworks/Python.framework/Versions/3.13/bin/python3 ./build_mac_app.sh

You can test Tkinter before building with:

/Library/Frameworks/Python.framework/Versions/3.13/bin/python3 -m tkinter

A small Tk window should appear. If it does not, that Python installation is not suitable for building this Tkinter app.

macOS icon cache note

If Finder still shows a generic icon after rebuilding, move the rebuilt .app to a new folder or rename it once. macOS can cache icons for an existing app path.

Basic usage

Connect the adapter to the car and computer, open the app, select the adapter or COM port, connect, wait for the status checks to pass, read current values, save the originals, change one setting, apply it, and verify readback.

For cluster changes, use the explicit cluster apply/reboot button and expect the cluster to restart.

Release downloads

Latest release downloads will be added on the Releases page.

Windows: Snowflake110Configurator.exe

macOS: Snowflake110Configurator-v0.1-beta-mac.dmg

If macOS blocks the app, open System Settings → Privacy & Security, find the Snowflake110 warning, then click Open Anyway; only do this if you downloaded it from the official Snowflake110 release page.

Roadmap

Future releases may add wider adapter support, more telemetry views, more compatibility checks, and additional Alpine A110 customisation features once tested. Bluetooth adapter support is a possibility.

Reporting issues and feature requests

Use the Issues tab to open a new issue.

When reporting an issue or requesting a feature, include the app version, operating system, adapter model, vehicle year, ECU or feature involved, what you tried, what happened, and the relevant log output.

Do not publicly post your VIN unless you intentionally want to share it.

Donations

The software is free to use and modify. It is a passion project - nonetheless, the hardware and tools needed were not exactly cheap, so if you would like to support the author, click the button below - thank you! :)

Buy Me A Coffee

License

Snowflake110 Configurator is source-available for non-commercial use under the PolyForm Noncommercial License 1.0.0.

You may use, modify, and share this software for non-commercial purposes, provided that the license terms and required notices are preserved.

Commercial use is not permitted without prior written permission. This includes resale, paid installation, bundling with paid products or services, or use as part of a commercial offering.

See LICENSE.md for the full license text.

About

Alpine A110 advanced configuration & telemetry app

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors