Skip to content

Latest commit

 

History

History

JsonUrlSaver

README.md

JsonUrlSaver

Copyright (C) 2025 Takym.

概要

JSON ファイル内の URL から資源をダウンロードして保存するツールです。 最新版及びソースコードは「https://github.com/Takym/Gradexor/tree/master/JsonUrlSaver/」からダウンロードできます。

このツールでは、キャッシュファイルを開く前に必ずダウンロードする必要があります。

使用法

ダウンロード

下記のコマンドを実行する事で、ファイルをダウンロードできます。 相対パスでも動作しますが、絶対パス（完全パス）を指定する事を推奨します。

> JsonUrlSaver.exe dir=<JSON ファイルを含むディレクトリへのパス>

ダウンロード中にエラーが発生する事がありますが、自動的に次のファイルに続行されます。 また、非 JSON ファイルを読み込んだ時のエラーは無視して構いません。

ZIP ファイルの展開

ディレクトリの代わりに、下記の様に ZIP ファイルを指定する事もできます。 ZIP ファイルは自動的に展開されます。

> JsonUrlSaver.exe zip=<JSON ファイルを含む ZIP ファイルへのパス>

ZIP ファイルの展開先は dir=... で指定できます。

> JsonUrlSaver.exe zip=<JSON ファイルを含む ZIP ファイルへのパス> dir=<ZIP ファイルの展開先のパス>

展開先が存在する場合、上書きエラーが発生します。回避するには、zipOverwrite=true を指定します。 ただし、このエラーを抑制すると、重要なデータが消えてしまう恐れがありますので、注意してご使用ください。

  • 展開先を既定値にする場合 
     > JsonUrlSaver.exe zip=<JSON ファイルを含む ZIP ファイルへのパス> zipOverwrite=true
  • 展開先を指定する場合 
     > JsonUrlSaver.exe zip=<JSON ファイルを含む ZIP ファイルへのパス> dir=<ZIP ファイルの展開先のパス> zipOverwrite=true

Slack からデータをダウンロードする

Slack からエクスポートして得られるアーカイブの JSON ファイルからファイルをダウンロードする時は、 token=... で User OAuth Token を指定する必要があります。 また、filters=slack を指定し、ダウンロードする URL を絞り込みます。

> JsonUrlSaver.exe zip=<Slack のアーカイブへのパス> token=<User OAuth Token> filters=slack

ワークスペースのセキュリティを保つ為には、User OAuth Token は使用後に直ちに破棄する様にしてください。

User OAuth Token の発行方法

  1. https://api.slack.com/apps/ にアクセスします。
  2. 「Create New App」をクリックします。
  3. 「From scratch」を選択します。
  4. 必要事項を入力してアプリを作成します。
  5. 左のメニューの「OAuth & Permissions」をクリックします。
  6. 「Scopes」の「Bot Token Scopes」と「User Token Scopes」の両方に「files:read」を追加します。
  7. ページ上部の「OAuth Tokens for Your Workspace」セクションからワークスペースへインストールします。
  8. 使い終わったら、「Revoke Tokens」ボタンをクリックします。

参考文献

表示

ダウンロードしたファイル（「キャッシュファイル」とも呼ばれます）は下記の手順で表示できます。 mode=openOnly を付ける場合、事前にダウンロードが必要になります。 同時にダウンロードも行う場合は mode=openOnly の代わりに doDownload=true doOpen=true を指定してください。

  1. 下記のコマンドでツールを起動します。 
    > JsonUrlSaver.exe /I
  2. ツールに入力が求められるので、下記の引数を渡します。空行を入力すると、引数の受け付けを停止します。 
    dir=<JSON ファイルを含むディレクトリへのパス>
json=<ここに URL を含む JSON 文字列を引用符付きで貼り付ける>
mode=openOnly
  3. 下記の様に、JSON 文字列ではなく URL を直接入力する事もできます。 
    dir=<JSON ファイルを含むディレクトリへのパス>
url=<表示するファイルの URL>
mode=openOnly

設定ファイル

appSettings.json を下記の様に書き換える事で、引数に dir=... を指定する必要が無くなります。

{
	"dir": "<JSON ファイルを含むディレクトリへのパス>"
}

ZIP ファイルの展開時の上書きエラーを常に抑制する場合、下記の設定を追加します。

{
	"zipOverwrite": true
}

完全な設定項目の一覧

{
	// ダウンロードを行うかどうかを制御します。
	"doDownload": true,

	// キャッシュファイルを開くかどうかを制御します。
	"doOpen": false,

	// `doDownload=true doOpen=false` を設定します。
	"mode": "downloadOnly",

	// `doDownload=false doOpen=true` を設定します。
	"mode": "openOnly",

	// `mode` は `doDownload` と `doOpen` より優先されます。

	// URL を格納した JSON ファイルを含むディレクトリを指定します。
	// キャッシュディレクトリは、このディレクトリの下に作成されます。
	"dir": "<JSON ファイルを含むディレクトリへのパス>",

	// ZIP ファイルを自動展開する場合は `dir` の代わりに `zip` を指定します。
	// `zip` を指定した場合、`dir` の値は ZIP ファイルのディレクトリに上書きされます。
	"zip": "<JSON ファイルを含む ZIP ファイルへのパス>",

	// 展開先に既にファイルが存在する場合、上書きできるかどうかを制御します。
	"zipOverwrite": false,

	// キャッシュディレクトリの名前を指定します。通常は変更する必要はありません。
	"cache": ".json_url_saver_cache",

	// JSON ファイルを指定します。このファイルから URL が読み込まれます。
	"file": "/path/to/file.json",

	// URL を格納した JSON 文字列を指定します。
	// JSON 設定ファイル内に記述する場合でも、文字列として指定する必要があります。
	"json": "[ \"https://example.com\" ]",

	// 直接的に URL を一つ指定します。
	"url": "https://example.com",

	// `file`、`json`、または `url` を指定しない場合のみに限って
	// `dir` 内の全ての JSON ファイルの URL が読み込まれます。

	// ダウンロード時に URL を絞り込みます。この値はキャッシュファイルを開く時には使われません。
	// 半角カンマ区切り（,）で複数のフィルタを指定できます。
	// "all"       - 全ての URL を含みます。
	// "localhost" - ローカルホストを示す URL を含みます。
	// "slack"     - Slack にアップロードされたファイルへの URL を含みます。
	"filters": "all,localhost,slack",

	// User OAuth Token を指定します。
	// 詳しくは上記の「Slack からデータをダウンロードする」の説明をご参照ください。
	"token": "xxxxxxxx",

	// キャッシュファイルの番号を指定します。
	// ダウンロードする時の場合：
	//    0 を指定した場合、同じ URL を複数個検出すると、それら全てを異なる番号で保存します。
	//    1 以上の整数を指定した場合、指定された番号で保存します。同じ URL は最後にダウンロードしたファイルで上書きされます。
	//    2 以上の整数を指定した場合、正しく動作しない可能性があります。
	// キャッシュファイルを開く時の場合：
	//    0 を指定した場合、キャッシュファイルを開く度に番号の入力が求められます。これは既定の動作です。
	//    1 以上の整数を指定した場合、指定された番号で開きます。つまり番号の入力を自動化できます。
	//    キャッシュファイル毎に異なる番号を指定したい場合は 0 を指定してください。
	"cacheIndex": 0
}

実行環境

  • OS: Microsoft Windows 10 またはそれ以降
  • ランタイム: .NET 9.0 またはそれ以降

利用SDK

利用規約

このプログラムはMITライセンスに基づいて配布されています。