CLIでGoogleハングアウトを使うことのメモ

ご多分にもれず、私もインスタントメッセンジャー（IM）をユビキタスなリアルタイムコミュニケーションツールとして常用している。そして、スマホだけでなく常用コンソールの端末エミュレータからこれが使えると、都合が良いことが多い。そこで以前は XMPP 準拠のいわゆる Jabber クライアント（ MCabber とか emacs-jabber とか）を利用していた。前述のように私は Google のハングアウトをよく使うけど、 XMPP でもハングアウトに接続できないということはないのだ。

しかしそれらによるメッセージ履歴はオンライン時のログ範囲なら表示されるものの、他のクライアントからの発信やオフライン時のやりとりは取得できない。 GUI のマルチプロトコルクライアント Pidgin でも同様で、 Chrome や Android なんかの Google オリジナルクライアントのように、会話履歴の同期はなされないのである。

ようするに仕組みの違いによるわけだが、殊にGoogleハングアウトがプロプライエタリな仕様であることによる。オープンソースの XMPP を除いて、普通の IM はプロトコルも含め仕様を公開しないのが通例である。

そこらへんをリバース・エンジニアリングで補い実装したのが hangups で、ターミナルでハングアウトに接続する TUI クライアントおよびライブラリのセットとなっている。

既にこのライブラリを利用したプロジェクトがいくつも立っており、ボットの類を中心に賑わいを見せている。README によれば、hangups はまだ開発の初期にあるのでAPIの変更もありうるとしている。

ここでは主に hangups の TUI クライアントについてとりあげる。

pip でインストールする。 hangups は Python 3.5 以上対応なので、 Python2/3 併存環境では pip3 を使う。

$ sudo pip3 install hangups

$ sudo pip install hangups

また、 Arch Linux では AUR に登録があるのでこちらを利用するのもいい。

$ yaourt -S hangups

hangups コマンドで起動する。

最初の起動時に Google アカウントでログインする。

メールアドレスとパスワード、また必要であればベリファイコードも入力するとログインできる。すると会話履歴リストとともにインターフェースが立ち上がる。

$ hangups
Sign in with your Google account:
Email: hogefuga@gmail.com
Password:

画面の最上段にタブが表示され、最初は Conversations という会話リストのタブのみだが、そこから会話を選ぶと新しくタブでその会話内容を表示してくれる。

トークンはデフォルトで ~/.cache/hangups/refresh_token.txt に保存されている。このファイルを削除すれば再びログイン要求のところから始められる。また、 --token-path オプションで別のトークンを指定し、他のアカウントでログインできる。複数のhangupsを別々のトークンで同時起動できるから、マルチアカウントでの利用が可能である。

$ hangups --token-path ~/.cache/hangups/myaccount1

$ hangups --token-path ~/.cache/hangups/myaccount2

なお hangups でのログイン状況は、 Google の 最近使用した端末 では iOS と表現される。

hangups は起動オプションも使えるが、設定ファイルに書くこともできる。デフォルトの設定ファイルは ~/.config/hangups/hangups.conf 。

設定内容は、設定ファイル等のロケーション、キーバインディング、日付フォーマット、カラースキームなど。

一例として、さきほどのキーを設定し、そしてテーマを Solarized Dark にして、日付と時刻の表記もちょっといじってみた。

# ~/.config/hangups/hagnups.conf

[General]
date-format: < %F %a >
time-format: (%T)

[Keybindings]
key-quit: ctrl x
key-page-down: ''
key-page-up: ''
key-next-tab: ctrl y

[Colors]
col-scheme: solarized-dark
col-inactive-tab-bg: black
col-active-tab-fg: black

設定書式は ConfigArgParse 準拠で、上では yaml 風に : 区切りで書いたが、 = や区切りなし、あるいは起動オプションと同じ -- 始まりの記述でもいけるはず（詳しくは ConfigArgParse · PyPI など参照のこと）。

以下オプションについて記す。なおこれらのオプションについてはヘルプ（ --help ）でみられる。

起動オプションのみに使える引数は以下のとおり。

これ以下は設定ファイルにも記せるオプション。

• Official
  • GitHub – tdryer/hangups: the first third-party instant messaging client for Google Hangouts
  • hangups — hangups 0.4.4 documentation
• Other references
  • GitHub – bw2/ConfigArgParse: A drop-in replacement for argparse that allows options to also be set via config files and/or environment variables.
  • ConfigArgParse · PyPI
  • Overview — Urwid 2.0.1
  • User Input — Urwid 2.0.1
  • Constants — Urwid 2.0.1
  • Display Attributes — Urwid 2.0.1