sshler 0.3.2__tar.gz → 0.3.3__tar.gz

{sshler-0.3.2/sshler.egg-info → sshler-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sshler
-Version: 0.3.2
+Version: 0.3.3
 Summary: A local FastAPI-powered SSH multiplexer for tmux-in-browser — from your laptop only.
 Author: You
 License-Expression: MIT
@@ -30,6 +30,7 @@ Requires-Dist: asyncssh>=2.14.0
 Requires-Dist: platformdirs>=4.2
 Requires-Dist: pydantic>=2.7
 Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: markdown-it-py>=3.0.0
 Requires-Dist: sqler>=1.2025.9.24
 Provides-Extra: dev
 Requires-Dist: anyio>=4.4; extra == "dev"
@@ -38,60 +39,42 @@ Requires-Dist: pytest>=8.2; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: ruff>=0.5.6; extra == "dev"
 
+# sshler
 
-# sshler / エスエスエイチラー
+sshler is a lightweight, local-only web UI that lets you browse remote files over SFTP and jump into tmux sessions in your browser — without installing anything on the remote host.
 
-**English:** sshler is a lightweight, local-only web UI that lets you browse remote
-files over SFTP and jump into tmux sessions in your browser — without installing
-anything on the remote host.
+## Features
 
-**日本語:** sshler はローカル専用の軽量 Web UI で、リモートファイルを SFTP で閲覧したり、
-ブラウザ上で tmux セッションに接続したりできます。リモート側に追加ソフトを
-インストールする必要はありません。
+- **Cross-platform**: Runs on Windows 11, macOS, and Linux (anywhere with Python 3.12+)
+- **Local workspace**: Browse your own filesystem and launch native tmux sessions alongside remote hosts (uses WSL tmux on Windows, native tmux on Linux/macOS)
+- **SSH integration**: Uses your existing SSH keys and honors OpenSSH aliases
+- **Terminal in browser**: Opens `tmux new -As <session> -c <dir>` on the remote host and bridges it via WebSocket + xterm.js
+- **File management**: HTMX-based file browser with preview, edit, delete, and "Open Terminal Here"
+- **Auto-configuration**: Creates starter config on first run
+- **Alias resolution**: Falls back to `ssh -G` when DNS fails; reset overrides with one click
+- **File operations**: Preview, edit (≤256 KB), and delete files with CodeMirror editor
+- **Bilingual UI**: Full English and Japanese language support
 
-- Runs on your Windows 11 laptop (or any OS with Python)
-  - **日本語:** Windows 11 を含む Python が動く環境ならどこでも動作します。
-- Includes a "local" workspace card so you can browse your own filesystem and launch WSL-backed tmux sessions alongside remote hosts
-  - **日本語:** ローカルワークスペースカードを備え、ローカル/WSL のファイルや tmux も同じ UI で扱えます。
-- Uses your existing SSH keys
-  - **日本語:** 既存の SSH 鍵をそのまま利用します。
-- Opens `tmux new -As <session> -c <dir>` on the remote host and bridges it to the browser via WebSocket + xterm.js
-  - **日本語:** リモートで `tmux new -As <session> -c <dir>` を実行し、WebSocket と xterm.js でブラウザに橋渡しします。
-- HTMX-based file browser with “Open Terminal Here”
-  - **日本語:** HTMX 製のファイルブラウザから「このディレクトリで端末を開く」がワンクリックで可能です。
-- Auto-creates a starter config at first run
-  - **日本語:** 初回起動時に自動で設定ファイルを生成します。
-- Honors your OpenSSH aliases; if DNS fails it resolves them via `ssh -G` and you can reset overrides with a single click
-  - **日本語:** OpenSSH のエイリアスを解釈し、DNS 解決に失敗した場合でも `ssh -G` で補完します。ワンクリックで上書きをリセットできます。
-- One-click file previews: view remote files in a new tab without leaving the browser
-  - **日本語:** ワンクリックでプレビュー表示。ブラウザを離れずに内容確認できます。
-- Inline edits for lightweight text files (≤256 KB) with a CodeMirror editor and Save button
-  - **日本語:** 256 KB 以下のテキストならブラウザ内で編集し、その場で保存できます。
+## Install
 
-## Install / インストール
-
-### PyPI (recommended) / PyPI からのインストール
+### PyPI (recommended)
 
 ```bash
 pip install sshler
 
-# launch once to create the config + systemd/service assets
+# Launch once to create the config + systemd/service assets
 sshler serve
 ```
 
-- **日本語:** `pip install sshler` で最新の安定版を取得し、`sshler serve` を実行すると初期設定ファイルが生成されます。
-
 Requires Python **3.12+**.
 
-### Development / 開発インストール
+### Development
 
 ```bash
 uv pip install -e .
 # or: pip install -e .
 ```
 
-- **日本語:** 開発時は editable install (`-e`) を利用してください。
-
 After cloning the repository, install the dev extras and run the usual tooling:
 
 ```bash
@@ -100,9 +83,7 @@ uv run ruff check .
 uv run pytest
 ```
 
-- **日本語:** リポジトリを取得したら `uv sync --group dev` で依存関係をそろえ、`uv run ruff check .` や `uv run pytest` で動作を確認します。
-
-## Run / 実行
+## Run
 
 ```bash
 sshler serve
@@ -110,8 +91,6 @@ sshler serve
 
 The app will open `http://127.0.0.1:8822` in your default browser.
 
-- **日本語:** 上記を実行するとデフォルトブラウザで `http://127.0.0.1:8822` が開きます。
-
 ## Configuration / 設定
 
 sshler reads your existing OpenSSH config (`~/.ssh/config`) and shows every concrete `Host` entry automatically. Any favourites, default directories, or custom hosts you add through the UI are stored in a companion YAML file.
@@ -167,9 +146,9 @@ Hit “Add Box” in the UI to define a host that isn’t in your SSH config (fo
 
 ### CLI options
 
-```
+```bash
 sshler serve \
-  --bind 127.0.0.1 \
+  --host 127.0.0.1 \
   --port 8822 \
   --max-upload-mb 50 \
   --allow-origin http://workstation:8822 \
@@ -178,17 +157,28 @@ sshler serve \
   --log-level info
 ```
 
-- `--bind` (alias `--host`) keeps the server on localhost by default.
-- `--allow-origin` can be repeated to expand CORS; combine it with `--auth` if you expose the UI to the LAN.
-- `--max-upload-mb` lets you raise/lower the upload ceiling.
+- `--host` (alias `--bind`) sets the bind address (default: `127.0.0.1` for localhost-only). Use `0.0.0.0` to expose on all interfaces, but **only on trusted networks with `--auth` and TLS**.
+- `--port` sets the port number (default: `8822`).
+- `--allow-origin` can be repeated to expand CORS; combine it with `--auth` if you expose the UI beyond localhost.
+- `--auth user:pass` enables HTTP basic authentication (recommended if binding to `0.0.0.0`).
+- `--max-upload-mb` sets the upload size limit (default: 50 MB).
 - `--no-ssh-alias` disables the `ssh -G` fallback when DNS fails.
 - `--token` lets you supply your own `X-SSHLER-TOKEN` (otherwise a secure random value is generated).
-- `--log-level` feeds directly into uvicorn.
+- `--log-level` feeds directly into uvicorn (options: `critical`, `error`, `warning`, `info`, `debug`, `trace`).
 
 The server prints the token (and, if enabled, the basic auth username) on startup so you can copy it into API clients or browser extensions.
 
 - **日本語:** サーバー起動時にトークン（および Basic 認証を有効にした場合はユーザー名）を表示するので、API クライアントやブラウザ拡張に貼り付けて利用できます。
 
+### Terminal notifications
+
+- Send a bell (`printf '\a'`) from tmux or your shell to flash the browser title and raise a desktop notification whenever the sshler tab is hidden.
+- For richer messages use OSC 777: `printf '\033]777;notify=Codex%20done|Check%20the%20output\a'`. The text before the `|` becomes the title; the second part is the body.
+- JSON payloads are also supported: `printf '\033]777;notify={"title":"Codex","message":"All tasks finished"}\a'`.
+- The first notification prompts the browser for permission. Denying it still leaves the in-app toast and title badge when you return to the tab.
+
+- **日本語:** タブが非表示のときに `printf '\a'` でベルを送ると、ブラウザタイトルが点滅しデスクトップ通知が表示されます。`printf '\033]777;notify=タイトル|本文\a'` で任意メッセージを送信でき、JSON (`notify={"title":"...","message":"..."}`) にも対応しています。初回は通知許可のダイアログが表示されますが、拒否した場合でもタブ復帰時にトーストとタイトルのバッジで気付けます。
+
 ## Autostart / 自動起動
 
 ### Windows (Task Scheduler)
@@ -238,8 +228,92 @@ All assets are used under their respective MIT/BSD-style licenses. sshler itself
 
 - **日本語:** 依存ライブラリはいずれも寛容なライセンス (MIT/BSD) で提供されています。sshler 本体も MIT ライセンスで配布されます。
 
-## Why “sshler”? / 名前の由来
+## Why "sshler"?
+
+Because sometimes you want less VS Code, more terminal — but still in a nice browser tab.
+
+---
+
+# 日本語ドキュメント
+
+sshler はローカル専用の軽量 Web UI で、リモートファイルを SFTP で閲覧したり、ブラウザ上で tmux セッションに接続したりできます。リモート側に追加ソフトをインストールする必要はありません。
+
+## 特徴
+
+- **クロスプラットフォーム**: Windows 11、macOS、Linux で動作（Python 3.12+ が必要）
+- **ローカルワークスペース**: ローカルファイルシステムを閲覧し、リモートホストと並べてネイティブの tmux セッションを起動（Windows では WSL tmux、Linux/macOS ではネイティブ tmux を使用）
+- **SSH 統合**: 既存の SSH 鍵を使用し、OpenSSH エイリアスに対応
+- **ブラウザ内ターミナル**: リモートホストで `tmux new -As <session> -c <dir>` を開き、WebSocket + xterm.js 経由で接続
+- **ファイル管理**: プレビュー、編集、削除、「ここでターミナルを開く」機能を備えた HTMX ベースのファイルブラウザ
+- **自動設定**: 初回起動時にスターター設定を作成
+- **エイリアス解決**: DNS 失敗時は `ssh -G` にフォールバック。ワンクリックで上書きをリセット
+- **ファイル操作**: CodeMirror エディタでファイルのプレビュー、編集（256 KB 以下）、削除が可能
+- **バイリンガル UI**: 英語と日本語の完全サポート
+
+## インストール
+
+### PyPI（推奨）
+
+```bash
+pip install sshler
+
+# 設定ファイルと systemd/サービスアセットを作成するため一度起動
+sshler serve
+```
+
+Python **3.12+** が必要です。
+
+### 開発用
+
+```bash
+uv pip install -e .
+# または: pip install -e .
+```
+
+リポジトリをクローンした後、dev extras をインストールして通常のツールを実行：
+
+```bash
+uv sync --group dev
+uv run ruff check .
+uv run pytest
+```
+
+## 実行
+
+```bash
+sshler serve
+```
+
+デフォルトブラウザで `http://127.0.0.1:8822` が開きます。
+
+## 設定
+
+sshler は既存の OpenSSH 設定（`~/.ssh/config`）を読み取り、すべての具体的な `Host` エントリを自動的に表示します。UI を通じて追加したお気に入り、デフォルトディレクトリ、カスタムホストは、付属の YAML ファイルに保存されます。
+
+設定ファイルは初回実行時に作成されます：
+
+- Windows: `%APPDATA%\sshler\boxes.yaml`
+- macOS/Linux: `~/.config/sshler/boxes.yaml`
+
+例：
+
+```yaml
+boxes:
+  - name: gabu-server
+    host: example.tailnet.ts.net
+    ssh_alias: gabu-server
+    user: gabu
+    port: 22
+    keyfile: "C:/Users/gabu/.ssh/id_ed25519"
+    favorites:
+      - /home/gabu
+      - /home/gabu/projects
+      - /srv/codex
+    default_dir: /home/gabu
+```
+
+> ヒント: ホームパスが `/home/<user>` でない場合は `default_dir` を設定してください。OpenSSH エイリアスを使用する場合は `ssh_alias:` を追加すると、DNS 失敗時に `ssh -G` で解決します。
 
-**English:** Because sometimes you want less VS Code, more terminal — but still in a nice browser tab.
+## 名前の由来
 
-**日本語:** VS Code だけに頼らず、ブラウザタブの中で軽快にターミナルを扱いたい──そんな願いからこの名前になりました。
+VS Code だけに頼らず、ブラウザタブの中で軽快にターミナルを扱いたい──そんな願いからこの名前になりました。

{sshler-0.3.2 → sshler-0.3.3}/README.md

@@ -1,57 +1,39 @@
+# sshler
 
-# sshler / エスエスエイチラー
-
-**English:** sshler is a lightweight, local-only web UI that lets you browse remote
-files over SFTP and jump into tmux sessions in your browser — without installing
-anything on the remote host.
-
-**日本語:** sshler はローカル専用の軽量 Web UI で、リモートファイルを SFTP で閲覧したり、
-ブラウザ上で tmux セッションに接続したりできます。リモート側に追加ソフトを
-インストールする必要はありません。
-
-- Runs on your Windows 11 laptop (or any OS with Python)
-  - **日本語:** Windows 11 を含む Python が動く環境ならどこでも動作します。
-- Includes a "local" workspace card so you can browse your own filesystem and launch WSL-backed tmux sessions alongside remote hosts
-  - **日本語:** ローカルワークスペースカードを備え、ローカル/WSL のファイルや tmux も同じ UI で扱えます。
-- Uses your existing SSH keys
-  - **日本語:** 既存の SSH 鍵をそのまま利用します。
-- Opens `tmux new -As <session> -c <dir>` on the remote host and bridges it to the browser via WebSocket + xterm.js
-  - **日本語:** リモートで `tmux new -As <session> -c <dir>` を実行し、WebSocket と xterm.js でブラウザに橋渡しします。
-- HTMX-based file browser with “Open Terminal Here”
-  - **日本語:** HTMX 製のファイルブラウザから「このディレクトリで端末を開く」がワンクリックで可能です。
-- Auto-creates a starter config at first run
-  - **日本語:** 初回起動時に自動で設定ファイルを生成します。
-- Honors your OpenSSH aliases; if DNS fails it resolves them via `ssh -G` and you can reset overrides with a single click
-  - **日本語:** OpenSSH のエイリアスを解釈し、DNS 解決に失敗した場合でも `ssh -G` で補完します。ワンクリックで上書きをリセットできます。
-- One-click file previews: view remote files in a new tab without leaving the browser
-  - **日本語:** ワンクリックでプレビュー表示。ブラウザを離れずに内容確認できます。
-- Inline edits for lightweight text files (≤256 KB) with a CodeMirror editor and Save button
-  - **日本語:** 256 KB 以下のテキストならブラウザ内で編集し、その場で保存できます。
-
-## Install / インストール
-
-### PyPI (recommended) / PyPI からのインストール
+sshler is a lightweight, local-only web UI that lets you browse remote files over SFTP and jump into tmux sessions in your browser — without installing anything on the remote host.
+
+## Features
+
+- **Cross-platform**: Runs on Windows 11, macOS, and Linux (anywhere with Python 3.12+)
+- **Local workspace**: Browse your own filesystem and launch native tmux sessions alongside remote hosts (uses WSL tmux on Windows, native tmux on Linux/macOS)
+- **SSH integration**: Uses your existing SSH keys and honors OpenSSH aliases
+- **Terminal in browser**: Opens `tmux new -As <session> -c <dir>` on the remote host and bridges it via WebSocket + xterm.js
+- **File management**: HTMX-based file browser with preview, edit, delete, and "Open Terminal Here"
+- **Auto-configuration**: Creates starter config on first run
+- **Alias resolution**: Falls back to `ssh -G` when DNS fails; reset overrides with one click
+- **File operations**: Preview, edit (≤256 KB), and delete files with CodeMirror editor
+- **Bilingual UI**: Full English and Japanese language support
+
+## Install
+
+### PyPI (recommended)
 
 ```bash
 pip install sshler
 
-# launch once to create the config + systemd/service assets
+# Launch once to create the config + systemd/service assets
 sshler serve
 ```
 
-- **日本語:** `pip install sshler` で最新の安定版を取得し、`sshler serve` を実行すると初期設定ファイルが生成されます。
-
 Requires Python **3.12+**.
 
-### Development / 開発インストール
+### Development
 
 ```bash
 uv pip install -e .
 # or: pip install -e .
 ```
 
-- **日本語:** 開発時は editable install (`-e`) を利用してください。
-
 After cloning the repository, install the dev extras and run the usual tooling:
 
 ```bash
@@ -60,9 +42,7 @@ uv run ruff check .
 uv run pytest
 ```
 
-- **日本語:** リポジトリを取得したら `uv sync --group dev` で依存関係をそろえ、`uv run ruff check .` や `uv run pytest` で動作を確認します。
-
-## Run / 実行
+## Run
 
 ```bash
 sshler serve
@@ -70,8 +50,6 @@ sshler serve
 
 The app will open `http://127.0.0.1:8822` in your default browser.
 
-- **日本語:** 上記を実行するとデフォルトブラウザで `http://127.0.0.1:8822` が開きます。
-
 ## Configuration / 設定
 
 sshler reads your existing OpenSSH config (`~/.ssh/config`) and shows every concrete `Host` entry automatically. Any favourites, default directories, or custom hosts you add through the UI are stored in a companion YAML file.
@@ -127,9 +105,9 @@ Hit “Add Box” in the UI to define a host that isn’t in your SSH config (fo
 
 ### CLI options
 
-```
+```bash
 sshler serve \
-  --bind 127.0.0.1 \
+  --host 127.0.0.1 \
   --port 8822 \
   --max-upload-mb 50 \
   --allow-origin http://workstation:8822 \
@@ -138,17 +116,28 @@ sshler serve \
   --log-level info
 ```
 
-- `--bind` (alias `--host`) keeps the server on localhost by default.
-- `--allow-origin` can be repeated to expand CORS; combine it with `--auth` if you expose the UI to the LAN.
-- `--max-upload-mb` lets you raise/lower the upload ceiling.
+- `--host` (alias `--bind`) sets the bind address (default: `127.0.0.1` for localhost-only). Use `0.0.0.0` to expose on all interfaces, but **only on trusted networks with `--auth` and TLS**.
+- `--port` sets the port number (default: `8822`).
+- `--allow-origin` can be repeated to expand CORS; combine it with `--auth` if you expose the UI beyond localhost.
+- `--auth user:pass` enables HTTP basic authentication (recommended if binding to `0.0.0.0`).
+- `--max-upload-mb` sets the upload size limit (default: 50 MB).
 - `--no-ssh-alias` disables the `ssh -G` fallback when DNS fails.
 - `--token` lets you supply your own `X-SSHLER-TOKEN` (otherwise a secure random value is generated).
-- `--log-level` feeds directly into uvicorn.
+- `--log-level` feeds directly into uvicorn (options: `critical`, `error`, `warning`, `info`, `debug`, `trace`).
 
 The server prints the token (and, if enabled, the basic auth username) on startup so you can copy it into API clients or browser extensions.
 
 - **日本語:** サーバー起動時にトークン（および Basic 認証を有効にした場合はユーザー名）を表示するので、API クライアントやブラウザ拡張に貼り付けて利用できます。
 
+### Terminal notifications
+
+- Send a bell (`printf '\a'`) from tmux or your shell to flash the browser title and raise a desktop notification whenever the sshler tab is hidden.
+- For richer messages use OSC 777: `printf '\033]777;notify=Codex%20done|Check%20the%20output\a'`. The text before the `|` becomes the title; the second part is the body.
+- JSON payloads are also supported: `printf '\033]777;notify={"title":"Codex","message":"All tasks finished"}\a'`.
+- The first notification prompts the browser for permission. Denying it still leaves the in-app toast and title badge when you return to the tab.
+
+- **日本語:** タブが非表示のときに `printf '\a'` でベルを送ると、ブラウザタイトルが点滅しデスクトップ通知が表示されます。`printf '\033]777;notify=タイトル|本文\a'` で任意メッセージを送信でき、JSON (`notify={"title":"...","message":"..."}`) にも対応しています。初回は通知許可のダイアログが表示されますが、拒否した場合でもタブ復帰時にトーストとタイトルのバッジで気付けます。
+
 ## Autostart / 自動起動
 
 ### Windows (Task Scheduler)
@@ -198,8 +187,92 @@ All assets are used under their respective MIT/BSD-style licenses. sshler itself
 
 - **日本語:** 依存ライブラリはいずれも寛容なライセンス (MIT/BSD) で提供されています。sshler 本体も MIT ライセンスで配布されます。
 
-## Why “sshler”? / 名前の由来
+## Why "sshler"?
+
+Because sometimes you want less VS Code, more terminal — but still in a nice browser tab.
+
+---
+
+# 日本語ドキュメント
+
+sshler はローカル専用の軽量 Web UI で、リモートファイルを SFTP で閲覧したり、ブラウザ上で tmux セッションに接続したりできます。リモート側に追加ソフトをインストールする必要はありません。
+
+## 特徴
+
+- **クロスプラットフォーム**: Windows 11、macOS、Linux で動作（Python 3.12+ が必要）
+- **ローカルワークスペース**: ローカルファイルシステムを閲覧し、リモートホストと並べてネイティブの tmux セッションを起動（Windows では WSL tmux、Linux/macOS ではネイティブ tmux を使用）
+- **SSH 統合**: 既存の SSH 鍵を使用し、OpenSSH エイリアスに対応
+- **ブラウザ内ターミナル**: リモートホストで `tmux new -As <session> -c <dir>` を開き、WebSocket + xterm.js 経由で接続
+- **ファイル管理**: プレビュー、編集、削除、「ここでターミナルを開く」機能を備えた HTMX ベースのファイルブラウザ
+- **自動設定**: 初回起動時にスターター設定を作成
+- **エイリアス解決**: DNS 失敗時は `ssh -G` にフォールバック。ワンクリックで上書きをリセット
+- **ファイル操作**: CodeMirror エディタでファイルのプレビュー、編集（256 KB 以下）、削除が可能
+- **バイリンガル UI**: 英語と日本語の完全サポート
+
+## インストール
+
+### PyPI（推奨）
+
+```bash
+pip install sshler
+
+# 設定ファイルと systemd/サービスアセットを作成するため一度起動
+sshler serve
+```
+
+Python **3.12+** が必要です。
+
+### 開発用
+
+```bash
+uv pip install -e .
+# または: pip install -e .
+```
+
+リポジトリをクローンした後、dev extras をインストールして通常のツールを実行：
+
+```bash
+uv sync --group dev
+uv run ruff check .
+uv run pytest
+```
+
+## 実行
+
+```bash
+sshler serve
+```
+
+デフォルトブラウザで `http://127.0.0.1:8822` が開きます。
+
+## 設定
+
+sshler は既存の OpenSSH 設定（`~/.ssh/config`）を読み取り、すべての具体的な `Host` エントリを自動的に表示します。UI を通じて追加したお気に入り、デフォルトディレクトリ、カスタムホストは、付属の YAML ファイルに保存されます。
+
+設定ファイルは初回実行時に作成されます：
+
+- Windows: `%APPDATA%\sshler\boxes.yaml`
+- macOS/Linux: `~/.config/sshler/boxes.yaml`
+
+例：
+
+```yaml
+boxes:
+  - name: gabu-server
+    host: example.tailnet.ts.net
+    ssh_alias: gabu-server
+    user: gabu
+    port: 22
+    keyfile: "C:/Users/gabu/.ssh/id_ed25519"
+    favorites:
+      - /home/gabu
+      - /home/gabu/projects
+      - /srv/codex
+    default_dir: /home/gabu
+```
+
+> ヒント: ホームパスが `/home/<user>` でない場合は `default_dir` を設定してください。OpenSSH エイリアスを使用する場合は `ssh_alias:` を追加すると、DNS 失敗時に `ssh -G` で解決します。
 
-**English:** Because sometimes you want less VS Code, more terminal — but still in a nice browser tab.
+## 名前の由来
 
-**日本語:** VS Code だけに頼らず、ブラウザタブの中で軽快にターミナルを扱いたい──そんな願いからこの名前になりました。
+VS Code だけに頼らず、ブラウザタブの中で軽快にターミナルを扱いたい──そんな願いからこの名前になりました。

{sshler-0.3.2 → sshler-0.3.3}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sshler"
-version = "0.3.2"
+version = "0.3.3"
 description = "A local FastAPI-powered SSH multiplexer for tmux-in-browser — from your laptop only."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -20,6 +20,7 @@ dependencies = [
     "platformdirs>=4.2",
     "pydantic>=2.7",
     "python-multipart>=0.0.9",
+    "markdown-it-py>=3.0.0",
     "sqler>=1.2025.9.24",
 ]
 classifiers = [

{sshler-0.3.2 → sshler-0.3.3}/sshler/static/base.js

@@ -2,6 +2,7 @@
   const FAVICONS = {
     default: "/static/favicon.svg",
     terminal: "/static/favicon-terminal.svg",
+    "terminal-local": "/static/favicon-terminal-local.svg",
   };
   const LANG_KEY = "sshler-language";
 
@@ -10,11 +11,89 @@
       "nav.boxes": "Boxes",
       "nav.addBox": "Add Box",
       "nav.docs": "Docs",
+      "boxes.title": "Boxes",
+      "boxes.subtitle": "Pick a box to browse and open a terminal. Hosts are imported from your SSH config and any custom boxes you add here.",
+      "boxes.localWorkspace": "Local workspace",
+      "boxes.fromSSHConfig": "From SSH config",
+      "boxes.customBox": "Custom box",
+      "boxes.resolvesTo": "resolves to",
+      "boxes.favorites": "Favorites",
+      "boxes.open": "Open",
+      "boxes.terminal": "Terminal",
+      "boxes.refresh": "Refresh",
+      "boxes.configFile": "Config file:",
+      "box.browse": "Browse",
+      "box.name": "Name",
+      "box.type": "Type",
+      "box.size": "Size",
+      "box.actions": "Actions",
+      "box.preview": "Preview",
+      "box.edit": "Edit",
+      "box.delete": "Delete",
+      "box.createFile": "Create File",
+      "box.uploadFile": "Upload File",
+      "box.filename": "Filename",
+      "box.create": "Create",
+      "box.upload": "Upload",
+      "term.session": "Session:",
+      "term.back": "Back",
+      "term.files": "Files",
+      "term.scrollMode": "Scroll Mode",
+      "term.escape": "Escape",
+      "term.ctrlT": "Ctrl+T",
+      "term.ctrlC": "Ctrl+C",
+      "term.splitH": "Split %",
+      "term.splitV": "Split \"",
+      "term.newWindow": "New Window",
+      "term.renameWindow": "Rename Window",
+      "term.killPane": "Kill Pane",
+      "term.nextWindow": "Next Window",
+      "term.prevWindow": "Prev Window",
+      "term.detach": "Detach",
     },
     ja: {
       "nav.boxes": "ボックス",
       "nav.addBox": "ボックスを追加",
       "nav.docs": "ドキュメント",
+      "boxes.title": "ボックス",
+      "boxes.subtitle": "ボックスを選択してファイルブラウザとターミナルを開きます。SSH 設定からホストが自動的にインポートされ、カスタムボックスも追加できます。",
+      "boxes.localWorkspace": "ローカルワークスペース",
+      "boxes.fromSSHConfig": "SSH 設定から",
+      "boxes.customBox": "カスタムボックス",
+      "boxes.resolvesTo": "解決先",
+      "boxes.favorites": "お気に入り",
+      "boxes.open": "開く",
+      "boxes.terminal": "ターミナル",
+      "boxes.refresh": "更新",
+      "boxes.configFile": "設定ファイル:",
+      "box.browse": "ブラウズ",
+      "box.name": "名前",
+      "box.type": "種類",
+      "box.size": "サイズ",
+      "box.actions": "操作",
+      "box.preview": "プレビュー",
+      "box.edit": "編集",
+      "box.delete": "削除",
+      "box.createFile": "ファイル作成",
+      "box.uploadFile": "ファイルアップロード",
+      "box.filename": "ファイル名",
+      "box.create": "作成",
+      "box.upload": "アップロード",
+      "term.session": "セッション:",
+      "term.back": "戻る",
+      "term.files": "ファイル",
+      "term.scrollMode": "スクロールモード",
+      "term.escape": "Escape",
+      "term.ctrlT": "Ctrl+T",
+      "term.ctrlC": "Ctrl+C",
+      "term.splitH": "横分割 %",
+      "term.splitV": "縦分割 \"",
+      "term.newWindow": "新規ウィンドウ",
+      "term.renameWindow": "ウィンドウ名変更",
+      "term.killPane": "ペイン終了",
+      "term.nextWindow": "次のウィンドウ",
+      "term.prevWindow": "前のウィンドウ",
+      "term.detach": "デタッチ",
     },
   };
 
@@ -47,7 +126,7 @@
     if (!faviconLink) {
       return;
     }
-    const target = mode === "terminal" ? FAVICONS.terminal : FAVICONS.default;
+    const target = FAVICONS[mode] || FAVICONS.default;
     if (faviconLink.getAttribute("href") !== target) {
       faviconLink.setAttribute("href", target);
     }
@@ -101,6 +180,16 @@
         el.textContent = text;
       }
     });
+
+    // Also translate placeholders
+    const placeholderElements = document.querySelectorAll("[data-i18n-placeholder]");
+    placeholderElements.forEach((el) => {
+      const key = el.dataset.i18nPlaceholder;
+      const text = I18N[lang]?.[key];
+      if (text && el.tagName === "INPUT") {
+        el.placeholder = text;
+      }
+    });
   }
 
   function updateLangToggle(lang) {
@@ -192,7 +281,8 @@
           // Show modal
           modal.classList.add("visible");
 
-          // Set initial language
+          // Set initial language to match current site language
+          const currentLang = getStoredLang();
           switchDocsLanguage(currentLang);
 
           // Language switcher in modal
@@ -255,6 +345,12 @@
       showToast(payload.message, status);
     });
 
+    // Re-translate after HTMX swaps new content
+    document.body.addEventListener("htmx:afterSwap", () => {
+      const currentLang = getStoredLang();
+      translate(currentLang);
+    });
+
     // Event delegation for delete buttons
     document.body.addEventListener("click", (event) => {
       const deleteBtn = event.target.closest(".delete-file-btn");
@@ -302,4 +398,7 @@
   window.sshlerShowToast = showToast;
   window.sshlerSetFavicon = setFavicon;
   window.sshlerDeleteFile = deleteFile;
+  window.sshlerTranslate = function() {
+    translate(getStoredLang());
+  };
 })();