Problem: Architecture mismatch (ARM devices like Orange Pi) —— Trove problem library

What you will run into

On ARM devices (Orange Pi etc.), installing the x86_64 package reports an architecture error, or you download the arm package and the GUI won't start.

The official release actually covers amd64/arm64 and other platforms (19 assets); the problem is usually not picking the asset by architecture, or the lightweight ARM system missing desktop libraries.

Why this happens

• Wrong architecture installed: dpkg -i rejects mismatched architectures outright (wrong architecture);
• Right arm64 package but GUI won't start: some lightweight ARM systems (no desktop / minimal distro) lack desktop libraries like GTK - the same dependency issue as symptom 1.

This error actually contains two independent checks, layer by layer: first, dpkg's architecture gate — a deb package carries an Architecture field in its metadata, and dpkg -i compares it with the system's dpkg --print-architecture, rejecting mismatches outright (wrong architecture).

This is a deliberate Debian-family design to keep wrong packages from breaking your system, so this error means you grabbed the wrong asset.

Second, dynamic-link dependencies — even with the right architecture, a GUI that won't start usually means missing desktop libraries like GTK/webkit2gtk.

The key difference: apt install ./xxx.deb resolves and pulls dependencies automatically, while bare dpkg -i does not. So "check the architecture first + install with apt" — both steps are required.

Step by step

1. Pick the right architecture asset — Required

uname -m

x86_64 -> amd64 asset; aarch64 -> arm64 asset. Filter the asset page by Architecture (x86_64 / arm64 / win / mac).

2. Install the arm64 package on an ARM desktop system — Required

sudo apt install ./cc-switch_arm64.deb

apt pulls the GUI dependencies automatically (libwebkit2gtk etc.).

3. No desktop environment — Required

Not recommended to install the GUI form; consider a CLI alternative (e.g. edit ~/.claude.json directly to switch).

How to confirm it works

cc-switch --version

Version prints and the GUI starts = success (AMD measured: package structure is ELF x86-64 31MB, install verification passed).

Other environments

Symptom

On ARM devices (Orange Pi etc.), installing the x86_64 package reports an architecture error, or the GUI won't start after downloading the arm package (GTK issue).

Cause

The official 19 assets cover amd64/arm64 and other platforms; dpkg outright rejects a wrong-architecture package (wrong architecture); some lightweight ARM systems lack desktop libraries.

Solution

1. Pick the right architecture asset (filter the asset page by Architecture: x86_64 / arm64 / win / mac).
2. On ARM desktop systems install the arm64 package + matching GUI dependencies (same apt method as symptom 1).
3. On devices without a desktop environment, don't install the GUI form (consider a CLI alternative).