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>設定画面を開きます<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
132
133
134
135
136
137
138
139
140
141       の説明</h3>
142     <table style="text-align: left; width: 100%;" border="1" cellpadding="2"
143       cellspacing="2">
144       <tbody>
145         <tr>
146           <td style="vertical-align: top;">path.db<br>
147           </td>
148           <td style="vertical-align: top;">履歴管理DBを保存するディレクトリ。<br>
149           </td>
150         </tr>
151         <tr>
152           <td style="vertical-align: top;">path.savefile<br>
153           </td>
154           <td style="vertical-align: top;">ダウンロードした動画ファイルを保存するディレクトリ。<br>
155           </td>
156         </tr>
157         <tr>
158           <td style="vertical-align: top;">encoding<br>
159           </td>
160           <td style="vertical-align: top;">feedurl.txtの文字エンコーディング。通常はデフォ
161             ルト値から変更する必要はありません。<br>
162           </td>
163         </tr>
164         <tr>
165           <td style="vertical-align: top;">nicovideo.mail<br>
166           </td>
167           <td style="vertical-align: top;">ニコニコ動画ログインID(メールアドレス)。<br>
168           </td>
169         </tr>
170         <tr>
171           <td style="vertical-align: top;">nicovideo.password<br>
172           </td>
173           <td style="vertical-align: top;">ニコニコ動画ログインパスワード。<br>
174           </td>
175         </tr>
176         <tr>
177           <td style="vertical-align: top;">downloar.retry<br>
178           </td>
179           <td style="vertical-align: top;">ダウンロード試行回数。試行回数失敗した場合、次回以降ダウン
180             ロード対象から除外されます。<br>
181           </td>
182         </tr>
183         <tr>
184           <td style="vertical-align: top;">download.wait<br>
185           </td>
186           <td style="vertical-align: top;">ダウンロード間隔(秒)。各ダウンロード処理を、最低でも指定
187             した時間 空けてから実行します。<br>
188           </td>
189         </tr>
190         <tr>
191           <td style="vertical-align: top;">download.low<br>
192           </td>
193           <td style="vertical-align: top;">エコノミー動画をダウンロードするかどうか。する場合は
194             true、しない場合はfalse。<br>
195           </td>
196         </tr>
197         <tr>
198           <td style="vertical-align: top;">download.mylist<br>
199           </td>
200           <td style="vertical-align: top;">この項目は使用せず、<a href="#mylist">mylist.txt</a>で
201             設定してくださ い。<br>
202             <br>
203             <span style="text-decoration: line-through;">ダウンロード対象のマイリスト
204               ID。複数指定の場合はカンマ","で区 切って下さい。</span><br style="text-decoration: line-through;">
205             <span style="text-decoration: line-through;"> 【具体例】</span><br
206               style="text-decoration: line-through;">
207             <span style="text-decoration: line-through;">
208               http://www.nicovideo.jp/mylist/4573744</span><br style="text-decoration: line-through;">
209             <span style="text-decoration: line-through;">
210               http://www.nicovideo.jp/mylist/739988/1395449</span><br style="text-decoration: line-through;">
211             <span style="text-decoration: line-through;">
212               上記2個のマイリストを対象とする場合、</span><br style="text-decoration: line-through;">
213             <span style="text-decoration: line-through;">
214               download.mylist=</span><span style="font-weight: bold; text-decoration: line-through;">4573744,739988/1395449</span><br
215               style="text-decoration: line-through;">
216             <span style="text-decoration: line-through;"> と、URLの mylist/
217               以下をカンマで区切って指定します。</span><br>
218           </td>
219         </tr>
220         <tr>
221           <td style="vertical-align: top;">savefilename.pattern<br>
222           </td>
223           <td style="vertical-align: top;">保存するファイル名の命名規則。以下の記号を用いることができ
224             ます。<br>
225             {title}: 動画タイトル<br>
226             {id}: ニコニコ動画ID<br>
227             {low}: エコノミー動画であれば"low"の文字列、通常動画は空文字列<br>
228             【具体例】<br>
229             [{id}]{title} (さきゅばす互換)<br>
230             {id}{low}_{title} (NicoCache互換)<br>
231           </td>
232         </tr>
233         <tr>
234           <td style="vertical-align: top;">savefilename.replace.from<br>
235           </td>
236           <td style="vertical-align: top;">保存するファイル名に用いることができない文字の集合。<br>
237             ファイルシステム上許されていない文字を指定することを意図しています。<br>
238             文字のエスケープが必要になりますのでコンフィグ設定画面を使用することを推奨します(画面起動については「起動引数」の項参
239             照)。<br>
240           </td>
241         </tr>
242         <tr>
243           <td style="vertical-align: top;">savefilename.replace.to<br>
244           </td>
245           <td style="vertical-align: top;">上記で設定した各文字を、ここで設定した文字列に置き換えま
246             す。<br>
247           </td>
248         </tr>
249       </tbody>
250     </table>
251     <br>
252     <h3><a class="mozTocH2" name="mozTocId935686"></a>feedurl.txt の説明</h3>
253     <p>1行ごとに、対象とするRSSフィードのURLと抽出数をカンマ区切りで設定します。例えば、下記のようになります。</p>
254     <div style="margin-left: 40px;"><cite># カテゴリ合算 の マイリスト
255         ランキング(デイリー)の上位5件</cite><br>
256       <cite>http://www.nicovideo.jp/ranking/mylist/daily/all?rss=2.0, 5</cite><br>
257       <cite></cite></div>
258     <p>書式についてはファイル内のコメントも参照してみてください。</p>
259     <p><br>
260     </p>
261     <h3><a class="mozTocH2" name="mylist"></a>mylist.txt の説明</h3>
262     <p>注意:公開マイリストが対象です。「とりあえずマイリスト」には対応していません。<br>
263     </p>
264     <p>1行に1つのマイリスト番号を指定します。マイリスト番号とは、マイリストのURLに設定されている番号のことで、例えばURLが<br>
265     </p>
266     <p><a href="http://www.nicovideo.jp/my/mylist/#/19487823">http://www.nicovideo.jp/mylist/19487823</a></p>
267     <p>というマリストでは、マイリスト番号は19487823になります。従ってファイルには</p>
268     <p style="margin-left: 40px;"><cite>19487823 #コメントをつけることもできます<br>
269       </cite></p>
270     <p>と記載します。2つ以上指定するには、改行をはさみ<cite></cite></p>
271     <p style="margin-left: 40px;"><cite>123456<br>
272         987654</cite><br>
273     </p>
274     <p>というように指定します。<br>
275     </p>
276     <h2><a class="mozTocH2" name="mozTocId136534"></a>バージョンアップに関する注意事項</h2>
277     <h3><a class="mozTocH3" name="warn08"></a>ver.0.8.x 以前を使用していた場合の注意事項</h3>
278     <p>Javaの対応バージョンが6になりましたので、Java5では正常に実行できません。<br>
279     </p>
280     <h3><a class="mozTocH3" name="mozTocId870247"></a>ver.0.4.xを使用していた場合
281       の注意事項</h3>
282     <p>アップデート後(つまり今回のファイルで上書きした後)、1回目の起動前に以下のコマンドを実行する必要がある。実行しないとDB関連
283       のエラーとなり処理が継続できない。</p>
284     <p style="font-weight: bold;"><code>java -jar NicoBrowser.jar sync<span
285           style="font-family: sans-serif;">4<br>
286         </span></code></p>
287     <p>(引数に<span style="font-weight: bold;">sync4</span>をつけて実行する)</p>
288     <h3><a class="mozTocH3" name="mozTocId920310"></a>2009/05/24版以前を使用して
289       いた場合の注意事項</h3>
290     <p>アップデート後(つまり今回のファイルで上書きした後)、1回目の起動前に以下のコマンドを実行する必要がある。実行しないとDB関連
291       のエラーとなり処理が継続できない。</p>
292     <p style="font-weight: bold;"><code>java -jar NicoBrowser.jar sync</code></p>
293     <p>(引数に<span style="font-weight: bold;">sync</span>をつけて実行する)</p>
294     <h3><a class="mozTocH2" name="mozTocId116237"></a>2009/03/23版以前を使用して
295       いた場合の注意事項</h3>
296     <p>nicobrowser.propertiesの互換性は無いため、一旦リネーム(or 削除)してから<br>
297       実行する必要がある。こうすることで、新しいnicobrowser.propertiesが作成される。</p>
298     <p>path.dbの設定は、従来は"ファイル名"の指定だったが、現在は"ディレクトリ名"の指定に変わっていることに注意。</p>
299     <p>本体libディレクトリ以下について、構成が大きく変わっているため、libは上書きでなく置換することを推奨。<br>
300     </p>
301     <br>
302     <h2><a class="mozTocH2" name="mozTocId130181"></a>更新履歴</h2>
303     <p>2011/08/06 ver.0.9.1<br>
304       feed参照先URLを更新<br>
305     </p>
306     <p>2011/08/05 ver.0.9.0<br>
307       設定画面改善。フィード、マイリスト設定ファイルを設定画面から起動できるように対応。<br>
308       マイリスト設定ファイルを分離。<br>
309       ターゲットをJava6に変更。<br>
310     </p>
311     <p>2010/10/30 ver.0.8.1<br>
312       coroid用ニコニコ動画サービスの検索ページフォーム変更対応。</p>
313     <p>2010/07/17 ver.0.8.0<br>
314       coroid用プロキシサーバ機能追加。(内部APIの追加のみ。)</p>
315     2010/06/03 ver.0.7.0<br>
316     coroid用検索機能追加。(内部APIの追加のみ。)
317     <p>2010/05/24 ver.0.6.1<br>
318       Java5で対応していなかったメソッドを削除。</p>
319     <p>2010/04/20 ver.0.6.0<br>
320       ダウンロードファイル名の命名規則を指定できる機能を追加。<br>
321     </p>
322     <p>2010/04/19 ver.0.5.1<br>
323       ver.0.4.xからのアップデートコマンドを実装。<br>
324     </p>
325     <p>2010/04/16 ver.0.5.0<br>
326       投稿者名が取得できなくなっていた問題の修正。<br>
327       DBアップデートファイルの保存場所変更。<br>
328       liquibaseがIDとして用いているファイル名を固定。これに伴い旧バージョンとの互換性は無くなった。<br>
329     </p>
330     <p>2009/12/30 ver.0.4.1<br>
331       READMEに改正著作権法に関して留意事項を記載。<br>
332     </p>
333     <p>2009/12/01 ver.0.4.0<br>
334       エコノミーモードのコンテンツをダウンロード対象から外すオプションを追加。<br>
335       動画IDがsoで始まる公式動画(<a href="http://dic.nicovideo.jp/a/id">参考</a>)のダウン
336       ロードが失敗 する問題に対処。<br>
337       投稿者プロフィール非公開のコンテンツダウンロードに失敗する問題に対処。<br>
338     </p>
339     <p>2009/12/01 ver.0.3.1<br>
340       コンフィグ編集時、マイリストのデータが壊れる問題に対応。<br>
341     </p>
342     <p>2009/11/30 ver.0.3.0<br>
343       コンフィグ設定画面を追加。</p>
344     <p>2009/11/26 ver.0.2.0<br>
345       download.waitプロパティを追加。</p>
346     <p>2009/11/13 ver.0.1.1<br>
347       Log4Jのインストールバージョン誤りを修正。</p>
348     <p>2009/11/13 ver.0.1<br>
349       永続化する情報に作者(投稿者)情報を追加。ipum用の対応。</p>
350     <p>2009/05/24<br>
351       デイリーランキング以外のフィードへ対応。<br>
352       一部のswfに対してアクセスできない問題の対応(新プレイヤ対応)。<br>
353       ログ出力の見直し。</p>
354     <p>2009/03/23<br>
355       動画ファイル取得時403をもらった場合、ファイルをダウンロードしないように対応。</p>
356     <p>2009/01/11<br>
357       視聴権限が無い動画を取得しようとした場合にアプリケーションが終了してしまう問題を修正。</p>
358     <p>2008/08/03<br>
359       ランキングのRSSをzioさん作ニコRSS<br>
360       http://zio3.net/nicoRss/Handler.ashx<br>
361       から本家<br>
362       http://www.nicovideo.jp/ranking/mylist/daily/all?rss=atom<br>
363       に変更した。</p>
364     <p>2008/04/09<br>
365       前回ダウンロード要求から5秒待ってから次のダウンロード要求を行うようウェイト処理を追加した。<br>
366       ターゲットをJDK6からJDK5に変更した。</p>
367     <p>2008/03/21<br>
368       公開マイリストを指定したダウンロードを可能とした。</p>
369     <p>2008/03/15<br>
370       ダウンロードする最低ランキングを指定可能とした。<br>
371       ファイル名にドットが入っていた場合にもアンダーバーに<br>
372       置換するよう置換規則を追加(Craving Explorerに合わせた)。</p>
373   </body>
374 </html>