OSDN Git Service

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