Settings
Describes Hatoba 0.2.0.
Open Settings with the gear in the sidebar header or with Ctrl+, (⌘, on macOS). It is a window over the app with seven tabs. Changes apply at once; there is no Save button. Esc or the close button closes it. Terminal settings are in Terminal and AI settings in Settings → AI.
| English | 简体中文 | 日本語 |
|---|---|---|
| Settings | 设置 | 設定 |
| General | 通用 | 一般 |
| Appearance | 外观 | 外観 |
| Terminal | 终端 | ターミナル |
| Proxies | 代理 | プロキシ |
| Security | 安全 | セキュリティ |
| AI | AI | AI |
| About | 关于 | 情報 |
General
| English | 简体中文 | 日本語 |
|---|---|---|
| Right-Click in Terminal | 终端中的右键 | ターミナルでの右クリック |
| Copy if selected, otherwise paste | 有选中则复制，否则粘贴 | 選択があればコピー、なければ貼り付け |
| Show context menu | 弹出菜单 | コンテキストメニューを表示 |
| Confirm before pasting multiple lines | 粘贴多行文本前确认 | 複数行を貼り付ける前に確認 |
| Show host reachability | 显示主机在线状态 | ホストの接続状態を表示 |
| Refresh interval | 刷新间隔 | 更新間隔 |
| Export Encrypted Backup | 导出加密备份 | 暗号化バックアップをエクスポート |
| Export… | 导出… | エクスポート… |
- Right-Click in Terminal: Copy if selected, otherwise paste (default, except on macOS) or Show context menu (default on macOS).
- Confirm before pasting multiple lines: on by default. Pasting text that contains line breaks shows a preview first.
- Show host reachability: on by default. Every 60 seconds Hatoba tries a TCP connection to the hosts in the list (no login) and colors the dot. A host with a proxy is tried through it, and counts as reachable once its SSH server answers.
- Refresh interval (3 s by default) and the three thresholds below it (CPU, memory and disk use, 90% by default, or Off) belong to the dashboard; see Dashboard.
- Export Encrypted Backup → Export…: saves the vault as one file that only the master password opens. There is no import in the app.
Appearance
| English | 简体中文 | 日本語 |
|---|---|---|
| Light | 浅色 | ライト |
| Dark | 深色 | ダーク |
| Auto | 跟随系统 | システムに合わせる |
| Terminal Colors | 终端配色 | ターミナルの配色 |
| Always Dark | 始终深色 | 常にダーク |
| Match Appearance | 跟随外观 | 外観に合わせる |
| List Density | 列表密度 | リストの密度 |
| Regular | 标准 | 標準 |
| Compact | 紧凑 | コンパクト |
| Language | 语言 | 言語 |
| System Default | 跟随系统 | システムの設定 |
| 简体中文 | 简体中文 | 简体中文 |
| English | English | English |
| 日本語 | 日本語 | 日本語 |
- Appearance: Light, Dark, or Auto (follows the system and changes live).
- Terminal Colors: Always Dark (default) or Match Appearance.
- List Density: Regular or Compact rows in lists.
- Language: System Default (the system language if it is Chinese, Japanese or English, otherwise English), 简体中文, English or 日本語. It takes effect immediately. Host names, commands and terminal output are never translated.
Proxies
SOCKS5 and HTTP proxies that hosts connect through. Choosing one for a host is in Hosts and connecting.
- Default proxy on this device: No proxy or a saved proxy. Hosts whose proxy is Device default, and quick connections, use it. The choice stays on this device and does not sync, so a proxy that runs on this computer (such as Clash on 127.0.0.1) can be the default here and not on the others.
- Saved Proxies lists each proxy with its type, address and the number of hosts that name it; the device’s default has a Default badge. Click a row to edit it; the trash icon deletes it after showing which hosts switch to the device default. Proxies sync with their usernames and passwords, encrypted like the rest of the vault.
- Add Proxy asks for Name, Type (SOCKS5 or HTTP; an HTTP proxy must support CONNECT), Address and Port, and a Username and Password when the proxy needs a sign-in. Pasting a proxy URL such as
socks5://127.0.0.1:7890orhttp://user:[email protected]:3128into Address fills in the other fields. A saved password shows Saved and can be replaced but not viewed. SOCKS5 and HTTP send the proxy’s username and password to the proxy in the clear.
| English | 简体中文 | 日本語 |
|---|---|---|
| Default proxy on this device | 这台设备的默认代理 | このデバイスの既定のプロキシ |
| No proxy | 不使用代理 | プロキシなし |
| Saved Proxies | 已保存的代理 | 保存したプロキシ |
| Add Proxy | 添加代理 | プロキシを追加 |
| Edit Proxy | 编辑代理 | プロキシを編集 |
| Type | 类型 | 種類 |
| Default | 默认 | 既定 |
Security
| English | 简体中文 | 日本語 |
|---|---|---|
| Auto-Lock | 自动锁定 | 自動ロック |
| Lock when the computer sleeps | 电脑睡眠时锁定 | コンピュータのスリープ時にロック |
| Disconnect all sessions when locked | 锁定时断开所有会话 | ロック時にすべてのセッションを切断 |
| Clear Clipboard | 清除剪贴板 | クリップボードの消去 |
| Unlock with Windows Hello | 使用 Windows Hello 解锁 | Windows Hello でロック解除 |
| Master Password | 主密码 | マスターパスワード |
| Change… | 更改主密码… | 変更… |
| Recovery Code | 恢复码 | リカバリーコード |
| Generate New Code… | 生成新的恢复码… | 新しいコードを生成… |
| Lock Now | 立即锁定 | 今すぐロック |
| Lock | 锁定 | ロック |
Auto-Lock (default 15 minutes, up to 8 hours or Never), Lock when the computer sleeps (on by default), Disconnect all sessions when locked (off by default), Clear Clipboard for copied host passwords (default 90 seconds), Unlock with Windows Hello (Windows only), the master password, the recovery code, and Lock Now. Details are in Keys, vault and lock.
About
| English | 简体中文 | 日本語 |
|---|---|---|
| Software Update | 软件更新 | ソフトウェアアップデート |
| Check for Updates | 检查更新 | アップデートを確認 |
| Download and Install | 下载并安装 | ダウンロードしてインストール |
| Install and Restart | 安装并重启 | インストールして再起動 |
| View on GitHub | 在 GitHub 上查看 | GitHub で見る |
| Automatically check for updates at startup | 启动时自动检查更新 | 起動時にアップデートを自動で確認 |
| Checking… | 正在检查… | 確認しています… |
| Hatoba is up to date. | 已是最新版本。 | 最新バージョンです。 |
| Copy version | 复制版本号 | バージョンをコピー |
| Website | 官网 | Web サイト |
| Source Code | 源代码 | ソースコード |
| MIT License | MIT 许可证 | MIT ライセンス |
| Report a Problem | 反馈问题 | 問題を報告 |
| Settings (update available) | 设置（有新版本） | 設定（アップデートあり） |
| Enjoying Hatoba? | 喜欢 Hatoba 吗？ | Hatoba は気に入りましたか？ |
| Star | 点 Star | スターを付ける |
- The page shows the version; click it to copy.
- Software Update → Check for Updates asks GitHub whether a newer version exists. The result is “Checking…”, “Hatoba is up to date.”, “Hatoba vX is available.”, or an offline or failure message. A newer version’s release notes show below the setting, with View on GitHub for its release page.
- Download and Install asks first only when SSH sessions are open or file transfers are running, and says how many closing Hatoba will end. After Install and Restart (or right away when nothing would end), Hatoba downloads the installer and checks its signature, then closes, which disconnects every session, and opens again once the installer finishes. An installer without a valid signature from Hatoba is refused and not run. Update error messages are in Troubleshooting: keys, vault, files, updates and other messages.
- Automatically check for updates at startup is on by default. When on, Hatoba asks GitHub once after the first unlock of each launch; when off, it contacts GitHub only when Check for Updates or Download and Install is pressed.
- When a newer release is found, the sidebar gear shows a dot, its tooltip becomes Settings (update available), and it opens the About tab.
- Website opens https://hatoba.fog.moe, with downloads and these docs. Source Code and MIT License open the GitHub repository and the license. Report a Problem opens GitHub’s bug report form with the Hatoba version and the operating system filled in; the user reviews and submits it.
- A card in the sidebar (Enjoying Hatoba?) asks once for a GitHub star, a day after first use and after a session has connected. Star opens the repository, Report a Problem opens the bug form, and the × closes it for good.
Which settings sync
| Synced with the vault | Kept on this device |
|---|---|
| Terminal settings (font, size, cursor, scrollback, terminal colors, right-click, multi-line paste check), the default AI model, the judge of Auto mode, the search provider, the built-in skill’s switch, the AI custom instructions and Terminal Screen default, saved proxies | Language, appearance, list density, host reachability, the default proxy, the Security tab’s Auto-Lock, sleep, disconnect and clipboard settings, the update check switch, the AI permission mode, the saved AI approvals, the AI panel width and whether it is open, MCP on/off and Always allow |