Retired on kymt.me

vrowser

Mon, 06 Feb 2012 00:00:00 +0000

Left 4 Dead 2 や Team Fortress 2 など、HalfLife2 系(Source Engine)ゲームのサーバーブラウザを作るための Ruby ライブラリです。ゲームサーバー統計取得ツールの QStat をラップして、サーバー一覧の取得・データベースへの記録・JSON API での配信までを一式でやります。

gem として公開していて、コマンドラインツールも同梱しています。

gem install vrowser
vrowser sample # サンプル設定ファイルを生成
vrowser -f config.yml fetch # マスターサーバーからサーバー一覧を取得
vrowser -f config.yml update # 登録済みサーバーの状態を更新
vrowser -f config.yml daemon # 常駐デーモンとして起動

内部設計

コンポーネント構成です。中核の Vrowser クラスが QStat の呼び出しと Sequel(ORM)経由の DB 記録を束ねていて、CLI・常駐デーモン・Sinatra アプリのどこからでも同じ処理を呼べる作りになっています。

Vrowser(lib/vrowser.rb)— fetch(マスターサーバーからサーバー一覧を取得して DB に登録)、update(登録済みサーバーを全件クエリして状態更新)、clear(DOWN したサーバーの削除)を提供します
VrowserModel::Servers — Sequel のモデル。スキーマ定義もコード内に持っていて、テーブルがなければ初回接続時に作ります。host カラムが unique キーです
Vrowser::HTTPDaemon(lib/vrowser/http_daemon.rb)— WEBrick で JSON API(/api/updated/json・/api/connected/json)と public_html/ の一覧 UI(jQuery DataTables 製)を配信しつつ、別スレッドで取得ループを回します
plugins/ — ゲーム別の追加ロジック。同梱の l4d2.rb は、サーバー情報からゲームタイプが判定できないときにサーバー名の正規表現マッチ(co-?op、versus、scavenge など)でゲームタイプを推定します

デーモンの更新サイクルはこうなっています。マスターサーバーへの問い合わせは重いので、一覧の再取得は約30分に1回、その間は登録済みサーバーへの個別クエリ(A2S)を150秒間隔で回す二段構えです。

GyazoIM

Sun, 15 May 2011 00:00:00 +0000

Windows のタスクトレイに常駐(起動しっぱなしで待機)して、画面のスクリーンショットを撮って gyazo.com にアップロード（またはローカルで開くだけ）するツールです。素の Gyazo クライアント（当時の gyazowin）に、キーボードショートカットとウィンドウ単位の撮影、それに作り込んだ範囲選択オーバーレイ(画面に重ねて表示する層)を足したもの。

範囲選択のデモ

選択 UI は、先に単体のプロトタイプとして作ってから GyazoIM に組み込みました。そのプロトタイプ（kimoto/selector）を動かしたときの動画がこれです。全画面に半透明のオーバーレイを敷いて、ドラッグした範囲をリアルタイムにサイズ表示しています。

3つの撮り方

範囲選択 — 全モニタにまたがる透明オーバーレイを出してドラッグで範囲を決める。下の一覧のキー操作で、正方形ロック・ウィンドウ端へのスナップ・範囲ごと移動・ホイールでの拡縮ができる
ウィンドウ単位（インスペクト） — カーソルの下にあるウィンドウをハイライトし、クリックでそのウィンドウ全体を自動で範囲取りして撮る
ホットキー — グローバルホットキーで即撮影。既定は F9 でアクティブウィンドウ、Ctrl+F9 でデスクトップ全体。設定ダイアログで変更でき、config.ini に保存される

範囲選択中のキー操作

操作	効果
ドラッグ	範囲を選ぶ（カーソル脇に幅×高さを表示）
Ctrl	正方形にロック（縦を横に合わせる）
Shift	ウィンドウの端にスナップ（50px 以内で吸着）
右ドラッグ	選んだ範囲を、サイズを変えずに移動
マウスホイール	範囲を四方に均等に拡大・縮小
何かキー	キャンセル

範囲を離すと、10×10 より大きければビープを鳴らして撮影します。

アップロードと画像処理

出力先はタスクトレイの右クリックメニューで切り替えます。gyazo.com にアップロードすると、返ってきた URL をクリップボードにコピーしてブラウザで開きます（upload.cgi への multipart POST。認証や SSL もオプションで対応）。もう一方のローカルプレビューは、撮った PNG をそのまま開くだけ。画像は BitBlt で取り込み、最終的には ImageMagick で減色してから保存していました。

名前について

「IM」は、当時の PeerCast クライアント「PeerCastIM」の名前にならったもので、「ちょっと手を加えた版」というくらいの意味です（ただし中身は 1 から書いています）。当時のサイトには「完成しているけれどバグ取りが面倒で放置中」とも書いていて、配布は GitHub のソースのみ、コンパイル済みの実行ファイルは配っていませんでした。

l4d2.kymt.me

Fri, 18 Nov 2011 00:00:00 +0000

HalfLife2 エンジン互換のサーバーブラウザ（L4D2 版）。

同じアプリは今も game.kymt.me/qm に残っていて、上はそのスクリーンショット(サーバー一覧の表示データは2017年で凍結)。入りたいサーバーの行をダブルクリックするとそのままログインできる、というのがページ冒頭の説明にある通りの使い方。

→ https://l4d2.kymt.me/

SQCN

Mon, 06 Jun 2011 00:00:00 +0000

Steam のユーザー名(表示名)をワンクリックで切り替えるためのツールです(Steam Quick Change Name の略)。よく使う名前を登録しておいて一覧から選んで適用できます。C#/.NET Framework 製。

機能概略

適用: 選択された名前に変更します
すべて適用: 配信の視聴者参加用(普段の名前の履歴を見せないため)。設定された名前すべてに一度変更してペルソナ履歴を消します(10個あれば履歴完全に消えます)
履歴消去: 過去に使った名前を他人から見えないようにするため、ペルソナ履歴を1から10の数字で上書きします(「すべて適用」と同じ目的)
通常オフラインだと名前変更できないが、このツールだとオフラインのまま名前変更できる(ゲームに入る前に名前を決めておくため)
標準の UI からだと1文字の名前に変更できない(最低2文字必須)が、このツールだと可能

いずれも Steam の表示名を自分で設定し直すだけの機能で、変更できるのは自分のアカウントの表示名だけです。

Steam を起動している状態で実行する必要があります。 なお、なんか Steam のアップデートでうまく動かなくなったので放置中です。

ダウンロード

SQCN(2011/06/06)

gtasks

Fri, 03 Feb 2012 00:00:00 +0000

Google Tasks をターミナルから操作するコマンドラインクライアント(Ruby gem)です。タスクの一覧・追加・完了・削除・完了済みの一括クリアができて、完了と削除は番号指定のほかタスク名の正規表現マッチによる一括処理にも対応しています。

Google の OAuth2 認証もコマンド内で完結する作りで、初回はローカルに小さな WEBrick サーバーを立ててコールバックを受け取り、取得したトークンをファイルに保存して使い回します。

内部設計

lib/gtasks.rb 1ファイルに3つのクラスが層になって入っています。REST 呼び出しと認証を受け持つ GoogleTaskAPI、それを使いやすいメソッドにまとめた GoogleTask、ターミナル表示に整形する GoogleTaskCLI です。

bin/gtasks — サブコマンドは list/lists/add/clear/done/delete/choice(引数なしなら list)。done と delete は引数が数字なら一覧の番号指定、それ以外は正規表現として解釈し、タスク名がマッチしたものをまとめて処理します。API の client_id/client_secret は pit gem 経由で取得していて、コードには書かない作りです
GoogleTaskCLI — 表示用の層。タスクを [0] ☐ タイトル の形式で番号付き表示し、完了済みは ☑ にします。choice はタスク一覧からランダムに1件選んで表示します
GoogleTask — 番号指定の done/delete と、タイトルの正規表現マッチで一括処理する done_if/delete_if を持つ中間層。「完了」はタスクの status を completed に更新することで実現しています
GoogleTaskAPI — Google Tasks API v1 の薄いラッパー。タスクとタスクリストそれぞれの取得・作成・更新・削除、完了済みタスクの一括クリアをひととおり持ち、HTTP は oauth2 gem のアクセストークン経由で呼びます

認証まわりはこうなっています。初回は認可 URL を表示してユーザーにブラウザで開いてもらい、ローカルの WEBrick サーバー(既定は 9999 番ポートの /oauth_callback)で認可コードを受け取ってトークンに交換、~/.google_tasks.yml に YAML で保存します。access_type=offline でリフレッシュトークンも受け取っているので、2回目以降はファイルから読み込んでリフレッシュするだけで、ブラウザは開きません。

GetFriendAvators

Tue, 24 May 2011 00:00:00 +0000

Steam のすべてのフレンドのプロフィールアイコン(大きい方)を取得して、まとめて保存するツールです(デフォルトの ? アイコンの人がいればそれも取得可能)。

Open Steamworks + Windows .NET の習作として作りました。Steam を起動している状態で実行してないとエラーで落ちます。

ダウンロード

GetFriendAvators(2011/05/24) (スクリーンショット)

→ ソースコード (gist)

yp.kymt.me

Mon, 01 Jan 0001 00:00:00 +0000

Twitch や Livetube などの配信サイトの番組一覧を、PeerCast 用クライアント(pcyplite や PecaRecorder)に登録できる Yellow Page 形式で配信するサービスです。5分間隔で更新。

PeerCast のツールで、PeerCast 以外の配信サイトの番組もまとめてチェックできるようにする、という発想でした。

変更履歴(原文ママ)

2021/05/02: Fix twitch cralwer and stop livetube YP
2015/06/24: livetubeのcrawlに失敗していたので直した
2014/10/06: /livetubeindex.txtってところへのアクセスが結構あるので対応してみた
2014/06/20: 関連サイトのニコ生YPさんがDyndnsの問題で参照できなくなってたのでdeleteした(HTMLタグ的な意味で)
2013/02/03: own3d.tvがサービス終了したのでown3d.tvのYPは更新停止することに
2012/11/17: Twitch.tvのサイト変更で動作しなくなっていたのをDeveloper JSON APIを利用するように変更してfix
2012/07/12: livetube.ccサイト変更でうまく取得できてなかったのを修正
2012/07/12: twitch.tvサイトリニューアルでうまく取得できてなかったのを修正
2012/07/12: own3dサイトリニューアルでうまく取得できてなかったのを修正
2011/未明: 公開

対象サイトのリニューアルのたびにクローラーを直し続けた、10年間の記録でもあります。

→ yp.kymt.me(当時のページがそのまま残っています)

mizuho_bank

Fri, 17 Jun 2011 00:00:00 +0000

みずほダイレクト(みずほ銀行のインターネットバンキング)に Ruby からアクセスするためのライブラリです。Mechanize でログイン画面の遷移(お客さま番号 → 合言葉 → パスワード)を自動化し、口座残高や入出金明細を Ruby のオブジェクトとして取り出せます。

当時 gem として公開していました。API のない時代に、自分の口座情報をプログラムから扱うためのスクレイパーです。

gem install mizuho_bank

使い方はこんな感じです(README より)。認証情報はコードに直書きせず、アカウント情報管理の Pit から読み込む前提の作りです。

require 'mizuho_bank'
require 'pit'

pit = Pit.get("MizuhoBank", :require => {
 "keiyaku_no" => "keiyaku_no",
 "password" => "password",
 # 合言葉(秘密の質問)3組の question/answer も同様に登録しておく
})

aikotoba_dict = {
 pit['aikotoba1_question'] => pit['aikotoba1_answer'],
 pit['aikotoba2_question'] => pit['aikotoba2_answer'],
 pit['aikotoba3_question'] => pit['aikotoba3_answer']
}

MizuhoBank.new(pit['keiyaku_no'].to_s, pit['password'].to_s, aikotoba_dict){ |bank|
 p bank.info.main_account.money # 口座残高
 p bank.info.main_account.cache_flows # 最近の取引履歴
}

内部設計

コンポーネント構成です。中核の MizuhoBank クラスがログイン処理とページのパースを束ねていて、結果は MizuhoDirectInfo/MizuhoAccount/MizuhoCacheFlow というプレーンなデータクラスに詰めて返します。

ログインはステートマシン(lib/mizuho_bank.rb)—「次にどのページが来るか」を決め打ちにせず、what_is_this_page? が現在のページ本文に含まれる文言(「お客さま番号を入力し…」「合言葉確認」など)からページ種別を判定し、ループで対応する入力処理に振り分けます。銀行側が認証ステップを出したり出さなかったりしても追従できる作りです
合言葉(秘密の質問)対応 — 合言葉ページでは質問文を Nokogiri で抜き出し、コンストラクタに渡した「質問文 → 答え」の辞書(aikotoba_dict)を引いて回答します。3組の質問のどれが出ても対応できます
リトライ — ログイン処理全体を自作 gem の retry-handler で包んでいて、通信エラーなど一時的な失敗のときに 5 秒間隔で最大 5 回やり直します(認証情報の誤りを試行し直すためのものではありません)
サービス時間外の検知 — みずほダイレクトには定期メンテナンスの時間帯があり、公式の時間外案内ページをスクレイピングして「毎週土曜深夜」「第1・第4土曜」のパターンを RepeatDateRange に落とし、現在時刻がそこに入っていればログイン自体を止めます。「1st saturday in this month」のような英語表現を Chronic に渡して実時刻に解決しています
パース — ログイン後のトップページから利用者名・最終ログイン日時・代表口座(店名・取引種類・口座番号・残高・引き出し可能残高)と直近 10 件の入出金を、明細照会ページから月単位の入出金明細を、それぞれテーブルの位置指定(nth-child や添字)で抜き出します。サイトは Shift_JIS なので、入力値は tosjis、取得ページは toutf8 で変換しています

ログインから明細取得までの流れです。

MouseEPS

Wed, 20 Apr 2011 00:00:00 +0000

アプリケーションが WM_MOUSEMOVE 命令を1秒間にどれだけ受信できるかを表示するソフトです。

通常は127くらいだけど、USB ドライバの更新頻度(Hz)を修正するとその分だけアップさせることが出来ます。120Hz で127、500Hz で507ぐらい。どういう原理で Hz よりも +7 増えてるのかはよくわからない(プログラム的なバグはなさそうだけど謎)。

当時のスクリーンショットは残っていません。上の画像は配布 exe に埋め込まれていたダイアログ定義から再構成したバージョン情報画面です。メイン画面は受信レートの数値をウインドウに直接描画するだけの作りで、画面定義がリソースに残っていないため再構成していません。

ダウンロード

MouseEPS.zip

uc_card

Fri, 10 Feb 2012 00:00:00 +0000

UC カード(www.uccard.co.jp)の会員サイトから、未払いのクレジットカード取引履歴(利用明細)を取得する Ruby ライブラリです。Mechanize で会員サイトにログインして明細ページを開き、Nokogiri で HTML をパースして Ruby のオブジェクトとして返します。

gem として公開していて、同名のコマンドラインツールも同梱しています。

gem install uc_card
uc_card # 未払いの取引を一覧表示(オプションは一切ない)

README にある出力例です(利用先の名前は伏せてあります)。

2012/01/28: ****** 500 １回払い 1回
2012/01/26: ****** 5940 １回払い 1回
2012/01/22: ****** 3357 １回払い 1回
Total: 11722

ライブラリとして使うときはこう書きます。ID・パスワードはコードに直書きせず、認証情報管理ライブラリの pit から読み込む作りです。

require 'uc_card'
UCCard.start_with_pit("uccard.co.jp") do |card|
 puts card
end

内部設計

UCCard.start がログインから明細取得・ログアウトまでのライフサイクルを丸ごと面倒を見て、ブロックにはパース済みのインスタンスが渡ってきます。

UCCard.start — login → go_recent(明細取得)→ ブロック実行、と進み、ensure で必ず logout します。途中で例外が出てもログアウトだけは走る作りです
UCCard.start_with_pit — 認証情報を pit から取得して start に渡すショートカット。同梱の bin/uc_card コマンドはこれを呼んで puts card するだけの 5 行です
login — Mechanize(User-Agent は "Windows IE 7" を名乗ります)でログインページを開き、フォームの ID・パスワード欄を埋めて送信します
go_recent —「最近のご利用明細」ページを取得し、Nokogiri で明細テーブルの行を ShoppingData(date・klass・name・value・usecase・times・note・payment の 8 項目)の配列にパースします。README の出力例でいうと「１回払い」が usecase、「1回」が times です
ShoppingData#money — 金額文字列から数字以外を取り除いて整数化します。reserved_payment はその合計で、これが Total: 行になります(reserved_payment_this_month というメソッドも生えていますが空実装のままです)
依存 gem は mechanize・nokogiri・pit の 3 つです

README には、SSL 証明書のエラーが出る場合は ruby -ropenssl -e "p OpenSSL::X509::DEFAULT_CERT_FILE" で証明書のパスを探して適切な証明書を入れるように、という注意書きがあります。

SoundTest

Sat, 16 Apr 2011 00:00:00 +0000

音の定位を確認するためのソフトです。OpenAL 使用。

中央に人間が居ると仮定して、押したボタンの位置に音を発生させ、前後左右斜めの8方向の定位を診断します(説明文はウインドウ内のものが当時の原文)。

当時のスクリーンショットは残っていなかったため、この画像は配布 exe に埋め込まれていたダイアログ定義(ボタン・文言・座標)をそのまま描画し直した復元です。

ダウンロード

SoundTest.zip

net-irc-mala

Fri, 10 Feb 2012 00:00:00 +0000

mala のタイムラインを IRC で読むためのゲートウェイです。手元で小さな IRC サーバーとして動き、IRC クライアントで接続すると #malastream チャンネルに発言がリアルタイムで流れてきます。

コードから読み取れる範囲では、接続先は http://api.ma.la/home_timeline/stream というストリーミング API で、本文(text)と発言者(user.screen_name)を持つ JSON が届く、マイクロブログ的なタイムラインです。

内部設計

IRC クライアントとストリーミング API の間の流れです。

mig.rb(bin/mig.rb)— 同梱の実行コマンド。Net::IRC::CLI.run(Net::IRC::Mala, ARGV) の 1 行だけで、起動処理はすべて CLI 側に任せています
Net::IRC::CLI(lib/net/irc/cli.rb)— OptionParser でオプション(-p ポート、-h ホスト、-l ログファイル、--debug、-f フォアグラウンド)を解釈し、net-irc gem の Net::IRC::Server を起動します。デフォルトは localhost:16701 で待ち受け、fork + setsid でデーモン化します(--debug/-f 時はフォアグラウンド)。ログは Logger の日次ローテーションです
Net::IRC::Mala(lib/net/irc/mala.rb)— net-irc の Net::IRC::Server::Session を継承したセッション本体。クライアントが USER 登録すると、#malastream に JOIN させてチャンネルモード(+mto と自分への +o/+q)を設定し、ストリーミング用のスレッドを起動します
ストリーミングスレッドは EventMachine + em-eventsource で API に Server-Sent Events 接続し、届いたメッセージを JSON としてパースして、screen_name を送信元にした PRIVMSG として #malastream に流します。パースに失敗したメッセージは STDERR にエラーを出して読み飛ばします
クライアントが切断するとストリーミングスレッドを kill します

サーバー名・チャンネル名などは Net::IRC::Mala にべた書きで、設定ファイルはありません。gem のバージョンは 0.0.1 です。

kimotter

Fri, 20 Jan 2012 00:00:00 +0000

コマンドラインからツイートを投稿する Ruby 製クライアントです。Twitter API を直接は使わず、mala API(http://api.ma.la/twitter/ にあった Web の投稿フォーム)を Mechanize で操作して投稿します。gem として公開していました。

使い方

Ruby 1.9 と nokogiri・mechanize が必要です(README 由来)。

gem install kimotter
kimotter "ツイート本文"

投稿の前に、ページから取り出した確認メッセージへの同意を求められます。README の実行例です。

> kimotter "EventSource知らんかった、普通に便利そう"
嘘偽りなく自分がキモトであると誓います[y/N] y
hi kimoto. try to tweet your cool message
done!

オプションは -d, --debug(デバッグモード)と -f, --force(投稿前の API 制限チェックを飛ばして実行)の2つです。制限そのものはエンドポイント側で管理されているもので、--force が飛ばすのは自前の事前チェックだけです。

内部設計

コンポーネント構成です。全体で約170行の小さな gem で、フォーム操作をやる Kimotter クラスと、対話まわりを受け持つ KimotterCLI の2層でできています。

Kimotter(lib/kimotter.rb)— fetch_api_limit(エンドポイントを GET して API 制限値と確認メッセージをパース)、tweet(投稿フォームの status に本文を入れ、is_kimoto チェックボックスにチェックして submit)、api_limit?(使用数が上限に達したかの判定)を提供します
HTML のパース(load_from_mala_html)は Nokogiri でやります。body テキストの API Limit: 使用数 / 上限 を正規表現で読み、フォームのチェックボックスの隣にあるテキストを確認メッセージとして取り出します
filter メソッドは投稿前に本文を加工するためのフックで、デフォルトは素通しです(コードのコメントに「必要ならオーバーライドして」とあります)
KimotterCLI(lib/kimotter_cli.rb)— オプション解析(-d/-f/-a(エンドポイント URL の差し替え))、本文の受け取り、API 制限チェック、y/N 確認、終了コードの出し分けをやります。引数に本文がないときは $EDITOR を一時ファイル相手に起動して書かせ、改行はスペースに置換します
bin/kimotter / bin/koiketter — どちらも中身は KimotterCLI.execute の呼び出しだけで、koiketter はエンドポイントを http://kimoto.ssig33.com/api に向けた別コマンドです

投稿1回の流れはこうなっています。

Fake sniper spray

Mon, 01 Jan 0001 00:00:00 +0000

TF2 用のネタスプレー。壁の角や窓のふちに貼ると、スナイパーが物陰から覗いては引っ込む動きをしているように見える、スナイパーの擬態(fake)スプレーです。

仕様変更でアニメーションスプレーは現在の TF2 では使えなくなりました。

復元アニメーション

当時のスクリーンショットや動画は残っていなかったため、配布していた VTF(Source のテクスチャ形式)をパースしてアニメーション PNG に復元しました。

RED スナイパーが横にスライドして画面外へ消え、また戻ってくる 11 フレームのループになっています。ゲーム内の実際の再生速度の記録は残っていないため、この APNG のフレーム間隔(200ms)は推定です。

ダウンロード

fake_sniper_spray.vtf - 当時配布していた原本

技術メモ

VTF 7.2、256×256、DXT5(アルファ付き)、11 フレーム、mipmap 1 枚
フラグは No Mipmap/No LOD/Eight Bit Alpha。VTF / VMT についての備忘録に書いた「キレイなスプレーの作り方」そのままの構成
アニメーション VTF はプレイ環境の FPS に依らず一定速度で再生される(同備忘録参照)
復元は VTF ヘッダをパースして DXT5 の各フレームをデコードし、APNG に合成したもの(2026-07)

pi.kymt.me

Tue, 25 Jun 2013 00:00:00 +0000

Amazon 画像版 jpg.to。

トップページは使い方の1行だけ、という作り(Wayback の 2012年12月スナップショットより)。pi.kymt.me/○○.jpg の形式で URL を作ると、○○の部分で Amazon を検索してマッチした商品の巨大な画像が返ってくる。

Retired on kymt.me

vrowser

内部設計

GyazoIM

範囲選択のデモ

3つの撮り方

範囲選択中のキー操作

アップロードと画像処理

名前について

l4d2.kymt.me

SQCN

機能概略

ダウンロード

gtasks

内部設計

GetFriendAvators

ダウンロード

yp.kymt.me

リスト

変更履歴(原文ママ)

mizuho_bank

内部設計

MouseEPS

ダウンロード

uc_card

内部設計

SoundTest

ダウンロード

net-irc-mala

内部設計

kimotter

使い方

内部設計

Fake sniper spray

復元アニメーション

ダウンロード

技術メモ

pi.kymt.me