OSDN Git Service

Java5で動作するように修正。(1.6で導入されたメソッドを削除)
[coroid/NicoBrowser.git] / README.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">\r
2 <html lang="ja">\r
3 <head>\r
4   <meta content="text/html; charset=UTF-8" http-equiv="content-type">\r
5   <title>README</title>\r
6 </head>\r
7 <body>\r
8 <ul class="readonly" id="mozToc">\r
9 <!--mozToc h2 1 h3 2 h4 3-->\r
10   <li><a href="#mozTocId536975">改正著作権法について留意事項\r
11     </a></li>\r
12   <li><a href="#mozTocId600802">機能・特徴</a></li>\r
13   <li><a href="#mozTocId344177">使い方の一例</a></li>\r
14   <li><a href="#mozTocId180645">操作方法</a>\r
15     <ul>\r
16       <li><a href="#mozTocId241225">基本操作\r
17         </a></li>\r
18       <li><a href="#mozTocId84970">起動引数</a></li>\r
19     </ul>\r
20   </li>\r
21   <li><a href="#mozTocId782665">設定ファイルについて\r
22     </a>\r
23     <ul>\r
24       <li><a href="#mozTocId730811">nicobrowser.properties\r
25 の説明</a></li>\r
26       <li><a href="#mozTocId935686">feedurl.txt\r
27 の説明</a></li>\r
28     </ul>\r
29   </li>\r
30   <li><a href="#mozTocId136534">バージョンアップに関する注意事項</a>\r
31     <ul>\r
32       <li><a href="#mozTocId870247">ver.0.4.xを使用していた場合の注意事\r
33 項</a></li>\r
34       <li><a href="#mozTocId920310">2009/05/24版以前を使用していた場合\r
35 の注意事項</a></li>\r
36       <li><a href="#mozTocId116237">2009/03/23版以前を使用していた場合\r
37 の注意事項</a></li>\r
38     </ul>\r
39   </li>\r
40   <li><a href="#mozTocId130181">更新履歴</a></li>\r
41 </ul>\r
42 <p><br>\r
43 </p>\r
44 <h2><a class="mozTocH2" name="mozTocId536975"></a>改正著作権法について留意事項<br>\r
45 </h2>\r
46 <p>2010年1月1日より著作権法が改正されました。これに伴い、本プログラムの使用用途によっては改正著作権法に抵触する恐れがあります。詳細は以\r
47 下のペー\r
48 ジ、及びこのページのリンク先文化庁サイトを参照してください。<br>\r
49 <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>\r
50 </p>\r
51 <p><br>\r
52 </p>\r
53 <h2><a class="mozTocH2" name="mozTocId600802"></a>機能・特徴</h2>\r
54 <ul>\r
55   <li>ニコニコ動画に投稿された動画の自動ダウンロード</li>\r
56   <ul>\r
57     <li>ランキングの上位から自動ダウンロード</li>\r
58     <li>指定したマイリストから自動ダウンロード</li>\r
59   </ul>\r
60   <li>ダウンロード履歴管理</li>\r
61   <ul>\r
62     <li>一度ダウンロードした動画は重複してダウンロードされない</li>\r
63     <li>エコノミーモードでダウンロードしていた場合でも、高画質ファイルが取得できるのであれば再ダウンロードする</li>\r
64   </ul>\r
65   <li>Pure Javaであるため、Windows, MacOS, Linux上で動作可能</li>\r
66   <li><a\r
67  href="http://feather.cocolog-nifty.com/weblog/2009/11/ipum---1377.html">ipum</a>と\r
68 の連携でサムネイル付き音楽ファイルの自動生成が可能</li>\r
69 </ul>\r
70 <p><br>\r
71 </p>\r
72 <h2><a class="mozTocH1" name="mozTocId344177"></a>使い方の一例</h2>\r
73 <p><a\r
74  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>\r
75 <p><br>\r
76 </p>\r
77 <h2><a class="mozTocH1" name="mozTocId180645"></a>操作方法</h2>\r
78 <h3><a class="mozTocH3" name="mozTocId241225"></a>基本操作<br>\r
79 </h3>\r
80 <p>コマンドラインで以下を実行。</p>\r
81 <p style="font-weight: bold;"><code>java -jar\r
82 NicoBrowser.jar</code></p>\r
83 <p>1回目の起動では、このコマンドでコンフィグ設定画面が開きます。ここでID、パスワードを入力し保存してください。</p>\r
84 <p>設定後、再度実行すればダウンロードが開始されます。</p>\r
85 <p>詳細なダウンロード設定については「設定ファイルに\r
86 ついて」の項を参照。<br>\r
87 </p>\r
88 <h3><a class="mozTocH3" name="mozTocId84970"></a>起動引数</h3>\r
89 <table style="text-align: left; width: 337px; height: 88px;" border="1"\r
90  cellpadding="2" cellspacing="2">\r
91   <tbody>\r
92     <tr>\r
93       <td style="vertical-align: top;">-h<br>\r
94       </td>\r
95       <td style="vertical-align: top;">引数についてのヘルプを表示<br>\r
96       </td>\r
97     </tr>\r
98     <tr>\r
99       <td style="vertical-align: top;">-p<br>\r
100       </td>\r
101       <td style="vertical-align: top;">コンフィグ設定画面を起動<br>\r
102       </td>\r
103     </tr>\r
104     <tr>\r
105       <td style="vertical-align: top; width: 30px;">-v<br>\r
106       </td>\r
107       <td style="vertical-align: top;">バージョン情報を表示<br>\r
108       </td>\r
109     </tr>\r
110   </tbody>\r
111 </table>\r
112 <p>例えば以下のように実行します:<br>\r
113 </p>\r
114 <p><span style="font-weight: bold;">java -jar\r
115 NicoBrowser.jar -p<br>\r
116 </span></p>\r
117 <p><span style="font-weight: bold;"><br>\r
118 </span></p>\r
119 <h2><a class="mozTocH2" name="mozTocId782665"></a>設定ファイルについて<br>\r
120 </h2>\r
121 コンフィグファイルはアプリケーションディレクトリに作成されます。例えばWindowsXPであれば、以下のディレクトリになります。\r
122 <p>C:\Documents and Settings\user\.nicobrowser</p>\r
123 このディレクトリ以下のファイルを編集することで、好みのランキングやマイリストをダウンロード指定することが出来ます。\r
124 <h3><a class="mozTocH2" name="mozTocId730811"></a>nicobrowser.properties\r
125 の説明</h3>\r
126 <table style="text-align: left; width: 100%;" border="1" cellpadding="2"\r
127  cellspacing="2">\r
128   <tbody>\r
129     <tr>\r
130       <td style="vertical-align: top;">path.db<br>\r
131       </td>\r
132       <td style="vertical-align: top;">履歴管理DBを保存するディレクトリ。<br>\r
133       </td>\r
134     </tr>\r
135     <tr>\r
136       <td style="vertical-align: top;">path.savefile<br>\r
137       </td>\r
138       <td style="vertical-align: top;">ダウンロードした動画ファイルを保存するディレクトリ。<br>\r
139       </td>\r
140     </tr>\r
141     <tr>\r
142       <td style="vertical-align: top;">encoding<br>\r
143       </td>\r
144       <td style="vertical-align: top;">feedurl.txtの文字エンコーディング。通常はデフォルト値か\r
145 ら変更する必要はありません。<br>\r
146       </td>\r
147     </tr>\r
148     <tr>\r
149       <td style="vertical-align: top;">nicovideo.mail<br>\r
150       </td>\r
151       <td style="vertical-align: top;">ニコニコ動画ログインID(メールアドレス)。<br>\r
152       </td>\r
153     </tr>\r
154     <tr>\r
155       <td style="vertical-align: top;">nicovideo.password<br>\r
156       </td>\r
157       <td style="vertical-align: top;">ニコニコ動画ログインパスワード。<br>\r
158       </td>\r
159     </tr>\r
160     <tr>\r
161       <td style="vertical-align: top;">downloar.retry<br>\r
162       </td>\r
163       <td style="vertical-align: top;">ダウンロード試行回数。試行回数失敗した場合、次回以降ダウンロード対\r
164 象から除外されます。<br>\r
165       </td>\r
166     </tr>\r
167     <tr>\r
168       <td style="vertical-align: top;">download.wait<br>\r
169       </td>\r
170       <td style="vertical-align: top;">ダウンロード間隔(秒)。各ダウンロード処理を、最低でも指定した時間\r
171 空けてから実行します。<br>\r
172       </td>\r
173     </tr>\r
174     <tr>\r
175       <td style="vertical-align: top;">download.low<br>\r
176       </td>\r
177       <td style="vertical-align: top;">エコノミー動画をだうんろーどするかどうか。するばあいはtrue、し\r
178 ない場合はfalse。<br>\r
179       </td>\r
180     </tr>\r
181     <tr>\r
182       <td style="vertical-align: top;">download.mylist<br>\r
183       </td>\r
184       <td style="vertical-align: top;">ダウンロード対象のマイリストID。複数指定の場合はカンマ","で区\r
185 切って下さい。<br>\r
186 【具体例】<br>\r
187 http://www.nicovideo.jp/mylist/4573744<br>\r
188 http://www.nicovideo.jp/mylist/739988/1395449<br>\r
189 上記2個のマイリストを対象とする場合、<br>\r
190 download.mylist=<span style="font-weight: bold;">4573744,739988/1395449</span><br>\r
191 と、URLの mylist/ 以下をカンマで区切って指定します。<br>\r
192       </td>\r
193     </tr>\r
194     <tr>\r
195       <td style="vertical-align: top;">savefilename.pattern<br>\r
196       </td>\r
197       <td style="vertical-align: top;">保存するファイル名の命名規則。以下の記号を用いることができます。<br>\r
198 {title}: 動画タイトル<br>\r
199 {id}: ニコニコ動画ID<br>\r
200 {low}: エコノミー動画であれば"low"の文字列、通常動画は空文字列<br>\r
201 【具体例】<br>\r
202 [{id}]{title} (さきゅばす互換)<br>\r
203 {id}{low}_{title} (NicoCache互換)<br>\r
204       </td>\r
205     </tr>\r
206     <tr>\r
207       <td style="vertical-align: top;">savefilename.replace.from<br>\r
208       </td>\r
209       <td style="vertical-align: top;">保存するファイル名に用いることができない文字の集合。<br>\r
210 ファイルシステム上許されていない文字を指定することを意図しています。<br>\r
211 文字のエスケープが必要になりますのでコンフィグ設定画面を使用することを推奨します(画面起動については「起動引数」の項参照)。<br>\r
212       </td>\r
213     </tr>\r
214     <tr>\r
215       <td style="vertical-align: top;">savefilename.replace.to<br>\r
216       </td>\r
217       <td style="vertical-align: top;">上記で設定した各文字を、ここで設定した文字列に置き換えます。<br>\r
218       </td>\r
219     </tr>\r
220   </tbody>\r
221 </table>\r
222 <br>\r
223 <h3><a class="mozTocH2" name="mozTocId935686"></a>feedurl.txt\r
224 の説明</h3>\r
225 <p>1行ごとに、対象とするRSSフィードのURLと抽出数をカンマ区切りで設定します。<br>\r
226 書式についてはファイル内のコメントを参照してください。<br>\r
227 </p>\r
228 <p><br>\r
229 </p>\r
230 <h2><a class="mozTocH2" name="mozTocId136534"></a>バージョンアップに関する注意事項</h2>\r
231 <h3><a class="mozTocH3" name="mozTocId870247"></a>ver.0.4.xを使用していた場合の注意事\r
232 項</h3>\r
233 <p>アップデート後(つまり今回のファイルで上書きした後)、1回目の起動前に以下のコマンドを実行する必要がある。実行しないとDB関連\r
234 のエラーとなり処理が継続できない。</p>\r
235 <p style="font-weight: bold;"><code>java -jar\r
236 NicoBrowser.jar sync<span style="font-family: sans-serif;">4<br>\r
237 </span></code></p>\r
238 <p>(引数に<span style="font-weight: bold;">sync4</span>をつけて実行する)</p>\r
239 <h3><a class="mozTocH3" name="mozTocId920310"></a>2009/05/24版以前を使用していた場合\r
240 の注意事項</h3>\r
241 <p>アップデート後(つまり今回のファイルで上書きした後)、1回目の起動前に以下のコマンドを実行する必要がある。実行しないとDB関連\r
242 のエラーとなり処理が継続できない。</p>\r
243 <p style="font-weight: bold;"><code>java -jar\r
244 NicoBrowser.jar sync</code></p>\r
245 <p>(引数に<span style="font-weight: bold;">sync</span>をつけて実行する)</p>\r
246 <h3><a class="mozTocH2" name="mozTocId116237"></a>2009/03/23版以前を使用していた場合\r
247 の注意事項</h3>\r
248 <p>nicobrowser.propertiesの互換性は無いため、一旦リネーム(or 削除)してから<br>\r
249 実行する必要がある。こうすることで、新しいnicobrowser.propertiesが作成される。</p>\r
250 <p>path.dbの設定は、従来は"ファイル名"の指定だったが、現在は"ディレクトリ名"の指定に変わっていることに注意。</p>\r
251 <p>本体libディレクトリ以下について、構成が大きく変わっているため、libは上書きでなく置換することを推奨。<br>\r
252 </p>\r
253 <br>\r
254 <h2><a class="mozTocH2" name="mozTocId130181"></a>更新履歴</h2>\r
255 <p>2010/04/20 ver.0.6.0<br>\r
256 ダウンロードファイル名の命名規則を指定できる機能を追加。<br>\r
257 </p>\r
258 <p>2010/04/19 ver.0.5.1<br>\r
259 ver.0.4.xからのアップデートコマンドを実装。<br>\r
260 </p>\r
261 <p>2010/04/16 ver.0.5.0<br>\r
262 投稿者名が取得できなくなっていた問題の修正。<br>\r
263 DBアップデートファイルの保存場所変更。<br>\r
264 liquibaseがIDとして用いているファイル名を固定。これに伴い旧バージョンとの互換性は無くなった。<br>\r
265 </p>\r
266 <p>2009/12/30 ver.0.4.1<br>\r
267 READMEに改正著作権法に関して留意事項を記載。<br>\r
268 </p>\r
269 <p>2009/12/01 ver.0.4.0<br>\r
270 エコノミーモードのコンテンツをダウンロード対象から外すオプションを追加。<br>\r
271 動画IDがsoで始まる公式動画(<a href="http://dic.nicovideo.jp/a/id">参考</a>)のダウンロードが失敗\r
272 する問題に対処。<br>\r
273 投稿者プロフィール非公開のコンテンツダウンロードに失敗する問題に対処。<br>\r
274 </p>\r
275 <p>2009/12/01 ver.0.3.1<br>\r
276 コンフィグ編集時、マイリストのデータが壊れる問題に対応。<br>\r
277 </p>\r
278 <p>2009/11/30 ver.0.3.0<br>\r
279 コンフィグ設定画面を追加。</p>\r
280 <p>2009/11/26 ver.0.2.0<br>\r
281 download.waitプロパティを追加。</p>\r
282 <p>2009/11/13 ver.0.1.1<br>\r
283 Log4Jのインストールバージョン誤りを修正。</p>\r
284 <p>2009/11/13 ver.0.1<br>\r
285 永続化する情報に作者(投稿者)情報を追加。ipum用の対応。</p>\r
286 <p>2009/05/24<br>\r
287 デイリーランキング以外のフィードへ対応。<br>\r
288 一部のswfに対してアクセスできない問題の対応(新プレイヤ対応)。<br>\r
289 ログ出力の見直し。</p>\r
290 <p>2009/03/23<br>\r
291 動画ファイル取得時403をもらった場合、ファイルをダウンロードしないように対応。</p>\r
292 <p>2009/01/11<br>\r
293 視聴権限が無い動画を取得しようとした場合にアプリケーションが終了してしまう問題を修正。</p>\r
294 <p>2008/08/03<br>\r
295 ランキングのRSSをzioさん作ニコRSS<br>\r
296 http://zio3.net/nicoRss/Handler.ashx<br>\r
297 から本家<br>\r
298 http://www.nicovideo.jp/ranking/mylist/daily/all?rss=atom<br>\r
299 に変更した。</p>\r
300 <p>2008/04/09<br>\r
301 前回ダウンロード要求から5秒待ってから次のダウンロード要求を行うようウェイト処理を追加した。<br>\r
302 ターゲットをJDK6からJDK5に変更した。</p>\r
303 <p>2008/03/21<br>\r
304 公開マイリストを指定したダウンロードを可能とした。</p>\r
305 <p>2008/03/15<br>\r
306 ダウンロードする最低ランキングを指定可能とした。<br>\r
307 ファイル名にドットが入っていた場合にもアンダーバーに<br>\r
308 置換するよう置換規則を追加(Craving Explorerに合わせた)。</p>\r
309 </body>\r
310 </html>\r