Software on kymt.me

Gauss

Fri, 29 Apr 2011 00:00:00 +0000

画面の明るさを変更するソフトウェアです。主に FPS ゲーマー向けで、設定を変更すると以下の画像のように暗いところが見やすくなります。正しくは明るさの変更ではなく、画面の暗い範囲の色だけを明るい色にすることで、モニタの明るさを一切変えずに相対的に暗いところを見えやすくします(これをガンマ変更と呼ぶ)。

特徴

モニタの明るさ(ガンマ値)を変更出来る
マルチモニタ環境ではモニタごとに異なる明るさを設定可能
キーボードショートカット対応デフォルトは Ctrl + PageUp で明るさアップ、Ctrl + PageDown で明るさダウン、Ctrl + Reset で初期状態(変更可能)
デスクトップに現在の明るさ設定を保存したショートカットを作成可能作成したものをダブルクリックですぐにその設定に変更することが出来ます

使い方

起動するとタスクトレイに常駐(起動しっぱなしで待機)します。アイコンを左クリックすると「全体のガンマ調節」ダイアログが開き、右クリックすると設定メニュー(下の画像)が開きます。

右クリックメニューの各項目は次の通りです。

「(モニタ名)調節」 … マルチモニタ環境でのみ、モニタの台数分表示されます。そのモニタだけのガンマを個別に調整するダイアログを開きます
全体調整 … すべてのモニタに共通のガンマを調整する「全体のガンマ調節」ダイアログを開きます(左クリックと同じ)
リセット … 全体・RGB 別のガンマをすべて初期状態に戻します
キー設定 … キーボードショートカットの割り当てを変更します。「明るくする」「暗くする」「リセット」それぞれの「設定」ボタンを押してから好きなキーを押すと、そのキーが割り当てられます。「デフォルト」でデフォルトの割り当てに戻ります
終了 … アプリケーションを終了します

「全体のガンマ調節」ダイアログでは、スライダーまたは数値入力で全体のガンマを、「RGB 別」欄で R/G/B それぞれのガンマを個別に調整できます。「ショートカット作成」ボタンを押すと、そのときの設定を保存したショートカットがデスクトップに作成され、以後はダブルクリックするだけで同じ設定に切り替えられます。

なお、設定ダイアログはマウスカーソルの近くに表示されるようにしてあり、マウスの移動距離が少しでも減るようにしています。

ダウンロード

Windows7(32/64bit):Gauss_latest.zip

※1: 動作確認しているのは上記環境だけですが、もしかしたら他の環境でも動作するかもしれません

※2: グラフィックボードがガンマ変更に対応していない場合動作しません

retry-handler

Mon, 13 Jul 2009 00:00:00 +0000

「失敗したら N 回リトライする」という処理を簡単に書けるようにする Ruby ライブラリです。Proc に retry メソッドを生やして、リトライしたい処理をブロックで包むだけで最大回数・待ち時間・対象例外を指定したリトライができます。

gem として公開していて、Ruby 1.8/1.9 で動きます。

gem install retry-handler

使い方

Proc のブロック内で例外が発生すると、指定回数まで自動でリトライします。

Proc.new{
 # なんかエラーの起こるコード
}.retry(:max => 3, :accept_exception => StandardError)

:wait を指定すると失敗のたびに指定秒だけ待ってから次の試行に入ります。処理の流れを可視化したいときは :logger を付けます。Proc.new と書くのがダサいときは lambda でも使えます。

lambda{}.retry(:max => 3, :wait => 3)
lambda{}.retry(:max => 3, :wait => 3, :logger => Logger.new(STDERR))

Method オブジェクトにも retry が生えるので、既存メソッドをそのままリトライ対応にできます。File.read の例です。

File.method(:read).retry("./not_found.txt",
 :accept_exception => StandardError, :logger => Logger.new(STDERR))

内部設計

実体は 1 ファイル(lib/retry-handler.rb)で、中核は RetryHandler.retry_handler の 1 メソッドです。Proc#retry・Method#retry・Kernel#retry_handler はどれもそこへ委譲するモンキーパッチになっています。

オプションの既定値 — :max は 3 回、:wait は 1 秒、:timeout はなし(無制限)、:accept_exception は同梱の RetryError、:logger は Logger.new(nil)(何も出力しない)です
リトライ対象は :accept_exception で指定した例外だけです。既定値の RetryError を自分で投げることは普通ないので、実用上は README の例のように :accept_exception => StandardError などを渡す形になります。対象外の例外はそのまま素通しです
:timeout を指定すると timeout() でブロックを包み、時間超過時に :accept_exception の例外を送出させます。タイムアウトも「捕捉対象の例外」に化けるので、リトライループ側は例外の一種として一元的に扱えます
Method#retry は引数リストの末尾が Hash ならそれをオプションとして取り出し、残りをメソッド本体の引数として渡します

リトライループ本体(RetryHandler._retry_handler)の流れです。begin/rescue/retry の素直な作りで、失敗のたびにカウントを進めて sleep してやり直します。

ruby-qstat

Sat, 04 Feb 2012 00:00:00 +0000

ゲームサーバー統計取得ツールの QStat を Ruby から使うためのラッパー gem です。qstat コマンドを起動して、マスターサーバーからのサーバー一覧取得や、個別のゲームサーバーへの状態問い合わせの結果を、Ruby のオブジェクトとして返します。

README 記載の動作要件は Ruby 1.9 と QStat 2.12 です。

使い方

gem install ruby-qstat

README にある例です。

# マスターサーバーからサーバー一覧を取得
QStat.query_serverlist("hl2master.steampowered.com:27011", "stm", "left4dead2", maxping = 100)

# 個別サーバーの状態を取得
QStat.query("xxx.yyy.zzz.qqq", "a2s")

# 個別サーバーの状態を取得(サーバー情報のみ)
QStat.query_serverinfo("xxx.yyy.zzz.qqq", "a2s")

内部設計

ライブラリ本体は lib/ruby-qstat.rb の1ファイルで、API は QStat クラスのクラスメソッド群として提供します(インスタンス化はできない作りです)。qstat コマンドの起動は共通の exec_cmd に集約されていて、出力の形式によってパース経路が2系統に分かれます。

exec_cmd — Open3.popen3 で qstat を起動し、stdout を読むスレッドと stderr を Logger に流すスレッドの2本で出力を回収します。filter ブロックを渡すと、stdout を1行読むごとに判定して、条件が成立した時点で qstat プロセスを TERM で打ち切れます。qstat のパスは QStat.qstat_path=、ロガーは QStat.logger= で差し替えられます
XML 系(query_serverlist/qslist)— -xml オプション付きで起動して、出力を Nokogiri でパースします。Response オブジェクトが XML と DOM を保持し、valid?(先頭の server 要素の status が UP か)や to_ror(ActiveSupport の Hash.from_xml によるハッシュ化)を提供します
テキスト系(query/query_serverinfo)— -P(プレイヤー情報)・-R(サーバールール)付きのプレーンテキスト出力を正規表現でパースして ServerInfo を作ります。「no response」「DOWN」の応答もヘッダ行の正規表現で判定します
結果オブジェクト — ServerInfo(アドレス・サーバー名・マップ・人数・ping・status など)、PlayerInfo(名前・frags・プレイ時間。qstat の「1h 2m 3s」のような時間表記を秒に換算するパーサ入り)、Rule(protocol・gamedir・secure・version・game_tag などのサーバールール)。ServerInfo#playing_time は、いちばん長くプレイしているプレイヤーの時間を返します
ゲームタイプ推定 — ServerInfo#suggest_game_type は、gametype が取れなかったときにサーバールールの game_tag(@ 以降のカンマ区切りタグ)から推定し、それもなければ unknown を返します
文字コード対策 — qstat には常に -utf8 を付け、さらに String#force_convert_to(UTF-16BE を経由して不正なバイトを ? に置換してから戻す monkey patch)で、サーバー名などに混ざる壊れたバイト列を無害化します

サーバー一覧取得(query_serverlist)の流れです。maxping を超えるサーバーが現れた時点で qstat を打ち切る作りで、途中で切れた XML はそのまま Nokogiri に渡してパースします。

spraymaker

Sat, 18 Jun 2011 00:00:00 +0000

Valve の Source Engine 向けのスプレー(ゲーム内で壁などに貼る自作画像)を簡単に作成するためのツールです。画像ファイルをドラッグドロップするだけで変換できます。

詳細

256x256 サイズのスプレーを生成します
透過情報付きのファイルに対応しています
高品質の圧縮フォーマットで出力します(VXT5)
高画質設定のための VTF Flags を自動で付加します(NOMOD, NOLOD)
200以上の画像形式の読み込みに対応しています(ImageMagick で読み込める画像であればなんでも)
元画像のアスペクト比を維持します、その際空いた場所は透過ピクセルで自動で埋めてくれます
ディレクトリが指定された場合は再帰的(サブフォルダの中まで全部たどって)にすべてのファイルを変換します

実行例

元画像

変換後の VTF ファイル

(transparent)というのが実際には透明な部分になります。

ゲーム内

ダウンロード

Windows7(32/64bit):spraymaker_latest.zip (PGP)

※1 他の環境ではテストしていませんが、もしかしたら動くかもしれません。

※2 動作にはImageMagickがインストールされている必要があります。ImageMagick 6 系の配布ページから Q16 版をインストールしてください。(ImageMagick は画像処理ソフトウェアです)

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秒間隔で回す二段構えです。

mwheel++

Wed, 11 May 2011 00:00:00 +0000

マウスホイールイベントを、アクティブでないウインドウにも送信できるようにします。シンプルなプログラムですがとても便利です(Mac OSX や Linux の GNOME っぽい挙動になる)

詳細

タスクトレイアイコンをダブルクリックすることで一時的に無効化させることも出来ます。(再度ダブルクリックで有効化)

ダウンロード

Windows7(32/64bit):mwheel_plus(20110701).zip (PGP)

他の環境ではテストしていませんが、もしかしたら動くかもしれません。

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 のソースのみ、コンパイル済みの実行ファイルは配っていませんでした。

matchdata-highlight

Thu, 24 Nov 2011 00:00:00 +0000

正規表現のマッチ結果(Ruby の MatchData)に highlight メソッドを生やす小さな gem です。マッチした箇所の前後にマーカー文字列を挿し込んだ文字列を返します。マーカーを省略すると term/ansicolor の ANSI エスケープシーケンスが入り、ターミナル上でマッチ箇所が赤く表示されます。

ライブラリ本体は 1 ファイル約 40 行で、ソース末尾に呼び出し例がコメントで残っています。

puts "foobar foobar BAZ".match(/(foobar)/).highlight
puts /foobar/.match("foobar foobar BAZ").highlight("<B>", "</B>")
puts /foobar/.highlight("foobar foobar BAZ")
puts /foobar/.highlight("foobar foobar BAZ", :begin => '<B>', :end => '</B>')
puts /foobar/.highlight("foobar foobar BAZ", '<B>', '</B>')

内部設計

MatchData と Regexp の 2 クラスへのモンキーパッチだけでできています。処理の流れです。

MatchData#highlight — 引数の形だけを判定する入口です。引数なしか Hash ならそのまま、位置引数 2 つなら {:begin => args[0], :end => args[1]} に詰め替えて _highlight に渡します
MatchData#_highlight — 実体です。マーカーのデフォルトは :begin が Term::ANSIColor.red、:end が Term::ANSIColor.clear で、渡されたオプションを merge して上書きします
マーカーの挿入は、対象文字列(MatchData#string)を dup した上で、buf[self.begin(0), 0] = marker_begin とマッチ開始位置への幅ゼロ代入で行います。終了マーカーの挿入位置は self.end(0) + marker_begin.size で、先に挿し込んだ開始マーカーの分だけ後ろにずらしています
位置は begin(0)/end(0)、つまりマッチ全体だけを対象にしていて、キャプチャグループ単位のハイライトや複数マッチの一括ハイライトはしません
Regexp#highlight(target, *args) — self.match(target) を試して、マッチしたら MatchData#highlight に委譲、マッチしなければ target をそのまま返します。マッチの有無を気にせず文字列が返ってくる形です
gem の骨組みは jeweler 生成の雛形です(gemspec は Rakefile から生成、バージョン 0.1.0)。README は雛形のままで、テストも shoulda の雛形が残っています

l4d2.kymt.me

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

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

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

→ https://l4d2.kymt.me/

GSD_crosshair

Fri, 29 Apr 2011 00:00:00 +0000

ゲーム画面の中央に、好きな画像のクロスヘア(照準マーク)を常に表示するソフトです。DirectX(32bit)を利用しているソフトウェアで動作します。DirectX フック(他プログラムの動作に割り込む仕掛け)ライブラリの GSD を利用しています。

ダウンロード

Windows7(32/64bit):GSD_crosshair(20110701).zip (PGP)

DirectX10,11または64bit のソフトウェアには描画できないっぽいです。他の環境ではテストしていませんが、もしかしたら動くかもしれません。

カスタマイズ

crosshair.png が中央に描画されますので、好みの画像に差し替えることもできます。アルファチャンネルを適切に設定すれば指定の領域を透過させることもできます。初期状態の crosshair.png は Poohaltea さん作のものをサイズ調整して同梱しています。

VAC(チート検出)との関係

詳しくはGSD の仕組みについてのレポートを参照してください。

vpk

Fri, 13 Jul 2012 00:00:00 +0000

VPK("Valve Pak")は、Source Engine(Valve のゲームエンジン)で使われるアーカイブ形式です(Valve Developer Wiki の解説)。この vpk は、その VPK ファイルを Ruby で読み書きするライブラリで、VPK ファイルの展開と、ディレクトリを VPK にまとめる圧縮の両方ができます。

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

gem install vpk

require 'vpk'

# VPK ファイルを展開する
VPK::VPKFile.new("./path_to.vpk").extract_to("./")

# ディレクトリを VPK にまとめる
VPK::VPKFile.archive("./path_to_dir").write_to("./archive.vpk")

コマンドラインからはこう使います。-c はディレクトリと同名の .vpk を作り、-x はカレントディレクトリに展開します。

vpk -c some_dir # some_dir を some_dir.vpk に圧縮
vpk -x some_file.vpk # カレントディレクトリに展開

内部設計

実装しているのは VPK フォーマットのバージョン 1 です。ファイルは「12 バイトのヘッダ」「ファイル一覧を持つディレクトリ部」「中身を連結したデータ部」の三層でできています。

ディレクトリ部は「拡張子 → パス → ファイル名」の 3 段ツリーです。各要素は NUL 終端文字列で、空文字列がその段の終端。ルート直下のファイルはパスを半角スペース 1 文字で表します

ディレクトリ部の並び(例):
"vtf" ← 第 1 段: 拡張子
 "materials/vgui" ← 第 2 段: パス
 "logo" + エントリ情報(18 バイト) ← 第 3 段: ファイル名
 "" ← ファイル名の終端
 "" ← パスの終端
"" ← 拡張子の終端 = ディレクトリ部おわり

ファイルごとのエントリ情報は 18 バイト固定で、CRC・オフセット・長さなどを持ちます。データ部内の位置は entry_offset(ディレクトリ部の終端からの相対位置)で参照します。データ部はその名の通り、各ファイルのペイロードをそのまま連結したものです

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(当時のページがそのまま残っています)

kaiwa

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

飲み会とかの会話生成アプリ。

→ https://kymt.me/app/kaiwa

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

dice

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

サイコロアプリ。

→ https://kymt.me/app/dice

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

Rotate Sushi

Thu, 02 Jun 2011 00:00:00 +0000

巻き寿司の 3D モデルを、青い画面の中で回して見せるだけの Windows プログラムです。DirectX 9 のサンプル(DirectX SDK のチュートリアル「Meshes」)と同じ作りで、モデルだけを自分で用意した寿司に差し替えています。

再現イメージ

当時の実際の画面は YouTube の動画「Sushi.exeの実行例」に残っています。下のアニメーションはそれとは別に、配布していた exe とモデルから描画の条件を読み取り、AI が描き直した創作イメージです(実際の画面ではありません)。

モデルは原点からずれた位置に置かれているので、寿司はその場で回るのではなく、画面の中を大きく回る
1 周は約 6.3 秒(毎秒 1 ラジアン)
光は環境光だけなので陰影は無く、テクスチャの色がそのまま出る

ノートンに消された話

配り始めたその日、この寿司を回すだけの 10KB のプログラムが、ノートンアンチウイルスにウイルスとして消されました。もちろん誤検知です。おもしろいのは、中身を 1 バイトも変えずに、ファイル名を変えただけで判定が変わったことでした。いまはこのプログラムを配っていないので、ここにあるのは当時の記録です。

ノートンは、まずダウンロードしたときに警告を出しました。理由として並んでいたのは「ごく少数のユーザー」「ごく新しい」「未確認」の 3 つです。

実行すると「疑わしい動作をしていました」として止められ、削除されました。

そこで、次の順に確かめました。

メッセージボックスを出すだけのプログラムを Sushi.exe という名前で作ると、これも疑わしいファイルとして検知された
本物の寿司のプログラムを DxTest4.exe という名前でコンパイルすると、検知されない
それをコピーして Sushi.exe に名前を変えると、ウイルスとして検知された
2 と 3 のファイルは、MD5(ファイルの中身から計算する指紋のような値)まで一致していた

当時は、いくつかの「怪しい」条件が重なったのだろうと考えていました。ダウンロード元が知られていない、使っている人が世界に少ない、コンパイルしたときと名前が違う、昔 sushi.exe という名前のウイルスがあったのかもしれない、といった条件です(最後のものは当時も推測で、今回調べても確かめられませんでした)。同じファイルを試したほかのアンチウイルス 3 社は、何も言いませんでした。

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回の流れはこうなっています。

pi.kymt.me

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

Amazon 画像版 jpg.to。

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

Software on kymt.me

Gauss

特徴

使い方

ダウンロード

retry-handler

使い方

内部設計

ruby-qstat

使い方

内部設計

spraymaker

詳細

実行例

ダウンロード

vrowser

内部設計

mwheel++

詳細

ダウンロード

GyazoIM

範囲選択のデモ

3つの撮り方

範囲選択中のキー操作

アップロードと画像処理

名前について

matchdata-highlight

内部設計

l4d2.kymt.me

GSD_crosshair

ダウンロード

カスタマイズ

VAC(チート検出)との関係

vpk

内部設計

SQCN

機能概略

ダウンロード

gtasks

内部設計

GetFriendAvators

ダウンロード

yp.kymt.me

リスト

変更履歴(原文ママ)

kaiwa

mizuho_bank

内部設計

MouseEPS

ダウンロード

dice

uc_card

内部設計

SoundTest

ダウンロード

Rotate Sushi

再現イメージ

ノートンに消された話

net-irc-mala

内部設計

kimotter

使い方

内部設計

pi.kymt.me