■■■ みくつべ♪ ■■■

【初めに】
本プログラムは、YouTubeより指定キーワードにて取得される動画を連続して再生するプログラムです。

対象となるOSはUbuntuのみです。
動作の確認はUbuntu9.10(amd64)のみで行われています。

本プログラムは、pythonを使用して書かれています。
GUIの部分には、PyGTKを使用しています。

以下のパッケージに依存しています。
python-gst0.10
python-gdata
youtube-dl
mplayer
※オプションでmplayerを使用しますが依存関係には含めています。

【インストール/tar玉の場合】
インストールは行いません。
アーカイブを任意のフォルダに展開してください。

以下のコマンドであらかじめ依存パッケージをインストールしておいてください。
sudo apt-get install python-gst0.10 python-gdata youtube-dl mplayer

【インストール/debの場合】
ダブルクリックでインストーラを起動してください。

【起動方法】
debでインストールした場合、ubuntuならサウンドとビデオのカテゴリにランチャを作成します。

tar玉で展開した場合は、端末から以下のコマンドで実行出来ます。
展開したフォルダに移動。
※~/直下に展開したものとします。

cd MikuTube
./MikuTube.py

※動画エンジンにmplayerを使用する場合にはコマンドラインの引数に-mplayerをつけてください。
なお、当然のことながらmplayerがインストールされてない場合には動作しません。
debでインストールした場合には、システム→設定→メインメニューからランチャを編集し、引数に-mplayerを追加します。

【使い方】
起動すると、いきなりYouTubeに接続して検索します。
そのため、ちょっと待たないと画面が出ません。(^^;

その他、YouTubeからのデータ取得に時間が掛かると、エラーが出たりします。
※プレイリストをSQLiteに切り替えた都合で、初期のプレイリスト作成などに時間が
掛かります。しばらく待つと再生が開始しますが、どうしても再生しないようなら連絡
をお願いします。
なお、PulseAudioの問題で、VirtualBoxや、wineと同時に使用する場合に、再生が出
来ない場合があることが報告されています。
Totem（動画プレイヤー）で、問題なく動画再生が可能な環境の場合は、みくつべ♪固
有の問題の可能性が高いので、その場合もご連絡願えると助かります。

右クリックでメニューが出ますので、適当に選択してください。
検索キーワードは見直すことをお勧めします。(^^;

キー操作
→：次の曲へ
←：前の曲へ
↑：音量UP
↓：音量DOWN
space:一時停止
ｆ:フルスクリーン切り替え
ｓ:プレイリストのシャッフル
ｂ:再生中の動画をブラウザで開く

右クリックメニューの「検索」からプレイリストの表示が可能
・再生する動画を設定可能(チェックされているもののみ再生)
・リストをダブルクリックで再生動画を選択
・キーワードでリストの絞り込みが可能
　※リストが絞り込まれるだけで、再生動画がリストのもののみになるわけではありません。
　　再生したい動画を探す際にご利用ください。
・プレイリストのシャッフルが可能

【変更履歴】
2009.12.21 v0.1   初版作成(人柱版)
2009.12.22 v0.2   人柱版0.2
2009.12.22 v0.3   人柱版0.3
2009.12.22 v0.3   人柱版0.3
・再生開始処理をちょっとだけ見直し。
2009.12.23 v0.4   人柱版0.4
・0.3の修正ではまだ問題が残っていたのを見直し。
・ダウンロードに再生が追いついてしまうと再生終了になる問題を修正。
2009.12.23 v0.5   人柱版0.5
・0.4で初期化ファイルが存在しない場合に、初期化する処理が実行されてない問題を修正。
・プレイリストを暫定的に搭載
2009.12.25 v0.6   β版公開
・常に前面に表示を追加
・右クリックメニューから再生対象外指定を可能に
　※プレイリストから再度再生対象に設定可能です。
2009.12.25 v0.7   β版公開
・検索結果の取得方法にバグあったのを修正
2009.12.25 v0.8   β版公開
・シャットダウン時に設定が保存されてないので、再生のたびに保存するように変更。
2009.12.25 v0.8.1 β版公開
・まだセグフォる場合があるようなので、トラップを追加
・ダイアログのタイトルが未設定だったのを設定
2009.12.26 v0.8.2 β版公開
・プレイリストのタイトルに「,」が含まれる場合、正常にタイトルを表示出来なくなる問題を修正
　→プレイリストの初期化が必要
・曲が最後まで再生されずに終了になった場合のリトライ処理を変更。
　10回トライしてダメなら次の曲へ
2009.12.26 v0.8.3 β版公開
・曲が最後まで再生されずに終了になった場合のリトライ処理を修正。
・debパッケージの依存関係にミス。修正。
・プレイリストに全体時間を表示。
2009.12.26 v0.8.5 β版公開
・Seekエラー発生時の振る舞いを変更。
　→リトライの一環に取り込み。なるべく連続再生をとぎらせない方針で。
2009.12.26 v0.8.6 β版公開
・メモリリークしているようなので、スレッドを使いまわすように修正。
2009.12.27 v0.8.7 β版公開
・ガベコレの設定を見直し。
2009.12.27 v0.8.9 β版公開
・動画ウィンドウの背景を黒に。
・fキーでフルスクリーンの切り替え機能
2009.12.30 v1.0.0 公開
・公開
・OSDに動画変更時にタイトル表示を追加
・エラーリトライ時の処理を変更
2009.12.30 v1.0.1 安定版バグフィックス
・ガベコレをpython処理に任せることにした。
・ダウンロード中のメニュー操作を禁止。
　→セグフォ対策
・ログ出力のマイナーなバグを修正
・一部スレッド処理を見直し(試験中)
2010.01.02 v1.0.2 安定版バグフィックス
・GStreamerのトリガを引くタイミングの見直し。
　→連続再生中にセグフォが発生することがある。
・音量操作時にOSD表示が行われるので抑制。
2010.01.04 v1.0.3 安定版バグフィックス
・GStreamerのインスタンスを再生の度に作り直すように変更。
　→連続再生中にセグフォが発生することがある。/メモリリーク対策。
2010.01.09 v1.1.0 機能追加
・検索キーワード指定時にソート順と一覧取得件数を設定可能にした。
2010.01.15 v1.1.1 バグフィックス
・エラーリトライ処理が意図通りに動作してない件を修正。
・2重起動の防止。
2010.01.16 v1.2.0 機能追加
・HD画質があれば、HD画質動画を表示するオプションを追加。
　→デフォルトは使用しない設定になります。右クリックメニューから選択。
2010.01.16 v1.2.1 バグフィックス
・HD画質使用オプションの設定が起動時にメニュー項目に反映されていない件を修正
2010.01.23 v1.2.2 バグフィックス&仕様変更
・動画取得中でもメニュー操作を可能にした。
・再検索時にエラーが発生していたのを修正。
・再検索時、または新規キーワードで検索時、既存のプレイリストで再生対象外にしていた動画は情報を保持するように変更。
　→時々再検索しないと評価順で検索している場合に、無意味なことから仕様を変更。
2010.01.31 v1.2.3 バグフィックス
・設定ファイルがないと起動しないというバグを修正
2010.02.20 v1.2.4 機能追加
・起動スプラッシュスクリーンを追加
・フルスクリーン切り替え時にツールチップが表示されない問題を修正
・プレイリストをXMLファイル管理からSQLite管理に切り替え。
　→起動時に既存のプレイリストを取り込みますが、問題ある場合には再検索をお願いします。<(_ _)>
・プレイリストに絞り込み機能を追加
2010.02.21 v1.2.5 機能追加＆バグフィックス
・プレイリストの曲番カラムのクリックでソートが可能になっていたのを禁止。
　→意図しないソート順でソートされていた。
・プレイリストをシャッフルして再生可能なオプションを追加。
・デフォルトのプレイリスト件数を100件に変更。
　→従来のプレイリストからインポートした時には影響なし。新規にインストール時のデフォルトを変更。
2010.02.21 v1.2.6 機能変更
・右クリックメニュー構成の見直し(機能の変更なし)
・プレイリスト画面にシャッフルボタンを追加。
・右クリックメニューのプレイリストにシャッフルを追加。
2010.02.21 v1.2.7.1 バグフィックス
・エラー発生時のリトライ処理にバグがあり、最初から再生が行われない場合がある件を修正。
・再生非対象の設定がDBに保存されていない件を修正。
2010.02.27 v1.2.7.2 バグフィックス&機能変更
・SQLiteのコミット処理を毎度実行していたので、トランザクションとして実行するように修正。
・プレイリスト表示の際、現在再生中の曲近辺にリストをスクロールするように変更。
2010.03.06 v1.2.7.3 バグフィックス
・GStreamerの使用モジュールを変更。メモリ使用量の軽減。
2010.03.20 v1.3 機能変更
・10.04LTS対応。
2010.03.21 v1.3.1 バグフィックス
・１曲目を再生中だとプレイリストが表示されない。
・再生エラーが頻発すると不安定になる。
・HD画質設定の場合の待ち時間ダウンロードファイルサイズを調整。
・再生エラー発生時の曲再開の処理が意図通りに動作してなかった。
2010.03.21 v1.3.1.1 バグフィックス
・起動時からエラーが発生していると終了できなくなる(メニューがでなくなる)件を修正。
2010.03.22 v1.3.1.2 バグフィックス
・Thread処理の初期化を見直し。
2010.03.29 v1.4 機能追加
・動画再生エンジンにMPlayerを使用するオプションを追加。
・youtube-dlがダウンロード失敗した場合には、次の曲へ移動するように変更。
・エラーメッセージのOSD表示をオプションにより行うかどうかを設定可能に。
　デフォルトはOSD表示を行います。
2010.03.29 v1.4.0.1 バグフィックス
・-mplayerオプション時に次曲が自動的に再生されない問題を修正。
2010.04.01 v1.4.0.3 仕様変更
・YouTubeの仕様変更に対応
2010.04.03 v1.4.1 仕様変更
・youtube-dlのオプション変更により、HD画質オプション指定を見直し。
　HD画質オプションを指定している場合には、従来よりも初期化に時間がかかるようになります。
2010.04.03 v1.4.1.1 バグフィックス
・MPlayerオプションで実行時にメニューの反応が悪い件に対応。
・MPlayerオプションで動画のアスペクト比が無視されている件に対応。保持するようにしました。
2010.04.05 v1.5.0.0 機能追加
・オプションメニューに設定ダイアログを追加
・設定ダイアログから動画エンジンの選択を可能にしました。デフォルトはGStreamerとなっています。
2010.04.08 v1.5.0.1 機能変更
・設定ダイアログをタブ化
・動画設定のタブでMPlayerの追加オプションを指定可能にしました。
　みくつべ♪専用設定が必要な場合にはここに記述してください。
・youtube-dlタブを追加しました。
　HD動画など、YouTubeの反応が遅い場合など、タイムアウト時間を長めに設定することで取得エラーを減らすことができます。
2010.04.09 v1.5.0.2 機能変更＆バグフィックス
・MPlayerオプション時の再生エラー発生処理を変更。
　再生中止→次曲再生を再生中止→最初から再生に変更しました。
　2回チャレンジして、それでもダメなら次曲を再生します。
・MPlayerに追加オプションを指定した際、不正なオプションが指定されていると正常に終了出来ない件を修正。
・youtube-dlのバージョンチェックが不適切だったので修正。
2010.04.09 v1.5.0.3 バグフィックス
・設定ダイアログで、OKボタンを押しても設定が保存されない場合がある件を修正。
・設定ダイアログで、キャンセルボタンを押しても設定が保存される場合がある件を修正。
2010.04.09 v1.5.0.4 バグフィックス
・初期化時にMikuTube.xmlファイルが存在しないと起動できない問題を修正。
・MikuTube.dbだけ存在しない場合に、起動できない問題を修正。
・シャッフルを指定しているのに、MikuTube.dbを作成し直す場合にシャッフルテーブルが作成されていない問題を修正。
2010.04.10 v1.5.0.5 機能変更
・MPlayerに不正なオプションが指定されている際に、起動できない問題を修正。
　厳密に取り扱っていましたが、Warningは、起動するように変更しました。
・設定画面にみつくべ♪のバージョンを表示するように変更。
2010.04.18 v1.5.0.6 バグフィックス
・openSUSEでMPlayerモード時に応答が返らなくなる問題を修正。
2010.04.25 v1.5.0.7 バグフィックス
・MPlayerモード時、アスペクト比自動修正の機能が動作しなくなっている問題を修正。
2010.04.28 v1.5.0.8 機能変更
・曲切り替え時のOSD表示をオプションで抑制可能にした。
・cキーでタイトル＋URL、CTRL+cでURLのみをクリップボードにコピーするようにした。
2010.04.29 v1.6.0.0
・GtkBuilderに対応。依存関係の見直し。
・youtube-dlに追加オプションを指定可能にした。
・sキーでシャッフルを実行可能にした。
・bキーで現在再生中の動画をブラウザで開くようにした。
2010.05.15 v1.6.0.1
・検索キーワードの履歴を保持するようにした。(現在のキーワード含め6件)
2010.05.21 v1.6.0.2
・オプションダイアログでの設定が保存されない場合がある問題を修正
2010.07.25 v1.6.0.3
・youtube-dlの仕様変更によりyoutube-dlに渡すオプションの修正
2010.11.28 v1.6.1.0
・オプションダイアログにエラーリトライを行わないフラグを追加
2010.11.28 v1.6.1.1
・設定ファイルの読み込み処理変更に伴うバグの混入の修正
2010.11.28 v1.6.1.2
・終了方法によってウィンドウの位置情報が保存されないバグの修正
2010.12.11 v1.6.2.0
・youtube-dlの仕様変更に伴い、youtube-dl相当の機能を包含
2012.03.02 v1.7.9.1
・連続再生時の待ち時間をなくすため、先読み機能を追加
2012.03.05 v1.8.0.2
・オプションダイアログにyoutube-dlを最新版にするためのボタンを追加


