From e8cff1eae3e1da832d677b1feda0ff8c656225fc Mon Sep 17 00:00:00 2001 From: YusukeIt0 <213780070+YusukeIt0@users.noreply.github.com> Date: Sat, 24 Oct 2026 18:23:46 +0700 Subject: [PATCH 1/4] docs: keep setup guidance independent of interface languages --- README.md | 2 +- docs/localization.md | 7 ++++++- docs/setup.md | 14 +++++++------- 3 files changed, 14 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 5378f26..835f6eb 100644 --- a/README.md +++ b/README.md @@ -69,7 +69,7 @@ The app is not Apple-notarized: if macOS blocks the first launch, see [Open Anyw - **Hold to talk:** hold to speak on G2 and release to stop recording. - **Disable hold-to-record:** in **Operation settings**, enable this to ignore accidental long presses on the glasses (for example, with wet or sweaty controls). The choice is saved; the default keeps hold-to-record enabled. When enabled, use Hey XX or text input; the phone button cannot start manual recording either. Wake listening is not enabled automatically. Enabling this setting discards an ongoing manual recording. -- **Hey dot:** with Even app **0.3.1 or later**, open **Operation settings** in the phone companion and enable **Talk with Hey XX** (off by default). Say “Hey dot” in English or Japanese pronunciation, wait for **Go ahead** on G2, then speak. A short silence ends recording. Say the cue again for each new turn. In 0.3.4 or later, you can also enable **Change the name**, enter 1–24 ASCII letters, and save. Custom names use English pronunciation; Even, Siri and Meta are reserved. +- **Hey dot:** in the phone companion's **Operation settings**, enable **Talk with Hey XX** (off by default). Say “Hey dot”, wait for the recording prompt on G2, then speak. A short silence ends recording. Repeat the cue for each new turn. To use another name, enable **Change the name**, enter 1–24 ASCII letters, and save; Even, Siri and Meta are reserved. The wake phrase is independent of the interface language. - **Type:** write and send a message in the Even companion. With **Send after transcription** enabled, recognized speech is sent automatically; turn it off to review the text before sending. Check that your Dot's reply appears on G2. Keep Dot Link open on G2, the Mac awake, and both devices connected to Tailscale. diff --git a/docs/localization.md b/docs/localization.md index 990eee8..ae4aafd 100644 --- a/docs/localization.md +++ b/docs/localization.md @@ -1,7 +1,8 @@ # Application localization Application language is separate from conversation contents, speech recognition -and acoustic wake detection. English is the fallback. The Mac and Even applications support English, Japanese and Korean. +and acoustic wake detection. English is the fallback. See the README for +[supported interface languages](../README.md#make-it-yours). ## Resource contract @@ -84,6 +85,10 @@ and language switching. These require macOS; the update driver needs AppKit. tests and a browser preview do not establish physical display correctness. 4. Review relevant setup/privacy/release documents and actual artifact permissions. Public Git documentation and Even Hub listings remain English. + Add the native language name to the README's **Interface languages** list; + keep this as the single user-facing list rather than repeating languages or + per-language versions in setup instructions. Acoustic evidence and release + history remain specific to the behavior and versions actually tested. Record exact source/build and device results in the implementation PR. Acoustic wake model/keywords and STT provider configuration are outside UI diff --git a/docs/setup.md b/docs/setup.md index 09317ef..fb9654d 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -14,9 +14,8 @@ The installer checks the release checksum, app signature consistency and bundle Dot Link is not Apple-notarized. If macOS says it cannot verify the developer and you trust the download, dismiss the warning, then open **System Settings → Privacy & Security → Open Anyway**. Authenticate in the Mac dialog and choose **Open**. A warning that the app is damaged or will harm your computer is different; see [Apple's guidance](https://support.apple.com/en-us/102445). -The Mac app and Even companion support English, Japanese and Korean, initially -following the device language with English as the fallback. This guide uses the -English labels; each app lets you select another supported language. +This guide uses English labels. See [application language](#application-language) +to change the language in either app. ## Tailscale HTTPS setup @@ -108,7 +107,8 @@ Closing the Mac window keeps Dot Link running. **Pause** stops the relay and not ### Application language -Dot Link supports English, Japanese and Korean on Mac and in Even. Each app -initially follows its device language and lets you select a language in the -existing settings. The choice does not translate conversations or change -pairing, notification sharing, or speech-service configuration. +See the README for [supported interface languages](../README.md#make-it-yours). +Each app initially follows its device language, with English as the fallback, +and lets you select another supported language. The choice does not translate +conversations or change pairing, notification sharing, speech-service +configuration, or the wake phrase. From 7d1253529853845e4103973159f90b482c3fa541 Mon Sep 17 00:00:00 2001 From: YusukeIt0 <213780070+YusukeIt0@users.noreply.github.com> Date: Sat, 24 Oct 2026 18:26:27 +0700 Subject: [PATCH 2/4] docs: retain custom-name pronunciation guidance --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 835f6eb..2272f3a 100644 --- a/README.md +++ b/README.md @@ -69,7 +69,7 @@ The app is not Apple-notarized: if macOS blocks the first launch, see [Open Anyw - **Hold to talk:** hold to speak on G2 and release to stop recording. - **Disable hold-to-record:** in **Operation settings**, enable this to ignore accidental long presses on the glasses (for example, with wet or sweaty controls). The choice is saved; the default keeps hold-to-record enabled. When enabled, use Hey XX or text input; the phone button cannot start manual recording either. Wake listening is not enabled automatically. Enabling this setting discards an ongoing manual recording. -- **Hey dot:** in the phone companion's **Operation settings**, enable **Talk with Hey XX** (off by default). Say “Hey dot”, wait for the recording prompt on G2, then speak. A short silence ends recording. Repeat the cue for each new turn. To use another name, enable **Change the name**, enter 1–24 ASCII letters, and save; Even, Siri and Meta are reserved. The wake phrase is independent of the interface language. +- **Hey dot:** in the phone companion's **Operation settings**, enable **Talk with Hey XX** (off by default). Say “Hey dot”, wait for the recording prompt on G2, then speak. A short silence ends recording. Repeat the cue for each new turn. To use another name, enable **Change the name**, enter 1–24 ASCII letters, and save. Pronounce custom names in English; Even, Siri and Meta are reserved. The wake phrase is independent of the interface language. - **Type:** write and send a message in the Even companion. With **Send after transcription** enabled, recognized speech is sent automatically; turn it off to review the text before sending. Check that your Dot's reply appears on G2. Keep Dot Link open on G2, the Mac awake, and both devices connected to Tailscale. From 4bff18a18540cdeca3d0281e45dd0494f692d173 Mon Sep 17 00:00:00 2001 From: YusukeIt0 <213780070+YusukeIt0@users.noreply.github.com> Date: Sat, 24 Oct 2026 18:27:05 +0700 Subject: [PATCH 3/4] docs: keep pronunciation details in linked wake guide --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2272f3a..835f6eb 100644 --- a/README.md +++ b/README.md @@ -69,7 +69,7 @@ The app is not Apple-notarized: if macOS blocks the first launch, see [Open Anyw - **Hold to talk:** hold to speak on G2 and release to stop recording. - **Disable hold-to-record:** in **Operation settings**, enable this to ignore accidental long presses on the glasses (for example, with wet or sweaty controls). The choice is saved; the default keeps hold-to-record enabled. When enabled, use Hey XX or text input; the phone button cannot start manual recording either. Wake listening is not enabled automatically. Enabling this setting discards an ongoing manual recording. -- **Hey dot:** in the phone companion's **Operation settings**, enable **Talk with Hey XX** (off by default). Say “Hey dot”, wait for the recording prompt on G2, then speak. A short silence ends recording. Repeat the cue for each new turn. To use another name, enable **Change the name**, enter 1–24 ASCII letters, and save. Pronounce custom names in English; Even, Siri and Meta are reserved. The wake phrase is independent of the interface language. +- **Hey dot:** in the phone companion's **Operation settings**, enable **Talk with Hey XX** (off by default). Say “Hey dot”, wait for the recording prompt on G2, then speak. A short silence ends recording. Repeat the cue for each new turn. To use another name, enable **Change the name**, enter 1–24 ASCII letters, and save; Even, Siri and Meta are reserved. The wake phrase is independent of the interface language. - **Type:** write and send a message in the Even companion. With **Send after transcription** enabled, recognized speech is sent automatically; turn it off to review the text before sending. Check that your Dot's reply appears on G2. Keep Dot Link open on G2, the Mac awake, and both devices connected to Tailscale. From 70a6d25b0458d633b8bb9bddf2f4db18032f8ff0 Mon Sep 17 00:00:00 2001 From: YusukeIt0 <213780070+YusukeIt0@users.noreply.github.com> Date: Sat, 24 Oct 2026 18:28:12 +0700 Subject: [PATCH 4/4] docs: restore removed pronunciation sentence --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 835f6eb..2272f3a 100644 --- a/README.md +++ b/README.md @@ -69,7 +69,7 @@ The app is not Apple-notarized: if macOS blocks the first launch, see [Open Anyw - **Hold to talk:** hold to speak on G2 and release to stop recording. - **Disable hold-to-record:** in **Operation settings**, enable this to ignore accidental long presses on the glasses (for example, with wet or sweaty controls). The choice is saved; the default keeps hold-to-record enabled. When enabled, use Hey XX or text input; the phone button cannot start manual recording either. Wake listening is not enabled automatically. Enabling this setting discards an ongoing manual recording. -- **Hey dot:** in the phone companion's **Operation settings**, enable **Talk with Hey XX** (off by default). Say “Hey dot”, wait for the recording prompt on G2, then speak. A short silence ends recording. Repeat the cue for each new turn. To use another name, enable **Change the name**, enter 1–24 ASCII letters, and save; Even, Siri and Meta are reserved. The wake phrase is independent of the interface language. +- **Hey dot:** in the phone companion's **Operation settings**, enable **Talk with Hey XX** (off by default). Say “Hey dot”, wait for the recording prompt on G2, then speak. A short silence ends recording. Repeat the cue for each new turn. To use another name, enable **Change the name**, enter 1–24 ASCII letters, and save. Pronounce custom names in English; Even, Siri and Meta are reserved. The wake phrase is independent of the interface language. - **Type:** write and send a message in the Even companion. With **Send after transcription** enabled, recognized speech is sent automatically; turn it off to review the text before sending. Check that your Dot's reply appears on G2. Keep Dot Link open on G2, the Mac awake, and both devices connected to Tailscale.