@sanohiro/casty 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hironobu Sano
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,178 @@
+# casty
+
+Kitty graphics protocol を使った TTY Web ブラウザ。
+
+**[English](README.md)**
+
+ヘッドレス Chrome のレンダリングを Kitty 対応ターミナルに表示し、ターミナル上で完全な Web ブラウジングを実現します。
+
+<video src="https://github.com/user-attachments/assets/330bf0c3-dd08-44a5-b627-b90c200d57fe" autoplay loop muted playsinline></video>
+
+```
+Chrome (Headless Shell)     casty              Terminal
+┌─────────────────┐      ┌─────────────────┐  ┌─────────────────┐
+│  Web レンダリング │ ───→ │  高解像度       │ ─→│  Kitty graphics │
+│  JS 実行         │      │  キャプチャ     │  │  画面表示       │
+│  フルブラウザ     │ ←─── │  入力ブリッジ    │ ←─│  マウス/キーボード│
+└─────────────────┘      └─────────────────┘  └─────────────────┘
+```
+
+## 機能
+
+- ヘッドレス Chrome によるフル Web レンダリング (生 CDP、Playwright 不使用)
+- ボット検出回避のステルスパッチ (Google ログイン可能)
+- Kitty graphics protocol による画像表示
+- マウス操作 (クリック、スクロール、ドラッグ)
+- キーボード入力を Chrome にパススルー
+- Vimium 風ヒントモード (Alt+F) でキーボードナビゲーション
+- アドレスバー + 検索 (Alt+L)
+- ブックマーク (アドレスバーで `/b` 検索)
+- テキスト選択コピー / クリップボードペースト
+- ターミナルのフォントサイズに基づく自動ズーム
+- 動的リサイズ (SIGWINCH)
+- キーバインド設定 (`~/.casty/keys.json`)
+- 各種設定 (`~/.casty/config.json`)
+- ファイルダウンロード (`~/Downloads/` に保存)
+- ローディングインジケーター
+- プロファイル自動クリーンアップによる高速起動
+
+## 必要環境
+
+- **Kitty graphics protocol** 対応ターミナル
+- Node.js >= 22
+
+動作確認済み: **bcon**, **Ghostty**, **kitty**
+
+## インストール
+
+```bash
+npm install -g @sanohiro/casty
+casty
+```
+
+ソースからインストールする場合:
+
+```bash
+git clone https://github.com/sanohiro/casty.git
+cd casty
+npm install
+./bin/casty
+```
+
+初回起動時に Chrome Headless Shell が `~/.casty/browsers/` に自動インストールされます。以降の起動時にバックグラウンドで更新チェックし、常に一世代だけ保持します。
+
+## 使い方
+
+```bash
+casty https://google.com
+casty https://youtube.com
+casty   # ホームページを開く (デフォルト: casty GitHub ページ)
+```
+
+### キーバインド
+
+| キー | アクション |
+|------|-----------|
+| Alt+L | アドレスバーを開く |
+| Alt+F | ヒントモード (Vimium 風リンク/ボタン選択) |
+| Alt+Left | 戻る |
+| Alt+Right | 進む |
+| Alt+C | 選択テキストをコピー |
+| Ctrl+V | クリップボードからペースト |
+| Ctrl+Q | 終了 |
+| Ctrl+C | 終了 (フォールバック) |
+
+`~/.casty/keys.json` でカスタマイズ可能 (ファイルは自動生成されません):
+
+```json
+{
+  "ctrl+q": "quit",
+  "alt+left": "back",
+  "alt+right": "forward",
+  "alt+l": "url_bar",
+  "alt+f": "hints",
+  "alt+c": "copy",
+  "ctrl+v": "paste"
+}
+```
+
+### アドレスバー
+
+- **Alt+L** または1行目クリックでフォーカス — URL が全選択状態になる
+- **Enter** で移動 (URL) または検索 (Google)
+- **`/b クエリ`** でブックマーク検索
+- **Escape** でキャンセル
+- **Ctrl+A** 全選択、**Ctrl+U** 全消去、**Ctrl+W** 単語削除
+
+### ヒントモード
+
+**Alt+F** でクリック可能/フォーカス可能な要素にラベルを表示。ラベルの文字を入力するとリンク/ボタンのクリックや入力欄へのフォーカスができます。**Escape** でキャンセル。
+
+ラベルはホームロウキー (`a`, `s`, `d`, `f`, `j`, `k`, `l`) を使用 — 7個以下なら1文字、それ以上は2文字 (最大49個)。
+
+### ブックマーク
+
+`~/.casty/bookmarks.json` を手動で作成:
+
+```json
+{
+  "GitHub": "https://github.com",
+  "Google": "https://google.com",
+  "YouTube": "https://youtube.com"
+}
+```
+
+アドレスバーで `/b クエリ` と入力して検索 (名前・URL の部分一致、大文字小文字無視)。
+
+### 設定
+
+`~/.casty/config.json` でカスタマイズ可能 (ファイルは自動生成されません):
+
+```json
+{
+  "homeUrl": "https://github.com/sanohiro/casty",
+  "searchUrl": "https://www.google.com/search?q=",
+  "transport": "auto",
+  "format": "auto"
+}
+```
+
+| キー | 説明 | デフォルト |
+|------|------|-----------|
+| `homeUrl` | URL 未指定時に開くページ | `https://github.com/sanohiro/casty` |
+| `searchUrl` | 検索エンジン URL (クエリが末尾に付加される) | `https://www.google.com/search?q=` |
+| `transport` | Kitty 画像転送方式: `auto`, `file`, `inline` | `auto` (bcon→file、他→inline) |
+| `format` | スクリーンショット形式: `auto`, `png`, `jpeg` | `auto` (file→jpeg、inline→png) |
+
+## アーキテクチャ
+
+```
+bin/
+  casty          # シェルラッパー (Chrome インストール/更新)
+  casty.js       # エントリポイント (ターミナル検出、ズーム、リサイズ)
+lib/
+  browser.js     # CDP ブラウザ制御 (起動、Screencast、キャプチャ)
+  cdp.js         # 軽量 CDP WebSocket クライアント
+  chrome.js      # Chrome バイナリ検出、起動、プロファイルクリーンアップ
+  kitty.js       # Kitty graphics protocol 出力 (file/inline)
+  input.js       # マウス/キーボード処理、アクション
+  hints.js       # Vimium 風ヒントモード
+  urlbar.js      # アドレス/検索バー
+  bookmarks.js   # ブックマーク検索
+  keys.js        # キーバインド設定
+  config.js      # ユーザー設定
+```
+
+## 仕組み
+
+1. 生 CDP で Chrome Headless Shell を起動 (Playwright 不使用、`Runtime.enable` も送信しない)
+2. ページロード前にステルスパッチを注入してボット検出を回避
+3. ハイブリッドフレーム取得: 低解像度 Screencast を変更検知トリガーとして使い、`Page.captureScreenshot` で高解像度フレームを取得
+4. Kitty graphics protocol でフレームをターミナルに描画
+5. ターミナル入力 (raw mode) をキャプチャし、CDP 経由で Chrome に送信
+6. CSI 14t でターミナルのピクセルサイズを自動検出し、ズームを計算
+7. 起動時にプロファイルをクリーンアップ (Cookie/LocalStorage を保持、キャッシュ類を削除) して高速起動を維持
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,178 @@
+# casty
+
+A TTY web browser powered by Kitty graphics protocol.
+
+**[日本語](README.ja.md)**
+
+casty renders full web pages in your terminal using Chrome's headless rendering, bridging the gap between a headless browser and your Kitty-compatible terminal.
+
+<video src="https://github.com/user-attachments/assets/330bf0c3-dd08-44a5-b627-b90c200d57fe" autoplay loop muted playsinline></video>
+
+```
+Chrome (Headless Shell)     casty              Terminal
+┌─────────────────┐      ┌─────────────────┐  ┌─────────────────┐
+│  Web rendering  │ ───→ │  High-res       │ ─→│  Kitty graphics │
+│  JS execution   │      │  capture        │  │  display        │
+│  Full browser   │ ←─── │  Input bridge   │ ←─│  Mouse/Keyboard │
+└─────────────────┘      └─────────────────┘  └─────────────────┘
+```
+
+## Features
+
+- Full web rendering via headless Chrome (raw CDP, no Playwright)
+- Stealth patches to avoid bot detection (Google login works)
+- Kitty graphics protocol for image display
+- Mouse support (click, scroll, drag)
+- Keyboard passthrough to Chrome
+- Vimium-style hint mode (Alt+F) for keyboard navigation
+- Address bar with search (Alt+L)
+- Bookmarks (`/b` search in address bar)
+- Copy selected text / paste from clipboard
+- Auto-zoom based on terminal font size
+- Dynamic resize (SIGWINCH)
+- Configurable keybindings (`~/.casty/keys.json`)
+- Configurable settings (`~/.casty/config.json`)
+- File downloads to `~/Downloads/`
+- Loading indicator
+- Fast startup with automatic profile cleanup
+
+## Requirements
+
+- **Kitty graphics protocol** compatible terminal
+- Node.js >= 22
+
+Tested on: **bcon**, **Ghostty**, **kitty**
+
+## Installation
+
+```bash
+npm install -g @sanohiro/casty
+casty
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/sanohiro/casty.git
+cd casty
+npm install
+./bin/casty
+```
+
+Chrome Headless Shell is automatically installed to `~/.casty/browsers/` on first run and kept up to date on subsequent launches. Only one version is kept at a time.
+
+## Usage
+
+```bash
+casty https://google.com
+casty https://youtube.com
+casty   # opens home page (default: casty GitHub page)
+```
+
+### Keybindings
+
+| Key | Action |
+|-----|--------|
+| Alt+L | Open address bar |
+| Alt+F | Hint mode (Vimium-style link/button selection) |
+| Alt+Left | Back |
+| Alt+Right | Forward |
+| Alt+C | Copy selected text |
+| Ctrl+V | Paste from clipboard |
+| Ctrl+Q | Quit |
+| Ctrl+C | Quit (fallback) |
+
+Customize via `~/.casty/keys.json` (file is not created automatically):
+
+```json
+{
+  "ctrl+q": "quit",
+  "alt+left": "back",
+  "alt+right": "forward",
+  "alt+l": "url_bar",
+  "alt+f": "hints",
+  "alt+c": "copy",
+  "ctrl+v": "paste"
+}
+```
+
+### Address Bar
+
+- **Alt+L** or click row 1 to focus — URL is selected, type to replace
+- **Enter** to navigate (URLs) or search (Google)
+- **`/b query`** to search bookmarks
+- **Escape** to cancel
+- **Ctrl+A** select all, **Ctrl+U** clear, **Ctrl+W** delete word
+
+### Hint Mode
+
+Press **Alt+F** to show labels on clickable and focusable elements. Type the label characters to click a link/button or focus an input field. Press **Escape** to cancel.
+
+Labels use home-row keys (`a`, `s`, `d`, `f`, `j`, `k`, `l`) — single character for ≤7 elements, two characters for more (up to 49).
+
+### Bookmarks
+
+Create `~/.casty/bookmarks.json` manually:
+
+```json
+{
+  "GitHub": "https://github.com",
+  "Google": "https://google.com",
+  "YouTube": "https://youtube.com"
+}
+```
+
+Search from the address bar with `/b query` (matches name or URL, case-insensitive).
+
+### Configuration
+
+Customize via `~/.casty/config.json` (file is not created automatically):
+
+```json
+{
+  "homeUrl": "https://github.com/sanohiro/casty",
+  "searchUrl": "https://www.google.com/search?q=",
+  "transport": "auto",
+  "format": "auto"
+}
+```
+
+| Key | Description | Default |
+|-----|-------------|---------|
+| `homeUrl` | Page opened when no URL is given | `https://github.com/sanohiro/casty` |
+| `searchUrl` | Search engine URL (query appended) | `https://www.google.com/search?q=` |
+| `transport` | Kitty image transfer: `auto`, `file`, or `inline` | `auto` (bcon→file, others→inline) |
+| `format` | Screenshot format: `auto`, `png`, or `jpeg` | `auto` (file→jpeg, inline→png) |
+
+## Architecture
+
+```
+bin/
+  casty          # Shell wrapper (Chrome install/update)
+  casty.js       # Entry point (terminal detection, zoom, resize)
+lib/
+  browser.js     # CDP browser control (launch, screencast, capture)
+  cdp.js         # Lightweight CDP WebSocket client
+  chrome.js      # Chrome binary detection, launch, profile cleanup
+  kitty.js       # Kitty graphics protocol output (file/inline)
+  input.js       # Mouse/keyboard handling, actions
+  hints.js       # Vimium-style hint mode
+  urlbar.js      # Address/search bar
+  bookmarks.js   # Bookmark search
+  keys.js        # Configurable keybindings
+  config.js      # User configuration
+```
+
+## How It Works
+
+1. Launches Chrome Headless Shell via raw CDP (no Playwright, no `Runtime.enable`)
+2. Injects stealth patches before page load to avoid bot detection
+3. Uses hybrid frame capture: low-res Screencast as change detection trigger, `Page.captureScreenshot` for high-res frames
+4. Renders frames to terminal via Kitty graphics protocol
+5. Captures terminal input (raw mode) and dispatches to Chrome via CDP
+6. Auto-detects terminal pixel size (CSI 14t) for zoom calculation
+7. Cleans up profile on startup (keeps cookies/storage, removes caches) for fast launch
+
+## License
+
+MIT

package/bin/casty

@@ -0,0 +1,200 @@
+#!/bin/bash
+# casty - TTY web browser
+# シェルラッパー: Chrome for Testing 管理 + 本体起動
+
+# シンボリックリンクを解決して実際のパスを取得
+SOURCE="${BASH_SOURCE[0]}"
+while [ -L "$SOURCE" ]; do
+  DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  [[ "$SOURCE" != /* ]] && SOURCE="$DIR/$SOURCE"
+done
+CASTY_DIR="$(cd -P "$(dirname "$SOURCE")/.." && pwd)"
+
+BROWSERS_DIR="$HOME/.casty/browsers"
+STAMP="$HOME/.casty/.update-check"
+
+# プラットフォーム自動検出
+detect_platform() {
+  local os=$(uname -s)
+  local arch=$(uname -m)
+  case "$os" in
+    Linux)
+      case "$arch" in
+        aarch64|arm64) echo "linux-arm64" ;;  # Chrome for Testing にはないが検出用
+        *)             echo "linux64" ;;
+      esac ;;
+    Darwin)
+      case "$arch" in
+        arm64) echo "mac-arm64" ;;
+        *)     echo "mac-x64" ;;
+      esac ;;
+    *) echo "linux64" ;;
+  esac
+}
+
+# ARM64 Linux か判定 (Chrome for Testing にはバイナリがない)
+is_arm64_linux() {
+  [ "$(detect_platform)" = "linux-arm64" ]
+}
+
+# Playwright 経由で chromium-headless-shell をインストール (ARM64 Linux 用)
+install_chromium_playwright() {
+  echo "casty: Installing Chrome Headless Shell via Playwright..." >&2
+  if PLAYWRIGHT_BROWSERS_PATH="$BROWSERS_DIR" npx -y playwright install chromium-headless-shell 2>&1 >&2; then
+    touch "$STAMP"
+    # 古いバージョンを削除 (最新1つだけ残す)
+    local dirs=$(ls -t -d "$BROWSERS_DIR"/chromium_headless_shell-*/ 2>/dev/null)
+    local count=$(echo "$dirs" | wc -l)
+    if [ "$count" -gt 1 ]; then
+      echo "$dirs" | tail -n +2 | while read -r d; do rm -rf "$d"; done
+    fi
+    # Playwright が入れる ffmpeg も古いのを削除
+    local ffdirs=$(ls -t -d "$BROWSERS_DIR"/ffmpeg-*/ 2>/dev/null)
+    local ffcount=$(echo "$ffdirs" | wc -l)
+    if [ "$ffcount" -gt 1 ]; then
+      echo "$ffdirs" | tail -n +2 | while read -r d; do rm -rf "$d"; done
+    fi
+  fi
+}
+
+# Chrome for Testing API から chrome-headless-shell をダウンロード・インストール
+install_chromium() {
+  local platform=$(detect_platform)
+  local json_url="https://googlechromelabs.github.io/chrome-for-testing/last-known-good-versions-with-downloads.json"
+
+  # JSON API から最新バージョンの URL を取得
+  local json=$(curl -fsSL "$json_url" 2>/dev/null)
+  if [ -z "$json" ]; then
+    echo "casty: Failed to fetch Chrome version info" >&2
+    return 1
+  fi
+
+  # jq がなくても動くよう node で JSON パース
+  local download_url=$(node -e "
+    const d = JSON.parse(process.argv[1]);
+    const hs = d.channels.Stable.downloads['chrome-headless-shell'];
+    const e = hs && hs.find(x => x.platform === '$platform');
+    if (e) console.log(e.url);
+  " "$json" 2>/dev/null)
+
+  if [ -z "$download_url" ]; then
+    echo "casty: No chrome-headless-shell for $platform" >&2
+    return 1
+  fi
+
+  # バージョン番号を抽出
+  local version=$(node -e "
+    const d = JSON.parse(process.argv[1]);
+    console.log(d.channels.Stable.version);
+  " "$json" 2>/dev/null)
+
+  local dest_dir="$BROWSERS_DIR/chrome-headless-shell-${version}"
+
+  # 既にインストール済みならスキップ
+  if [ -f "$dest_dir/chrome-headless-shell" ]; then
+    touch "$STAMP"
+    return 0
+  fi
+
+  echo "casty: Installing Chrome Headless Shell ${version}..." >&2
+
+  local tmp_zip=$(mktemp /tmp/casty-chrome-XXXXXX.zip)
+  # プログレスバー付きダウンロード (TTY ならバー表示、パイプなら非表示)
+  if [ -t 2 ]; then
+    curl -fL --progress-bar "$download_url" -o "$tmp_zip" 2>&1 >&2
+  else
+    curl -fsSL "$download_url" -o "$tmp_zip" 2>/dev/null
+  fi
+  if [ $? -ne 0 ]; then
+    rm -f "$tmp_zip"
+    echo "casty: Download failed" >&2
+    return 1
+  fi
+
+  mkdir -p "$BROWSERS_DIR"
+  # zip 内は chrome-headless-shell-<platform>/ ディレクトリに入っている
+  local tmp_dir=$(mktemp -d /tmp/casty-extract-XXXXXX)
+  unzip -q "$tmp_zip" -d "$tmp_dir" 2>/dev/null
+  rm -f "$tmp_zip"
+
+  # 展開されたディレクトリを見つけてリネーム
+  local extracted=$(ls -d "$tmp_dir"/chrome-headless-shell-* 2>/dev/null | head -1)
+  if [ -z "$extracted" ] || [ ! -f "$extracted/chrome-headless-shell" ]; then
+    rm -rf "$tmp_dir"
+    echo "casty: Extraction failed" >&2
+    return 1
+  fi
+
+  mv "$extracted" "$dest_dir"
+  rm -rf "$tmp_dir"
+  chmod +x "$dest_dir/chrome-headless-shell"
+
+  touch "$STAMP"
+  echo "casty: Installed Chrome Headless Shell ${version}" >&2
+}
+
+# 古いブラウザバージョンを削除 (最新1つだけ残す)
+cleanup_old_browsers() {
+  local count=$(ls -d "$BROWSERS_DIR"/chrome-headless-shell-*/ 2>/dev/null | wc -l)
+  [ "$count" -le 1 ] && return
+  # 最も古いディレクトリを削除
+  local oldest=$(ls -t -d "$BROWSERS_DIR"/chrome-headless-shell-*/ 2>/dev/null | tail -1)
+  [ -n "$oldest" ] && rm -rf "$oldest"
+}
+
+# 初回: ブラウザがなければインストール (ブロッキング)
+has_chrome() {
+  # Chrome for Testing 形式 (ARM64 Linux はスキップ — x86_64 バイナリなので動かない)
+  if ! is_arm64_linux; then
+    ls "$BROWSERS_DIR"/chrome-headless-shell-*/chrome-headless-shell &>/dev/null && return 0
+  fi
+  # Playwright 形式 — 再帰的に探索 (バイナリ名: chrome-headless-shell or headless_shell)
+  find "$BROWSERS_DIR"/chromium_headless_shell-* \( -name 'chrome-headless-shell' -o -name 'headless_shell' \) -type f 2>/dev/null | grep -q . && return 0
+  return 1
+}
+
+# システム Chrome/Chromium があるか
+has_system_chrome() {
+  command -v chromium-browser >/dev/null 2>&1 || \
+  command -v chromium >/dev/null 2>&1 || \
+  command -v google-chrome-stable >/dev/null 2>&1 || \
+  command -v google-chrome >/dev/null 2>&1
+}
+
+if ! has_chrome; then
+  if is_arm64_linux; then
+    # ARM64 Linux: Chrome for Testing にバイナリがないので Playwright 経由でインストール
+    install_chromium_playwright
+  else
+    install_chromium
+  fi
+  if ! has_chrome; then
+    # Playwright も失敗した場合、システム Chromium にフォールバック
+    if ! has_system_chrome; then
+      echo "casty: Chrome not found." >&2
+      if is_arm64_linux; then
+        echo "casty: Install with: sudo apt install chromium-browser" >&2
+      fi
+      exit 1
+    fi
+  fi
+fi
+
+# 1日1回だけバックグラウンドで更新チェック
+needs_update() {
+  [ ! -f "$STAMP" ] && return 0
+  local last=$(stat -c %Y "$STAMP" 2>/dev/null || stat -f %m "$STAMP" 2>/dev/null || echo 0)
+  local now=$(date +%s)
+  [ $(( now - last )) -gt 86400 ]
+}
+
+if needs_update; then
+  if is_arm64_linux; then
+    (install_chromium_playwright) &>/dev/null &
+  else
+    (install_chromium && cleanup_old_browsers) &>/dev/null &
+  fi
+fi
+
+exec node "$CASTY_DIR/bin/casty.js" "$@"