Apply imported advanced EQ end-to-end (CLI --import-eq)

Confirmed activation chain on Ear (3): set bands (0xF041), select EQ
mode 4 (0xF010), enable advanced EQ (0xF04F). NothingController gains
apply_custom_eq(); CLI --import-eq decodes a Nothing X share code and
applies the full 8-band profile.

https://claude.ai/code/session_014KrpftzUgVFGFXVUU3DUTT

Author: claude

src/nothing_ear/app.py

@@ -52,6 +52,11 @@ def _build_parser() -> argparse.ArgumentParser:
         choices=["anc", "eq", "custom-eq", "advanced-eq", "battery", "firmware", "serial"],
         help="Read a setting from the device and print the raw response (no GUI).",
     )
+    parser.add_argument(
+        "--import-eq",
+        metavar="CODE",
+        help="Apply a Nothing X advanced EQ share code and exit (no GUI).",
+    )
     parser.add_argument(
         "--address",
         help="Device MAC address (auto-detected if omitted).",
@@ -110,6 +115,10 @@ def main() -> int:
         from .cli import cmd_read
 
         return cmd_read(args.address, args.read, args.channel)
+    if args.import_eq is not None:
+        from .cli import cmd_import_eq
+
+        return cmd_import_eq(args.address, args.import_eq, args.channel)
 
     return _run_gui(args.mock)
 

src/nothing_ear/bluetooth/protocol.py

@@ -31,6 +31,9 @@
 CMD_EQ = 0xF010
 CMD_CUSTOM_EQ = 0xF041
 CMD_CUSTOM_EQ_STATUS = 0xC044
+CMD_ADVANCED_EQ_ENABLED = 0xF04F
+
+EQ_MODE_CUSTOM = 0x04
 
 REQUEST_COMMANDS = {
     "anc": 0xC01E,
@@ -106,8 +109,16 @@ def anc_frame(mode: ANCMode, fsn: int = 0) -> bytes:
     return build_frame(CMD_ANC, bytes([0x01, _ANC_VALUE[mode], 0x00]), fsn)
 
 
+def eq_mode_frame(mode_value: int, fsn: int = 0) -> bytes:
+    return build_frame(CMD_EQ, bytes([mode_value, 0x00]), fsn)
+
+
 def eq_preset_frame(preset: EQPreset, fsn: int = 0) -> bytes:
-    return build_frame(CMD_EQ, bytes([_EQ_VALUE[preset], 0x00]), fsn)
+    return eq_mode_frame(_EQ_VALUE[preset], fsn)
+
+
+def advanced_eq_enable_frame(enabled: bool, fsn: int = 0) -> bytes:
+    return build_frame(CMD_ADVANCED_EQ_ENABLED, bytes([0x01 if enabled else 0x00]), fsn)
 
 
 def query_anc_frame(fsn: int = 0) -> bytes:
@@ -241,6 +252,11 @@ def query_raw(self, command: int, payload: bytes = b"") -> bytes:
     def set_custom_eq(self, bands) -> None:
         self.send_frame(custom_eq_frame(bands, self._next_fsn()))
 
+    def apply_custom_eq(self, bands) -> None:
+        self.send_frame(custom_eq_frame(bands, self._next_fsn()))
+        self.send_frame(eq_mode_frame(EQ_MODE_CUSTOM, self._next_fsn()))
+        self.send_frame(advanced_eq_enable_frame(True, self._next_fsn()))
+
     def get_custom_eq(self):
         resp = self.query_raw(CMD_CUSTOM_EQ_STATUS)
         return decode_custom_eq(frame_payload(resp))

src/nothing_ear/cli.py

@@ -108,6 +108,33 @@ def cmd_eq(address: str | None, preset: str, channel: int) -> int:
     return 0
 
 
+def cmd_import_eq(address: str | None, code: str, channel: int) -> int:
+    addr = _resolve_address(address)
+    if addr is None:
+        return 1
+
+    from .bluetooth.protocol import NothingController
+    from .bluetooth.share import decode_profile
+
+    try:
+        profile = decode_profile(code.strip())
+    except Exception as exc:
+        print(f"Could not decode EQ profile: {exc}")
+        return 1
+
+    try:
+        with NothingController(addr, channel=channel) as ctrl:
+            ctrl.apply_custom_eq(profile.bands)
+    except OSError as exc:
+        print(f"RFCOMM connection on channel {channel} failed: {exc}")
+        return 1
+
+    print(f"Applied '{profile.name}' ({len(profile.bands)} bands):")
+    for band in profile.bands:
+        print(f"  {band.frequency:8.0f} Hz  {band.gain:+5.1f} dB  Q {band.q:.2f}")
+    return 0
+
+
 def cmd_read(address: str | None, name: str, channel: int) -> int:
     addr = _resolve_address(address)
     if addr is None: