OSDN Git Service

更新履歴
[coroid/NicoBrowser.git] / README.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
2 <html lang="ja">
3   <head>
4     <meta content="text/html; charset=UTF-8" http-equiv="content-type">
5     <title>README</title>
6   </head>
7   <body>
8     <ul checked="true" class="readonly" id="mozToc">
9       <!--mozToc h2 1 h3 2 h4 3-->
10       <li><a href="#mozTocId536975">改正著作権法について留意事項 </a></li>
11       <li><a href="#mozTocId600802">機能・特徴</a></li>
12       <li><a href="#mozTocId344177">使い方の一例</a></li>
13       <li><a href="#mozTocId180645">操作方法</a>
14         <ul>
15           <li><a href="#mozTocId241225">基本操作 </a></li>
16           <li><a href="#mozTocId84970">起動引数</a></li>
17           <li><a href="#windowsrun">Windows の場合</a></li>
18         </ul>
19       </li>
20       <li><a href="#mozTocId782665">設定ファイルについて </a>
21         <ul>
22           <li><a href="#mozTocId730811">nicobrowser.properties の説明</a></li>
23           <li><a href="#mozTocId935686">feedurl.txt の説明</a></li>
24           <li><a href="#mylist">mylist.txt の説明</a></li>
25         </ul>
26       </li>
27       <li><a href="#mozTocId136534">バージョンアップに関する注意事項</a>
28         <ul>
29           <li><a href="#warn08">ver.0.8.x 以前を使用していた場合の注意事項</a></li>
30           <li><a href="#mozTocId870247">ver.0.4.xを使用していた場合の注意事項</a></li>
31           <li><a href="#mozTocId920310">2009/05/24版以前を使用していた場合の注意事項</a></li>
32           <li><a href="#mozTocId116237">2009/03/23版以前を使用していた場合の注意事項</a></li>
33         </ul>
34       </li>
35       <li><a href="#mozTocId130181">更新履歴</a></li>
36     </ul>
37     <p><br>
38     </p>
39     <h2><a class="mozTocH2" name="mozTocId536975"></a>改正著作権法について留意事項<br>
40     </h2>
41     <p>2010年1月1日より著作権法が改正されました。これに伴い、本プログラムの使用用途によっては改正著作権法に抵触する恐れがあります。
42       詳細は以 下のペー ジ、及びこのページのリンク先文化庁サイトを参照してください。<br>
43       <a href="http://feather.cocolog-nifty.com/weblog/2009/12/post-b7a9.html">http://feather.cocolog-nifty.com/weblog/2009/12/post-b7a9.html</a><br>
44     </p>
45     <p><br>
46     </p>
47     <h2><a class="mozTocH2" name="mozTocId600802"></a>機能・特徴</h2>
48     <ul>
49       <li>ニコニコ動画に投稿された動画の自動ダウンロード</li>
50       <ul>
51         <li>ランキングの上位から自動ダウンロード</li>
52         <li>指定したマイリストから自動ダウンロード</li>
53       </ul>
54       <li>ダウンロード履歴管理</li>
55       <ul>
56         <li>一度ダウンロードした動画は重複してダウンロードされない</li>
57         <li>エコノミーモードでダウンロードしていた場合でも、高画質ファイルが取得できるのであれば再ダウンロードする</li>
58       </ul>
59       <li>Pure Javaであるため、Windows, MacOS, Linux上で動作可能</li>
60       <li><a href="http://feather.cocolog-nifty.com/weblog/2009/11/ipum---1377.html">ipum</a>と
61         の連携でサムネイル付き音楽ファイルの自動生成が可能</li>
62     </ul>
63     <p><br>
64     </p>
65     <h2><a class="mozTocH1" name="mozTocId344177"></a>使い方の一例</h2>
66     <p><a href="http://feather.cocolog-nifty.com/weblog/2008/03/post_7d4b.html">http://feather.cocolog-nifty.com/weblog/2008/03/post_7d4b.html</a></p>
67     <p><br>
68     </p>
69     <h2><a class="mozTocH1" name="mozTocId180645"></a>操作方法</h2>
70     <h3><a class="mozTocH3" name="mozTocId241225"></a>基本操作<br>
71     </h3>
72     <p>コマンドラインで以下を実行。</p>
73     <p style="font-weight: bold;"><code>java -jar NicoBrowser.jar</code></p>
74     <p>1回目の起動では、このコマンドでコンフィグ設定画面が開きます。ここでID、パスワードを入力し保存してください。</p>
75     <p>設定後、再度実行すればダウンロードが開始されます。</p>
76     <p>詳細なダウンロード設定については「設定ファイルに ついて」の項を参照。<br>
77     </p>
78     <h3><a class="mozTocH3" name="mozTocId84970"></a>起動引数</h3>
79     <table style="text-align: left; width: 337px; height: 88px;" border="1"
80       cellpadding="2" cellspacing="2">
81       <tbody>
82         <tr>
83           <td style="vertical-align: top;">-h<br>
84           </td>
85           <td style="vertical-align: top;">引数についてのヘルプを表示<br>
86           </td>
87         </tr>
88         <tr>
89           <td style="vertical-align: top;">-p<br>
90           </td>
91           <td style="vertical-align: top;">コンフィグ設定画面を起動<br>
92           </td>
93         </tr>
94         <tr>
95           <td style="vertical-align: top; width: 30px;">-v<br>
96           </td>
97           <td style="vertical-align: top;">バージョン情報を表示<br>
98           </td>
99         </tr>
100       </tbody>
101     </table>
102     <p>例えば以下のように実行します:<br>
103     </p>
104     <p><span style="font-weight: bold;">java -jar NicoBrowser.jar -p<br>
105       </span></p>
106     <h3><a class="mozTocH2" name="windowsrun"></a>Windows の場合</h3>
107     <p>Windowsの場合はバッチファイルを用意していますので、そちらから起動することもできます。</p>
108     <table style="width: 544px; height: 45px;" border="1">
109       <tbody>
110         <tr>
111           <td>NicoBrowserSetting.vbs<br>
112           </td>
113           <td>設定画面を開きます(-pオプション実行)<br>
114           </td>
115         </tr>
116         <tr>
117           <td>NicoBrowserRun.bat<br>
118           </td>
119           <td>NicoBrowserを実行します(オプションなし実行)<br>
120           </td>
121         </tr>
122       </tbody>
123     </table>
124     <p><br>
125     </p>
126     <h2><a class="mozTocH2" name="mozTocId782665"></a>設定ファイルについて<br>
127     </h2>
128     コンフィグファイルはアプリケーションディレクトリに作成されます。例えばWindowsXPであれば、以下のディレクトリになります。
129     <p>C:\Documents and Settings\user\.nicobrowser</p>
130     このディレクトリ以下のファイルを編集することで、好みのランキングやマイリストをダウンロード指定することが出来ます。
131     <h3><a class="mozTocH2" name="mozTocId730811"></a>nicobrowser.propertiesの説明</h3>
132     <table style="text-align: left; width: 100%;" border="1" cellpadding="2"
133       cellspacing="2">
134       <tbody>
135         <tr>
136           <td style="vertical-align: top;">path.db<br>
137           </td>
138           <td style="vertical-align: top;">履歴管理DBを保存するディレクトリ。<br>
139           </td>
140         </tr>
141         <tr>
142           <td style="vertical-align: top;">path.savefile<br>
143           </td>
144           <td style="vertical-align: top;">ダウンロードした動画ファイルを保存するディレクトリ。<br>
145           </td>
146         </tr>
147         <tr>
148           <td style="vertical-align: top;">encoding<br>
149           </td>
150           <td style="vertical-align: top;">feedurl.txtの文字エンコーディング。通常はデフォ
151             ルト値から変更する必要はありません。<br>
152           </td>
153         </tr>
154         <tr>
155           <td style="vertical-align: top;">nicovideo.mail<br>
156           </td>
157           <td style="vertical-align: top;">ニコニコ動画ログインID(メールアドレス)。<br>
158           </td>
159         </tr>
160         <tr>
161           <td style="vertical-align: top;">nicovideo.password<br>
162           </td>
163           <td style="vertical-align: top;">ニコニコ動画ログインパスワード。<br>
164           </td>
165         </tr>
166         <tr>
167           <td style="vertical-align: top;">proxy.use<br>
168           </td>
169           <td style="vertical-align: top;">プロキシ経由で接続する場合はtrue。直接接続の場合は
170             false<br>
171           </td>
172         </tr>
173         <tr>
174           <td style="vertical-align: top;">proxy.host<br>
175           </td>
176           <td style="vertical-align: top;">プロキシサーバのホスト名。<br>
177           </td>
178         </tr>
179         <tr>
180           <td style="vertical-align: top;">proxy.port<br>
181           </td>
182           <td style="vertical-align: top;">プロキシサーバのポート番号。<br>
183           </td>
184         </tr>
185         <tr>
186           <td style="vertical-align: top;">downloar.retry<br>
187           </td>
188           <td style="vertical-align: top;">ダウンロード試行回数。試行回数失敗した場合、次回以降ダウン
189             ロード対象から除外されます。<br>
190           </td>
191         </tr>
192         <tr>
193           <td style="vertical-align: top;">download.wait<br>
194           </td>
195           <td style="vertical-align: top;">ダウンロード間隔(秒)。各ダウンロード処理を、最低でも指定
196             した時間 空けてから実行します。<br>
197           </td>
198         </tr>
199         <tr>
200           <td style="vertical-align: top;">download.low<br>
201           </td>
202           <td style="vertical-align: top;">エコノミー動画をダウンロードするかどうか。する場合は
203             true、しない場合はfalse。<br>
204           </td>
205         </tr>
206         <tr>
207           <td style="vertical-align: top;">download.mylist<br>
208           </td>
209           <td style="vertical-align: top;">この項目は使用せず、<a href="#mylist">mylist.txt</a>で
210             設定してくださ い。<br>
211             <br>
212             <span style="text-decoration: line-through;">ダウンロード対象のマイリスト
213               ID。複数指定の場合はカンマ","で区 切って下さい。</span><br style="text-decoration: line-through;">
214             <span style="text-decoration: line-through;"> 【具体例】</span><br
215               style="text-decoration: line-through;">
216             <span style="text-decoration: line-through;">
217               http://www.nicovideo.jp/mylist/4573744</span><br style="text-decoration: line-through;">
218             <span style="text-decoration: line-through;">
219               http://www.nicovideo.jp/mylist/739988/1395449</span><br style="text-decoration: line-through;">
220             <span style="text-decoration: line-through;">
221               上記2個のマイリストを対象とする場合、</span><br style="text-decoration: line-through;">
222             <span style="text-decoration: line-through;">
223               download.mylist=</span><span style="font-weight: bold; text-decoration: line-through;">4573744,739988/1395449</span><br
224               style="text-decoration: line-through;">
225             <span style="text-decoration: line-through;"> と、URLの mylist/
226               以下をカンマで区切って指定します。</span><br>
227           </td>
228         </tr>
229         <tr>
230           <td style="vertical-align: top;">savefilename.pattern<br>
231           </td>
232           <td style="vertical-align: top;">保存するファイル名の命名規則。以下の記号を用いることができ
233             ます。<br>
234             {title}: 動画タイトル<br>
235             {id}: ニコニコ動画ID<br>
236             {low}: エコノミー動画であれば"low"の文字列、通常動画は空文字列<br>
237             【具体例】<br>
238             [{id}]{title} (さきゅばす互換)<br>
239             {id}{low}_{title} (NicoCache互換)<br>
240           </td>
241         </tr>
242         <tr>
243           <td style="vertical-align: top;">savefilename.replace.from<br>
244           </td>
245           <td style="vertical-align: top;">
246             v0.12.0で削除。<br><br>
247             <span style="text-decoration: line-through;">
248             保存するファイル名に用いることができない文字の集合。<br>
249             ファイルシステム上許されていない文字を指定することを意図しています。<br>
250             文字のエスケープが必要になりますのでコンフィグ設定画面を使用することを推奨します(画面起動については「起動引数」の項参
251             照)。<br>
252             </span>
253           </td>
254         </tr>
255         <tr>
256           <td style="vertical-align: top;">savefilename.replace.to<br>
257           </td>
258           <td style="vertical-align: top;">
259             v0.12.0で削除。<br><br>
260             <span style="text-decoration: line-through;">
261             上記で設定した各文字を、ここで設定した文字列に置き換えます。<br>
262             </span>
263           </td>
264         </tr>
265       </tbody>
266     </table>
267     <br>
268     <h3><a class="mozTocH2" name="mozTocId935686"></a>feedurl.txt の説明</h3>
269     <p>1行ごとに、対象とするRSSフィードのURLと抽出数をカンマ区切りで設定します。例えば、下記のようになります。</p>
270     <div style="margin-left: 40px;"><cite># カテゴリ合算 の マイリスト
271         ランキング(デイリー)の上位5件</cite><br>
272       <cite>http://www.nicovideo.jp/ranking/mylist/daily/all?rss=2.0, 5</cite><br>
273       <cite></cite></div>
274     <p>書式についてはファイル内のコメントも参照してみてください。</p>
275     <p><br>
276     </p>
277     <h3><a class="mozTocH2" name="mylist"></a>mylist.txt の説明</h3>
278     <p>注意:公開マイリストが対象です。「とりあえずマイリスト」には対応していません。<br>
279     </p>
280     <p>1行に1つのマイリスト番号を指定します。マイリスト番号とは、マイリストのURLに設定されている番号のことで、例えばURLが<br>
281     </p>
282     <p><a href="http://www.nicovideo.jp/my/mylist/#/19487823">http://www.nicovideo.jp/mylist/19487823</a></p>
283     <p>というマリストでは、マイリスト番号は19487823になります。従ってファイルには</p>
284     <p style="margin-left: 40px;"><cite>19487823 #コメントをつけることもできます<br>
285       </cite></p>
286     <p>と記載します。2つ以上指定するには、改行をはさみ<cite></cite></p>
287     <p style="margin-left: 40px;"><cite>123456<br>
288         987654</cite><br>
289     </p>
290     <p>というように指定します。<br>
291     </p>
292     <h2><a class="mozTocH2" name="mozTocId136534"></a>バージョンアップに関する注意事項</h2>
293     <h3><a class="mozTocH3" name="warn08"></a>ver.0.8.x 以前を使用していた場合の注意事項</h3>
294     <p>Javaの対応バージョンが6になりましたので、Java5では正常に実行できません。<br>
295     </p>
296     <h3><a class="mozTocH3" name="mozTocId870247"></a>ver.0.4.xを使用していた場合
297       の注意事項</h3>
298     <p>アップデート後(つまり今回のファイルで上書きした後)、1回目の起動前に以下のコマンドを実行する必要がある。実行しないとDB関連
299       のエラーとなり処理が継続できない。</p>
300     <p style="font-weight: bold;"><code>java -jar NicoBrowser.jar sync<span
301           style="font-family: sans-serif;">4<br>
302         </span></code></p>
303     <p>(引数に<span style="font-weight: bold;">sync4</span>をつけて実行する)</p>
304     <h3><a class="mozTocH3" name="mozTocId920310"></a>2009/05/24版以前を使用して
305       いた場合の注意事項</h3>
306     <p>アップデート後(つまり今回のファイルで上書きした後)、1回目の起動前に以下のコマンドを実行する必要がある。実行しないとDB関連
307       のエラーとなり処理が継続できない。</p>
308     <p style="font-weight: bold;"><code>java -jar NicoBrowser.jar sync</code></p>
309     <p>(引数に<span style="font-weight: bold;">sync</span>をつけて実行する)</p>
310     <h3><a class="mozTocH2" name="mozTocId116237"></a>2009/03/23版以前を使用して
311       いた場合の注意事項</h3>
312     <p>nicobrowser.propertiesの互換性は無いため、一旦リネーム(or 削除)してから<br>
313       実行する必要がある。こうすることで、新しいnicobrowser.propertiesが作成される。</p>
314     <p>path.dbの設定は、従来は"ファイル名"の指定だったが、現在は"ディレクトリ名"の指定に変わっていることに注意。</p>
315     <p>本体libディレクトリ以下について、構成が大きく変わっているため、libは上書きでなく置換することを推奨。<br>
316     </p>
317     <br>
318     <h2><a class="mozTocH2" name="mozTocId130181"></a>更新履歴</h2>
319     <p>2012/07/03 ver.0.12.1<br>
320       ニコニコ動画 バージョンZero対応。
321     </p>
322     <p>2012/05/12 ver.0.12.0<br>
323       ファイル名禁則文字の処理方法を<a href="http://crus.biz/nicocache_nl/">NicoCache_nl</a>に準拠させる。<br>
324       上記変更に伴うGUIの修正(<a href="http://sourceforge.jp/ticket/browse.php?group_id=5166&amp;tid=27894">#27894</a>)。
325     </p>
326     <p>2011/09/22 ver.0.11.0<br>
327       設定画面にプロキシサーバ設定追加。<br>
328       ロガーをslf4j+logbackに統一。<br>
329       オプショナルスレッドメッセージ取得対応。<br>
330       サムネイル情報取得API追加。<br>
331     </p>
332     <p>2011/08/21 ver.0.10.0<br>
333       http://ext.nicovideo.jp/api/getthumbinfo/sm* からの動画情報取得APIを追加<br>
334     </p>
335     <p>2011/08/20 ver.0.9.5<br>
336       コメント新仕様での過去ログ取得機能を実装(<a href="http://sourceforge.jp/ticket/browse.php?group_id=5166&amp;tid=26055">#26055</a>)<br>
337       waybackkey取得時のエラー対処(<a href="http://sourceforge.jp/ticket/browse.php?group_id=5166&amp;tid=26063">#26063</a>)<br>
338     </p>
339     <p>2011/08/15 ver.0.9.4<br>
340       公式動画のコメントがダウンロードできない問題を修正(<a href="http://sourceforge.jp/ticket/browse.php?group_id=5166&amp;tid=26044">#26044</a>)。<br>
341     </p>
342     <p>2011/08/15 ver.0.9.3<br>
343       2011/2/3から始まっているニコニコ動画サービスの新コメント仕様に対応したインタフェースを提供。<br>
344     </p>
345     <p>2011/08/15 ver.0.9.2<br>
346       いんきゅばす用にインタフェースを更新。<br>
347       リダイレクトが発生する場合(so動画)の対処方法を変更。<br>
348     </p>
349     <p>2011/08/06 ver.0.9.1<br>
350       feed参照先URLを更新<br>
351     </p>
352     <p>2011/08/05 ver.0.9.0<br>
353       設定画面改善。フィード、マイリスト設定ファイルを設定画面から起動できるように対応。<br>
354       マイリスト設定ファイルを分離。<br>
355       ターゲットをJava6に変更。<br>
356     </p>
357     <p>2010/10/30 ver.0.8.1<br>
358       coroid用ニコニコ動画サービスの検索ページフォーム変更対応。</p>
359     <p>2010/07/17 ver.0.8.0<br>
360       coroid用プロキシサーバ機能追加。(内部APIの追加のみ。)</p>
361     2010/06/03 ver.0.7.0<br>
362     coroid用検索機能追加。(内部APIの追加のみ。)
363     <p>2010/05/24 ver.0.6.1<br>
364       Java5で対応していなかったメソッドを削除。</p>
365     <p>2010/04/20 ver.0.6.0<br>
366       ダウンロードファイル名の命名規則を指定できる機能を追加。<br>
367     </p>
368     <p>2010/04/19 ver.0.5.1<br>
369       ver.0.4.xからのアップデートコマンドを実装。<br>
370     </p>
371     <p>2010/04/16 ver.0.5.0<br>
372       投稿者名が取得できなくなっていた問題の修正。<br>
373       DBアップデートファイルの保存場所変更。<br>
374       liquibaseがIDとして用いているファイル名を固定。これに伴い旧バージョンとの互換性は無くなった。<br>
375     </p>
376     <p>2009/12/30 ver.0.4.1<br>
377       READMEに改正著作権法に関して留意事項を記載。<br>
378     </p>
379     <p>2009/12/01 ver.0.4.0<br>
380       エコノミーモードのコンテンツをダウンロード対象から外すオプションを追加。<br>
381       動画IDがsoで始まる公式動画(<a href="http://dic.nicovideo.jp/a/id">参考</a>)のダウン
382       ロードが失敗 する問題に対処。<br>
383       投稿者プロフィール非公開のコンテンツダウンロードに失敗する問題に対処。<br>
384     </p>
385     <p>2009/12/01 ver.0.3.1<br>
386       コンフィグ編集時、マイリストのデータが壊れる問題に対応。<br>
387     </p>
388     <p>2009/11/30 ver.0.3.0<br>
389       コンフィグ設定画面を追加。</p>
390     <p>2009/11/26 ver.0.2.0<br>
391       download.waitプロパティを追加。</p>
392     <p>2009/11/13 ver.0.1.1<br>
393       Log4Jのインストールバージョン誤りを修正。</p>
394     <p>2009/11/13 ver.0.1<br>
395       永続化する情報に作者(投稿者)情報を追加。ipum用の対応。</p>
396     <p>2009/05/24<br>
397       デイリーランキング以外のフィードへ対応。<br>
398       一部のswfに対してアクセスできない問題の対応(新プレイヤ対応)。<br>
399       ログ出力の見直し。</p>
400     <p>2009/03/23<br>
401       動画ファイル取得時403をもらった場合、ファイルをダウンロードしないように対応。</p>
402     <p>2009/01/11<br>
403       視聴権限が無い動画を取得しようとした場合にアプリケーションが終了してしまう問題を修正。</p>
404     <p>2008/08/03<br>
405       ランキングのRSSをzioさん作ニコRSS<br>
406       http://zio3.net/nicoRss/Handler.ashx<br>
407       から本家<br>
408       http://www.nicovideo.jp/ranking/mylist/daily/all?rss=atom<br>
409       に変更した。</p>
410     <p>2008/04/09<br>
411       前回ダウンロード要求から5秒待ってから次のダウンロード要求を行うようウェイト処理を追加した。<br>
412       ターゲットをJDK6からJDK5に変更した。</p>
413     <p>2008/03/21<br>
414       公開マイリストを指定したダウンロードを可能とした。</p>
415     <p>2008/03/15<br>
416       ダウンロードする最低ランキングを指定可能とした。<br>
417       ファイル名にドットが入っていた場合にもアンダーバーに<br>
418       置換するよう置換規則を追加(Craving Explorerに合わせた)。</p>
419   </body>
420 </html>