feat: add BLCVoice branding and Linux desktop identity

apps/desktop/src-tauri/icons/README.md

@@ -1,5 +1,14 @@
-# Bootstrap icon
+# BLCVoice application icon
 
-`icon.png` is a temporary, non-branding build asset required by Tauri's compile-time context generation.
+`app-icon.svg` is the canonical BLCVoice application icon source.
 
-It is **not** the final BLCVoice logo or visual identity. Product branding and the complete platform icon set will be designed and reviewed separately before distributable bundles are enabled.
+The generated platform assets are committed so Tauri bundle builds are deterministic and do not require icon-generation tooling:
+
+- `32x32.png` — Linux small icon
+- `128x128.png` — Linux standard icon
+- `128x128@2x.png` — Linux HiDPI icon
+- `icon.icns` — macOS
+- `icon.ico` — Windows
+- `icon.png` — high-resolution source/fallback asset used by local tooling
+
+The mark intentionally reuses BLCVoice's waveform visual language: a dark rounded-square field, violet voice bars, and a small local/private-state accent. Changes to the visual identity should start from `app-icon.svg` and regenerate the platform set rather than editing generated binaries independently.

apps/desktop/src-tauri/src/shortcut.rs

@@ -28,6 +28,7 @@ pub const SHORTCUT_DECISION_EVENT: &str = "blcvoice://shortcut-decision";
 enum ShortcutRegistrationState {
     Pending,
     Registering,
+    #[cfg(any(target_os = "linux", test))]
     ConfigurationRequired,
     Registered,
     Failed,
@@ -39,6 +40,7 @@ impl ShortcutRegistrationState {
         match self {
             Self::Pending => "pending",
             Self::Registering => "registering",
+            #[cfg(any(target_os = "linux", test))]
             Self::ConfigurationRequired => "configuration required",
             Self::Registered => "registered",
             Self::Failed => "failed",
@@ -102,6 +104,7 @@ impl ShortcutService {
         }
     }
 
+    #[cfg(any(target_os = "linux", test))]
     fn mark_configuration_required(&self) {
         let mut state = self.lock_state();
         if state.backend.is_some() {
@@ -380,6 +383,7 @@ fn shortcut_capability_for(state: &ShortcutServiceState) -> ShortcutCapabilityDt
         DesktopPlatform::Windows | DesktopPlatform::MacOs | DesktopPlatform::Other => None,
     };
     let registration_state = match state.registration_state {
+        #[cfg(any(target_os = "linux", test))]
         ShortcutRegistrationState::ConfigurationRequired => {
             "configuration required · KDE shortcut settings opened".to_owned()
         }

apps/desktop/src-tauri/tauri.conf.json

@@ -45,8 +45,12 @@
   "bundle": {
     "active": true,
     "targets": "all",
+    "category": "Productivity",
     "icon": [
-      "icons/icon.png",
+      "icons/32x32.png",
+      "icons/128x128.png",
+      "icons/128x128@2x.png",
+      "icons/icon.icns",
       "icons/icon.ico"
     ],
     "shortDescription": "Private local desktop voice dictation",

crates/blcvoice-insertion-eis/src/lib.rs

@@ -11,6 +11,7 @@ const EI_TEXT_MAX_UTF8_BYTES: usize = 254;
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 enum SubmissionMode {
     Text,
+    #[cfg(any(target_os = "linux", test))]
     ClipboardKeyboard,
 }
 
@@ -34,6 +35,7 @@ impl WaylandEisOptions {
 const fn capability_for_mode(mode: SubmissionMode) -> InsertionCapability {
     let backend = match mode {
         SubmissionMode::Text => InsertionBackend::XdgRemoteDesktopEis,
+        #[cfg(any(target_os = "linux", test))]
         SubmissionMode::ClipboardKeyboard => InsertionBackend::XdgRemoteDesktopEisClipboard,
     };
     InsertionCapability::new(backend, InsertionAuthorization::XdgRemoteDesktop)

scripts/install-local-linux.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "$(uname -s)" != "Linux" ]]; then
+  echo "BLCVoice local installer only supports Linux." >&2
+  exit 1
+fi
+
+repo_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"
+if [[ -z "$repo_root" ]]; then
+  echo "Run this script from inside the BLCVoice repository." >&2
+  exit 1
+fi
+
+cd "$repo_root"
+
+cargo build --release -p blcvoice-desktop
+
+binary_src="$repo_root/target/release/blcvoice"
+binary_dst="$HOME/.local/bin/blcvoice"
+applications_dir="$HOME/.local/share/applications"
+icons_root="$HOME/.local/share/icons/hicolor"
+icon_src="$repo_root/apps/desktop/src-tauri/icons"
+desktop_file="$applications_dir/blcvoice.desktop"
+
+install -Dm755 "$binary_src" "$binary_dst"
+install -Dm644 "$icon_src/32x32.png" "$icons_root/32x32/apps/blcvoice.png"
+install -Dm644 "$icon_src/128x128.png" "$icons_root/128x128/apps/blcvoice.png"
+install -Dm644 "$icon_src/128x128@2x.png" "$icons_root/256x256/apps/blcvoice.png"
+
+mkdir -p "$applications_dir"
+cat > "$desktop_file" <<EOF
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=BLCVoice
+GenericName=Voice Dictation
+Comment=Private local voice dictation that works where you type
+Exec=$binary_dst
+Icon=blcvoice
+Terminal=false
+Categories=AudioVideo;Audio;Utility;
+Keywords=voice;dictation;speech;transcription;whisper;
+StartupNotify=true
+StartupWMClass=blcvoice
+DBusActivatable=false
+EOF
+chmod 0644 "$desktop_file"
+
+if command -v update-desktop-database >/dev/null 2>&1; then
+  update-desktop-database "$applications_dir" >/dev/null 2>&1 || true
+fi
+if command -v gtk-update-icon-cache >/dev/null 2>&1; then
+  gtk-update-icon-cache -f -t "$HOME/.local/share/icons/hicolor" >/dev/null 2>&1 || true
+fi
+if command -v kbuildsycoca6 >/dev/null 2>&1; then
+  kbuildsycoca6 >/dev/null 2>&1 || true
+elif command -v kbuildsycoca5 >/dev/null 2>&1; then
+  kbuildsycoca5 >/dev/null 2>&1 || true
+fi
+
+echo "BLCVoice installed for this user."
+echo "Launcher: $desktop_file"
+echo "Binary:   $binary_dst"
+echo "Open BLCVoice from your application launcher instead of Konsole to validate desktop identity."