Skip to content

Reading the repo

Opening the box…

How to install OpenBafangTool on macOS (andrey-pr/OpenBafangTool) · gitmanual

How to install on macOS

andrey-pr/OpenBafangTool

Open-source e-bike service tool for Bafang (even with CAN!) - tune your bike (BBS01, BBS02, BBSHD, M500, M600 or any other)

Node.js#bafang#ebike

Difficulty: Easy
Time: about 5 min
Stars: ★ 257
Activity: Quiet for 1.5 years
License: MIT
Open issues: 21
Got it running: Be the first
Looked up: 10 h ago

Saved setup from 10 h ago

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Looks inactiveLast change 1.5 years ago. Fixes may not come. Latest release 2.2.2-rc, 2.2 years ago.
Can I trust it?: Some track record257 stars, 2 years old. Get it from the official repo and read what it installs.

Start here

Will it work on my device?

Yes, it runs on macOS

Apps are only published for Windows and Linux.
You'll build it yourself with Node.js.

Supported devices from the README: Supported Hardware

Display connector

All kinds of modern Bafang hardware with the CAN bus are supported:

All mid-drive motors, all hub motors with Bafang controller, all displays, and all digital torque sensors, as well as all kinds of motors with UART (but not displays with UART)

There are also Bafang motors made for Prophete, E-Novation, and Blaupunkt, but I haven't tried them yet.

Important notices:

Some devices have firmware with limited configurable parameters, and it does not depend on model. For example, I tested 3 absolutely idendical M420 mid-drive models, and two of them had all configurable parameters available, and one of them does not offer most of the parameters.
If you have a bike with a Bafang hub motor, check the brand of it's controller: Some bike manufacturers may install Bafang hub motors with third-party controllers. I can not support them.
Sub-brands usually also have branded motors from other manufacturers; some of those sub-branded models are non-bafang, so you need to search information right for model of your device.

Checking for

macOS Windows Linux

No macOS app in the box

No ready-made macOS app or install command in 2.2.2-rc. There are apps for Windows and Linux.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js LTS (no version pinned)runtime
1×npm package manager

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/andrey-pr/OpenBafangTool/badge.svg)](https://gitmanual.com/andrey-pr/OpenBafangTool)

Good to know

Nested projects: release/app/package.json

package.json scripts (12)

buildconcurrently "npm run build:main" "npm run build:renderer"
build:dllcross-env NODE_ENV=development TS_NODE_TRANSPILE_ONLY=true webpack --config ./.erb/configs/webpack.config.renderer.dev.dll.ts
build:maincross-env NODE_ENV=production TS_NODE_TRANSPILE_ONLY=true webpack --config ./.erb/configs/webpack.config.main.prod.ts
build:renderercross-env NODE_ENV=production TS_NODE_TRANSPILE_ONLY=true webpack --config ./.erb/configs/webpack.config.renderer.prod.ts
postinstallts-node .erb/scripts/check-native-dep.js && cd release/app && npm install && cd ../.. && npm run build:dll
lintcross-env NODE_ENV=development eslint . --ext .js,.jsx,.ts,.tsx
packagets-node ./.erb/scripts/clean.js dist && npm run build && electron-builder build && npm run build:dll
cleants-node ./.erb/scripts/clean.js dist
startts-node ./.erb/scripts/check-port-in-use.js && npm run start:renderer
start:maincross-env NODE_ENV=development electronmon -r ts-node/register/transpile-only .
start:renderercross-env NODE_ENV=development TS_NODE_TRANSPILE_ONLY=true webpack serve --config ./.erb/configs/webpack.config.renderer.dev.ts
testjest

Files we read (2)

README.md

package.json

Branch master · 152 files in the repo