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