@sanohiro/casty 1.0.0 → 1.1.1

package/README.ja.md

@@ -6,6 +6,8 @@
 
 casty は w3m や lynx のようなテキストブラウザではありません。ヘッドレス Chrome を起動し、CDP でレンダリング結果を取得して、Kitty graphics protocol でターミナルに描画します。Chrome のリモートデスクトップがターミナルに収まった感じです。
 
+![Ghostty 上で動作する casty](docs/screenshot-ghostty.png)
+
 <video src="https://github.com/user-attachments/assets/552f1972-bb53-481e-9516-c36b7e5085d8" autoplay loop muted playsinline></video>
 
 ## 仕組み
@@ -21,7 +23,7 @@ casty は w3m や lynx のようなテキストブラウザではありません
 └──────────────┘      └──────────────┘      └──────────────┘
 ```
 
-レンダリングはすべて Chrome がやります。casty はフレームをターミナルに流して入力を返すだけのブリッジ（約1200行）。Playwright も puppeteer も使わず、WebSocket で生 CDP を叩いています。
+レンダリングはすべて Chrome がやります。casty はフレームをターミナルに流して入力を返すだけのブリッジ（約2300行）。Playwright も puppeteer も使わず、WebSocket で生 CDP を叩いています。
 
 本物の Chrome なので JavaScript, CSS, Canvas, WebGL 全部動きます。ステルスパッチで Google ログインも通ります。マウスのクリック、スクロール、ドラッグ、キーボード入力 — 普通のブラウザと同じ操作ができます。
 
@@ -52,6 +54,15 @@ cd casty && npm install
 - Node.js >= 18
 - `unzip`（Chrome 自動インストールに必要）
 
+### tmux
+
+tmux 内で casty を使う場合は、Kitty graphics のエスケープシーケンスを
+ターミナルまで通すために passthrough を有効にしてください:
+
+```tmux
+set -g allow-passthrough on
+```
+
 ## 使い方
 
 ```bash
@@ -127,7 +138,7 @@ casty   # ホームページを開く
 <details>
 <summary>技術詳細</summary>
 
-全体で約1200行の JavaScript です。中でやっていること:
+全体で約2300行の JavaScript です。中でやっていること:
 
 - chrome-headless-shell を起動して生 CDP WebSocket で通信
 - `Runtime.enable` は絶対に送らない（Google ログインが壊れる。これは苦労して発見した）
@@ -155,6 +166,19 @@ lib/bookmarks.js   ブックマーク検索
 
 ## トラブルシューティング
 
+### YouTube で音が出ない（Ubuntu Server）
+
+Chrome はシステムのオーディオサーバーを通じて直接音声を再生します。音が出ない場合：
+
+```bash
+sudo apt install pulseaudio
+sudo usermod -aG audio $USER
+# ログアウトして再ログイン後：
+pulseaudio --start
+```
+
+### Chrome がクラッシュする
+
 casty が起動しない、または Chrome がクラッシュする場合、ブラウザキャッシュを削除してください：
 
 ```bash

package/README.md

@@ -6,6 +6,8 @@ Run a real Chrome browser inside your terminal.
 
 casty is not a text-mode browser like w3m or lynx. It launches headless Chrome, grabs the rendered frames over CDP, and draws them in your terminal via Kitty graphics protocol. Think of it as a remote desktop for Chrome that fits in a terminal window.
 
+![casty running on Ghostty](docs/screenshot-ghostty.png)
+
 <video src="https://github.com/user-attachments/assets/552f1972-bb53-481e-9516-c36b7e5085d8" autoplay loop muted playsinline></video>
 
 ## How It Works
@@ -21,7 +23,7 @@ Terminal (you)          casty               Chrome (headless)
 └──────────────┘      └──────────────┘      └──────────────┘
 ```
 
-Chrome does all the rendering. casty is just a bridge (~1200 lines) that streams frames to your terminal and sends input back. No Playwright, no puppeteer — raw CDP over WebSocket.
+Chrome does all the rendering. casty is just a bridge (~2300 lines) that streams frames to your terminal and sends input back. No Playwright, no puppeteer — raw CDP over WebSocket.
 
 Since it's real Chrome, JavaScript, CSS, Canvas, and WebGL all work. Google login works too (stealth patches bypass bot detection). Mouse clicks, scrolling, dragging, typing — everything you'd expect.
 
@@ -52,6 +54,15 @@ Chrome Headless Shell is auto-installed to `~/.casty/browsers/` on first run.
 - Node.js >= 18
 - `unzip` (for Chrome auto-install)
 
+### tmux
+
+If you run casty inside tmux, enable passthrough so Kitty graphics escape
+sequences can reach your terminal:
+
+```tmux
+set -g allow-passthrough on
+```
+
 ## Usage
 
 ```bash
@@ -155,6 +166,19 @@ lib/bookmarks.js   Bookmark search
 
 ## Troubleshooting
 
+### No audio on YouTube (Ubuntu Server)
+
+Chrome plays audio directly through the system audio server. If there's no sound:
+
+```bash
+sudo apt install pulseaudio
+sudo usermod -aG audio $USER
+# Log out and back in, then:
+pulseaudio --start
+```
+
+### Chrome crashes
+
 If casty fails to start or Chrome crashes, try removing the browser cache:
 
 ```bash

package/lib/browser.js

@@ -7,8 +7,18 @@ import { CDPClient } from './cdp.js';
 import { launchChrome } from './chrome.js';
 import { loadConfig } from './config.js';
 
-const CHROME_VERSION = '145.0.7632.6';
-const USER_AGENT = `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${CHROME_VERSION} Safari/537.36`;
+const DEFAULT_CHROME_VERSION = '146.0.7680.80';
+
+// Platform-specific identity (must match real OS to avoid TLS/TCP fingerprint mismatch)
+const PLATFORM = process.platform === 'darwin'
+  ? { ua: 'Macintosh; Intel Mac OS X 10_15_7', nav: 'MacIntel',
+      glVendor: 'Google Inc. (Apple)', glRenderer: 'ANGLE (Apple, Apple M1, OpenGL 4.1)' }
+  : { ua: `X11; Linux ${process.arch === 'arm64' ? 'aarch64' : 'x86_64'}`,
+      nav: `Linux ${process.arch === 'arm64' ? 'aarch64' : 'x86_64'}`,
+      glVendor: 'Google Inc. (Intel)', glRenderer: 'ANGLE (Intel, Mesa Intel UHD Graphics, OpenGL 4.5)' };
+
+const buildUserAgent = (v) =>
+  `Mozilla/5.0 (${PLATFORM.ua}) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${v} Safari/537.36`;
 const PROFILE_DIR = join(homedir(), '.casty', 'profile');
 
 // Screencast settings (low-res stream for change detection)
@@ -36,9 +46,8 @@ function buildStealthScript(lang) {
 Object.defineProperty(navigator, 'plugins', {
   get: () => {
     const arr = [
-      { name: 'Chrome PDF Plugin', filename: 'internal-pdf-viewer', description: 'Portable Document Format' },
-      { name: 'Chrome PDF Viewer', filename: 'mhjfbmdgcfjbbpaeojofohoefgiehjai', description: '' },
-      { name: 'Native Client', filename: 'internal-nacl-plugin', description: '' },
+      { name: 'PDF Viewer', filename: 'internal-pdf-viewer', description: 'Portable Document Format', length: 1 },
+      { name: 'Chrome PDF Viewer', filename: 'internal-pdf-viewer', description: 'Portable Document Format', length: 1 },
     ];
     arr.refresh = () => {};
     return arr;
@@ -89,8 +98,8 @@ navigator.permissions.query = (params) => {
 // 0x9245 = UNMASKED_VENDOR_WEBGL, 0x9246 = UNMASKED_RENDERER_WEBGL
 const getParam = WebGLRenderingContext.prototype.getParameter;
 WebGLRenderingContext.prototype.getParameter = function(p) {
-  if (p === 0x9245) return 'Google Inc. (Apple)';
-  if (p === 0x9246) return 'ANGLE (Apple, Apple M1, OpenGL 4.1)';
+  if (p === 0x9245) return '${PLATFORM.glVendor}';
+  if (p === 0x9246) return '${PLATFORM.glRenderer}';
   return getParam.call(this, p);
 };
 
@@ -132,6 +141,11 @@ export async function setupPage({ port, wsUrl }, { width, height, zoom = 1 } = {
   const lang = config.language;
   const baseUrl = `http://127.0.0.1:${port}`;
 
+  // Detect Chrome version from CDP endpoint
+  const versionInfo = await fetchJson(`${baseUrl}/json/version`);
+  const chromeVersion = versionInfo?.Browser?.replace(/^Chrome\//, '') || DEFAULT_CHROME_VERSION;
+  const userAgent = buildUserAgent(chromeVersion);
+
   // Try /json/new (single HTTP request, fastest)
   let target = await fetchJson(`${baseUrl}/json/new?about:blank`);
   if (!target?.webSocketDebuggerUrl) {
@@ -162,7 +176,7 @@ export async function setupPage({ port, wsUrl }, { width, height, zoom = 1 } = {
       width: cssWidth, height: cssHeight, deviceScaleFactor: zoom, mobile: false,
     }),
     client.send('Network.setUserAgentOverride', {
-      userAgent: USER_AGENT, platform: 'MacIntel',
+      userAgent: userAgent, platform: PLATFORM.nav,
       acceptLanguage: buildAcceptLanguage(lang),
     }),
     client.send('Page.addScriptToEvaluateOnNewDocument', { source: buildStealthScript(lang) }),

package/lib/config.js

@@ -15,15 +15,16 @@ const configPath = join(homedir(), '.casty', 'config.json');
 
 // Detect system locale (e.g. "en-US", "ja", "zh-CN")
 function detectLocale() {
-  // Intl API gives the most reliable result
+  // Environment variables first (Intl may lack ICU data and return en-US)
+  const env = process.env.LANG || process.env.LC_ALL || process.env.LC_MESSAGES || '';
+  const m = env.match(/^([a-z]{2})(?:[_-]([A-Z]{2}))?/);
+  if (m) return m[2] ? `${m[1]}-${m[2]}` : m[1];
+  // Fallback to Intl API
   try {
     const locale = Intl.DateTimeFormat().resolvedOptions().locale;
     if (locale) return locale;
   } catch {}
-  // Fallback to environment variables
-  const env = process.env.LANG || process.env.LC_ALL || process.env.LC_MESSAGES || '';
-  const m = env.match(/^([a-z]{2}(?:[_-][A-Z]{2})?)/);
-  return m ? m[1].replace('_', '-') : 'en-US';
+  return 'en-US';
 }
 
 const DEFAULTS = {

package/lib/kitty.js

@@ -62,9 +62,16 @@ export function cursorHome() {
   process.stdout.write(CURSOR_HOME);
 }
 
+// tmux only forwards kitty graphics if they are wrapped in a DCS passthrough
+// envelope. Regular cursor/control sequences must stay outside that wrapper.
+function wrapKitty(seq) {
+  if (!process.env.TMUX) return seq;
+  return `\x1bPtmux;${seq.replaceAll('\x1b', '\x1b\x1b')}\x1b\\`;
+}
+
 // Clear screen (also delete all Kitty images)
 export function clearScreen() {
-  process.stdout.write('\x1b_Ga=d,d=A,q=2;\x1b\\\x1b[2J\x1b[H');
+  process.stdout.write(`${wrapKitty('\x1b_Ga=d,d=A,q=2;\x1b\\')}\x1b[2J\x1b[H`);
 }
 
 // Hide cursor
@@ -103,7 +110,8 @@ function sendFrameFile(base64Data) {
   lastFrameData = base64Data;
   writeFileSync(tmpFile, Buffer.from(base64Data, 'base64'));
   const crFile = _cols && _rows ? `,c=${_cols},r=${_rows}` : '';
-  process.stdout.write(`${CURSOR_HOME}\x1b_Ga=T,f=100,t=f,q=2,C=1,i=1${crFile};${tmpPathB64}\x1b\\`);
+  const seq = `\x1b_Ga=T,f=100,t=f,q=2,C=1,i=1${crFile};${tmpPathB64}\x1b\\`;
+  process.stdout.write(`${CURSOR_HOME}${wrapKitty(seq)}`);
 }
 
 // Inline mode (4096B chunked, PNG only)
@@ -116,10 +124,11 @@ function sendFrameInline(pngBase64) {
   const CHUNK = 4096;
   const crInline = _cols && _rows ? `,c=${_cols},r=${_rows}` : '';
   if (pngBase64.length <= CHUNK) {
-    process.stdout.write(`${CURSOR_HOME}\x1b_Ga=T,f=100,q=2,C=1,i=1${crInline};${pngBase64}\x1b\\`);
+    const seq = `\x1b_Ga=T,f=100,q=2,C=1,i=1${crInline};${pngBase64}\x1b\\`;
+    process.stdout.write(`${CURSOR_HOME}${wrapKitty(seq)}`);
     return;
   }
-  const parts = [CURSOR_HOME];
+  const parts = [];
   let i = 0;
   while (i < pngBase64.length) {
     const chunk = pngBase64.slice(i, i + CHUNK);
@@ -131,7 +140,7 @@ function sendFrameInline(pngBase64) {
     }
     i += CHUNK;
   }
-  process.stdout.write(parts.join(''));
+  process.stdout.write(`${CURSOR_HOME}${wrapKitty(parts.join(''))}`);
 }
 
 // Reset dedup state (e.g. after resize)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanohiro/casty",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "TTY web browser using raw CDP and Kitty graphics protocol",
   "main": "bin/casty.js",
   "bin": {
@@ -13,6 +13,7 @@
   ],
   "scripts": {
     "start": "./bin/casty",
+    "test": "node --test",
     "postinstall": "echo 'Run casty to auto-install Chrome Headless Shell to ~/.casty/browsers/'"
   },
   "keywords": [