ETKx

BMW ETK (Electronic Parts Catalog) web viewer — modern SvelteKit frontend with Spring Boot backend.

• Java 21+ (backend)
• Node.js 20+ with pnpm (frontend)
• SQLite database file (etk.sqlite)

cd service

# Set database path
export SPRING_DATASOURCE_URL=jdbc:sqlite:/path/to/etk.sqlite

# Run
./gradlew bootRun

Backend API: http://localhost:8080

cd frontend
pnpm install
pnpm dev

Frontend: http://localhost:5173 (proxies API to :8080)

The original ETK uses Transbase. This section describes how to migrate to SQLite.

• Original ETK Transbase running (IP: 192.168.101.150, port: 2024)
• Java 11+ on host machine
• JDBC drivers:
  • tbjdbc.jar (Transbase) — from ETK installation
  • sqlite-jdbc-3.x.jar — download

cd scripts

# Download SQLite JDBC if not present
curl -LO https://github.com/xerial/sqlite-jdbc/releases/download/3.45.1.0/sqlite-jdbc-3.45.1.0.jar

# Compile migration tool
javac -cp tbjdbc.jar:sqlite-jdbc-3.45.1.0.jar TransbaseToSqlite.java

# Run migration (takes ~30-60 minutes for full DB)
java -Xmx2g -cp .:tbjdbc.jar:sqlite-jdbc-3.45.1.0.jar TransbaseToSqlite etk.sqlite

Edit TransbaseToSqlite.java to change connection settings:

static final String TB_URL = "jdbc:transbase://192.168.101.150:2024/etk_publ";
static final String TB_USER = "tbadmin";
static final String TB_PASS = "altabe";

• etk.sqlite — ~5GB SQLite database with all ETK data
• Tables: 116 tables including parts, diagrams, images, translations

# Place etk.sqlite in ./data/
docker-compose up --build

• Frontend: http://localhost:3000
• Backend: http://localhost:8080

etkx/
├── frontend/          # SvelteKit + Tailwind CSS
│   ├── src/
│   │   ├── lib/       # Components, API client, stores
│   │   └── routes/    # Pages (/{brand}/{productType}/{scope}/...)
│   └── package.json
├── service/           # Spring Boot backend
│   ├── src/main/java/pl/emdzej/etkx/
│   │   ├── api/       # REST controllers
│   │   └── dal/       # Data access layer
│   └── build.gradle
├── scripts/           # Migration and utility scripts
│   ├── TransbaseToSqlite.java
│   └── start-etk-original.sh
├── k8s/               # Kubernetes manifests
└── docs/              # Documentation

/{brand}/{productType}/{catalogScope}/vehicles/{mospId}/groups/{hg}/subgroups/{fg}/diagrams/{btnr}

To run the original BMW ETK application on macOS:

# Requires Java 8 and running Transbase
./scripts/start-etk-original.sh

See docs/original-etk-setup.md for full setup instructions.

The Right to Repair movement advocates for consumers' ability to fix the products they own — from electronics to vehicles — without being locked out by manufacturers through proprietary tools, paywalled documentation, or artificial restrictions.

I build these tools because I believe repair is a fundamental right, not a privilege.

Too often, service manuals, diagnostic software, and technical documentation are kept behind closed doors — unavailable to individuals even when they're willing to pay. This wasn't always the case. Products once shipped with schematics and repair guides as standard. The increasing complexity of modern technology doesn't change the fact that capable people exist who can — and should be allowed to — use that information.

These projects exist to preserve access to technical knowledge and ensure that owners aren't left at the mercy of vendors who may discontinue support, charge prohibitive fees, or simply refuse service.

If you find this project useful, consider buying me a coffee ☕ or sponsoring on GitHub or if it's your thing: via PayPal

Licensed under PolyForm Noncommercial 1.0.0 — free for personal and educational use, no commercial use permitted.