OSDN Git Service

ファイル名をNicoCache互換にする
[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;">保存するファイル名に用いることができない文字の集合。<br>
246             ファイルシステム上許されていない文字を指定することを意図しています。<br>
247             文字のエスケープが必要になりますのでコンフィグ設定画面を使用することを推奨します(画面起動については「起動引数」の項参
248             照)。<br>
249           </td>
250         </tr>
251         <tr>
252           <td style="vertical-align: top;">savefilename.replace.to<br>
253           </td>
254           <td style="vertical-align: top;">上記で設定した各文字を、ここで設定した文字列に置き換えま
255             す。<br>
256           </td>
257         </tr>
258       </tbody>
259     </table>
260     <br>
261     <h3><a class="mozTocH2" name="mozTocId935686"></a>feedurl.txt の説明</h3>
262     <p>1行ごとに、対象とするRSSフィードのURLと抽出数をカンマ区切りで設定します。例えば、下記のようになります。</p>
263     <div style="margin-left: 40px;"><cite># カテゴリ合算 の マイリスト
264         ランキング(デイリー)の上位5件</cite><br>
265       <cite>http://www.nicovideo.jp/ranking/mylist/daily/all?rss=2.0, 5</cite><br>
266       <cite></cite></div>
267     <p>書式についてはファイル内のコメントも参照してみてください。</p>
268     <p><br>
269     </p>
270     <h3><a class="mozTocH2" name="mylist"></a>mylist.txt の説明</h3>
271     <p>注意:公開マイリストが対象です。「とりあえずマイリスト」には対応していません。<br>
272     </p>
273     <p>1行に1つのマイリスト番号を指定します。マイリスト番号とは、マイリストのURLに設定されている番号のことで、例えばURLが<br>
274     </p>
275     <p><a href="http://www.nicovideo.jp/my/mylist/#/19487823">http://www.nicovideo.jp/mylist/19487823</a></p>
276     <p>というマリストでは、マイリスト番号は19487823になります。従ってファイルには</p>
277     <p style="margin-left: 40px;"><cite>19487823 #コメントをつけることもできます<br>
278       </cite></p>
279     <p>と記載します。2つ以上指定するには、改行をはさみ<cite></cite></p>
280     <p style="margin-left: 40px;"><cite>123456<br>
281         987654</cite><br>
282     </p>
283     <p>というように指定します。<br>
284     </p>
285     <h2><a class="mozTocH2" name="mozTocId136534"></a>バージョンアップに関する注意事項</h2>
286     <h3><a class="mozTocH3" name="warn08"></a>ver.0.8.x 以前を使用していた場合の注意事項</h3>
287     <p>Javaの対応バージョンが6になりましたので、Java5では正常に実行できません。<br>
288     </p>
289     <h3><a class="mozTocH3" name="mozTocId870247"></a>ver.0.4.xを使用していた場合
290       の注意事項</h3>
291     <p>アップデート後(つまり今回のファイルで上書きした後)、1回目の起動前に以下のコマンドを実行する必要がある。実行しないとDB関連
292       のエラーとなり処理が継続できない。</p>
293     <p style="font-weight: bold;"><code>java -jar NicoBrowser.jar sync<span
294           style="font-family: sans-serif;">4<br>
295         </span></code></p>
296     <p>(引数に<span style="font-weight: bold;">sync4</span>をつけて実行する)</p>
297     <h3><a class="mozTocH3" name="mozTocId920310"></a>2009/05/24版以前を使用して
298       いた場合の注意事項</h3>
299     <p>アップデート後(つまり今回のファイルで上書きした後)、1回目の起動前に以下のコマンドを実行する必要がある。実行しないとDB関連
300       のエラーとなり処理が継続できない。</p>
301     <p style="font-weight: bold;"><code>java -jar NicoBrowser.jar sync</code></p>
302     <p>(引数に<span style="font-weight: bold;">sync</span>をつけて実行する)</p>
303     <h3><a class="mozTocH2" name="mozTocId116237"></a>2009/03/23版以前を使用して
304       いた場合の注意事項</h3>
305     <p>nicobrowser.propertiesの互換性は無いため、一旦リネーム(or 削除)してから<br>
306       実行する必要がある。こうすることで、新しいnicobrowser.propertiesが作成される。</p>
307     <p>path.dbの設定は、従来は"ファイル名"の指定だったが、現在は"ディレクトリ名"の指定に変わっていることに注意。</p>
308     <p>本体libディレクトリ以下について、構成が大きく変わっているため、libは上書きでなく置換することを推奨。<br>
309     </p>
310     <br>
311     <h2><a class="mozTocH2" name="mozTocId130181"></a>更新履歴</h2>
312     <p>2011/09/22 ver.0.11.0<br>
313       設定画面にプロキシサーバ設定追加。<br>
314       ロガーをslf4j+logbackに統一。<br>
315       オプショナルスレッドメッセージ取得対応。<br>
316       サムネイル情報取得API追加。<br>
317     </p>
318     <p>2011/08/21 ver.0.10.0<br>
319       http://ext.nicovideo.jp/api/getthumbinfo/sm* からの動画情報取得APIを追加<br>
320     </p>
321     <p>2011/08/20 ver.0.9.5<br>
322       コメント新仕様での過去ログ取得機能を実装(<a href="http://sourceforge.jp/ticket/browse.php?group_id=5166&amp;tid=26055">#26055</a>)<br>
323       waybackkey取得時のエラー対処(<a href="http://sourceforge.jp/ticket/browse.php?group_id=5166&amp;tid=26063">#26063</a>)<br>
324     </p>
325     <p>2011/08/15 ver.0.9.4<br>
326       公式動画のコメントがダウンロードできない問題を修正(<a href="http://sourceforge.jp/ticket/browse.php?group_id=5166&amp;tid=26044">#26044</a>)。<br>
327     </p>
328     <p>2011/08/15 ver.0.9.3<br>
329       2011/2/3から始まっているニコニコ動画サービスの新コメント仕様に対応したインタフェースを提供。<br>
330     </p>
331     <p>2011/08/15 ver.0.9.2<br>
332       いんきゅばす用にインタフェースを更新。<br>
333       リダイレクトが発生する場合(so動画)の対処方法を変更。<br>
334     </p>
335     <p>2011/08/06 ver.0.9.1<br>
336       feed参照先URLを更新<br>
337     </p>
338     <p>2011/08/05 ver.0.9.0<br>
339       設定画面改善。フィード、マイリスト設定ファイルを設定画面から起動できるように対応。<br>
340       マイリスト設定ファイルを分離。<br>
341       ターゲットをJava6に変更。<br>
342     </p>
343     <p>2010/10/30 ver.0.8.1<br>
344       coroid用ニコニコ動画サービスの検索ページフォーム変更対応。</p>
345     <p>2010/07/17 ver.0.8.0<br>
346       coroid用プロキシサーバ機能追加。(内部APIの追加のみ。)</p>
347     2010/06/03 ver.0.7.0<br>
348     coroid用検索機能追加。(内部APIの追加のみ。)
349     <p>2010/05/24 ver.0.6.1<br>
350       Java5で対応していなかったメソッドを削除。</p>
351     <p>2010/04/20 ver.0.6.0<br>
352       ダウンロードファイル名の命名規則を指定できる機能を追加。<br>
353     </p>
354     <p>2010/04/19 ver.0.5.1<br>
355       ver.0.4.xからのアップデートコマンドを実装。<br>
356     </p>
357     <p>2010/04/16 ver.0.5.0<br>
358       投稿者名が取得できなくなっていた問題の修正。<br>
359       DBアップデートファイルの保存場所変更。<br>
360       liquibaseがIDとして用いているファイル名を固定。これに伴い旧バージョンとの互換性は無くなった。<br>
361     </p>
362     <p>2009/12/30 ver.0.4.1<br>
363       READMEに改正著作権法に関して留意事項を記載。<br>
364     </p>
365     <p>2009/12/01 ver.0.4.0<br>
366       エコノミーモードのコンテンツをダウンロード対象から外すオプションを追加。<br>
367       動画IDがsoで始まる公式動画(<a href="http://dic.nicovideo.jp/a/id">参考</a>)のダウン
368       ロードが失敗 する問題に対処。<br>
369       投稿者プロフィール非公開のコンテンツダウンロードに失敗する問題に対処。<br>
370     </p>
371     <p>2009/12/01 ver.0.3.1<br>
372       コンフィグ編集時、マイリストのデータが壊れる問題に対応。<br>
373     </p>
374     <p>2009/11/30 ver.0.3.0<br>
375       コンフィグ設定画面を追加。</p>
376     <p>2009/11/26 ver.0.2.0<br>
377       download.waitプロパティを追加。</p>
378     <p>2009/11/13 ver.0.1.1<br>
379       Log4Jのインストールバージョン誤りを修正。</p>
380     <p>2009/11/13 ver.0.1<br>
381       永続化する情報に作者(投稿者)情報を追加。ipum用の対応。</p>
382     <p>2009/05/24<br>
383       デイリーランキング以外のフィードへ対応。<br>
384       一部のswfに対してアクセスできない問題の対応(新プレイヤ対応)。<br>
385       ログ出力の見直し。</p>
386     <p>2009/03/23<br>
387       動画ファイル取得時403をもらった場合、ファイルをダウンロードしないように対応。</p>
388     <p>2009/01/11<br>
389       視聴権限が無い動画を取得しようとした場合にアプリケーションが終了してしまう問題を修正。</p>
390     <p>2008/08/03<br>
391       ランキングのRSSをzioさん作ニコRSS<br>
392       http://zio3.net/nicoRss/Handler.ashx<br>
393       から本家<br>
394       http://www.nicovideo.jp/ranking/mylist/daily/all?rss=atom<br>
395       に変更した。</p>
396     <p>2008/04/09<br>
397       前回ダウンロード要求から5秒待ってから次のダウンロード要求を行うようウェイト処理を追加した。<br>
398       ターゲットをJDK6からJDK5に変更した。</p>
399     <p>2008/03/21<br>
400       公開マイリストを指定したダウンロードを可能とした。</p>
401     <p>2008/03/15<br>
402       ダウンロードする最低ランキングを指定可能とした。<br>
403       ファイル名にドットが入っていた場合にもアンダーバーに<br>
404       置換するよう置換規則を追加(Craving Explorerに合わせた)。</p>
405   </body>
406 </html>