Mass デスクトップ アプリケーション v1.1.11
操作説明書
Mass Desktop 編
ビジュアル･グラフィックス株式会社
v1.1.11
改訂履歴
Ver.
年月日
改訂内容
章／ページ
1.0.0
2024/06/21
リリース版
1.0.2
2024/09/02
8. 注意・制限事項に記載の現象を修正。
8 章/25p
1.1.11
2024/11/19
追加: マウント プリキャッシュ機能
4.4
修正: アップロード
5
修正: ダウンロード
6
修正: オプションの追加、一部オプションのメニュー位置修正
7
修正: ダウンロード時の書き込み権限について記載
8
登録商標
Microsoft、Windows、Edge は米国 Microsoft Corporation の、米国、日本およびその他の国における登録商標または商標です。
Google Chrome、Google Authenticator はGoogle Inc.の商標です。
Safari、MacOS は米国および他の国々で登録された Apple Inc. の商標です。
Wasabi は、Wasabi Technologies Inc.の商標または登録商標です。
目次
本書の目的
本書は、ビジュアルグラフィックス株式会社（VGI）が、クラウドサービスとして提供するシステム mass-cloud.io - on the cloud platform（Mass）の Mass Desktop アプリの操作説明書です。
Web クライアント(Mass-BROWSE 画面)については、別冊「操作説明書 Mass-BROWSE 編」をお読み下さい。
表記について
［ ］で囲まれたものは、画面上のボタン名称、アイコン名称です。例）：［更新］、［キャンセル］
「 」で囲まれたものは、画面とタブの名称、プルダウンメニューの項目、メッセージです。例）：「ログイン」（画面名所）、「基本」（タブ名称）、「年契約」（プルダウンメニュー項目）
“ ”で囲まれたものは、本システムの用語です。例）：“スーパーバイザー”、“テナント”
ソフトウェアの概要および特長
Mass Desktop はオープンソースの rclone をベースとしたソフトウェアで、Mass BROWSE 画面と連携してファイル転送を高速に行い、直接オペレーションシステムにワークスペースを“マウント”することで、円滑にアセットマネージメントを行うことが可能です。
OS はそれぞれ Windows 版、MacOS 版、Linux(Rocky Linux)版に対応します。
起動と終了
Windows の場合
本アプリ起動中は、システムトレイに以下のようにアイコンを表示します。
システムトレイにアイコンがないときは、デスクトップにある下記のアイコンをダブルクリックするか、スタートメニューから「Mass Desktop」を選択して起動してください。二重起動はできません。
起動後はアイコンをシステムトレイに表示します。タスクバーには表示されません。
アプリを終了するときは、システムトレイにある本アプリのアイコンを右クリックメニューし「アプリケーションの終了」を選択してください。
Mac の場合
本アプリ起動中は、メニューバー右側に以下のようにアイコンを表示します。
メニューバーにアイコンがないときは、Launchpad から「Mass Desktop」をクリックしてください。起動するとメニューバーにアイコンを表示します。二重起動はできません。
アプリを終了するときは、メニューバーのアイコンをクリックしメニューから「アプリケーションの終了」を選択してください。
Linux の場合
本アプリ起動中は、メニューバー右側に以下のようにアイコンを表示します。
メニューバーにアイコンがないときは、アクティビティのアプリケーションを表示から「Mass Desktop」をクリックしてください。起動するとメニューバーにアイコンを表示します。二重起動はできません。
アプリを終了するときは、メニューバーのアイコンをクリックしメニューから「アプリケーションの終了」を選択してください。
以降、Windows の場合、システムトレイにある本アプリのアイコンを右クリックメニューしたときに表示するメニューを「アイコンメニュー」と呼びます。
Mac、Linux の場合も同様に本アプリのアイコンをクリックして表示するメニューを「アイコンメニュー」と呼びます。
マウント
お使いの PC 上に“ワークスペース”の“ライブラリ”をマウントすることが可能です。マウントしたライブラリは、Windows エクスプローラーや Mac のファインダー、コマンドライン上の操作でクラウド上のファイルに仮想的にアクセスすることができます。
マウント開始は Mass BROWSE 画面（Web ブラウザ）で操作し、マウント解除は本アプリのウィンドウで操作します。
ご使用になる前に
マウント処理はご使用の PC のディスク容量を多く消費することがあります。そのため、事前に本アプリの設定内容を確認することをおすすめします。
- 本アプリのアイコンメニュー「ウィンドウを開く」を選択するかアイコンをクリックして本アプリのウィンドウを開きます。
- ウィンドウ上部の「マウント先のルートフォルダ」、「マウントキャッシュフォルダ」のパスを確認します。
インストール直後は、どちらもシステムドライブに割り当てられています。特に「マウントキャッシュフォルダ」は、多くのディスク容量を消費することがあるため、システムドライブの空き容量が少ない場合などは、この設定を変更することをおすすめします。
- 設定を変更するときは、ウィンドウ右上の[設定]をクリックして設定画面を開きます。特に下記の赤枠の項目は適宜変更することをおすすめします。
マウント開始
同一ユーザー同一プロジェクト内であれば複数のライブラリを同時にマウント可能です。
① Mass BROWSE 画面のライブラリを選択し右クリックメニュー[Mass Desktop]⇒[マウント]を選択します。
② マウントを開始すると以下のようなメッセージを表示します。このメッセージは数秒後に自動消去します。
③ 現在のマウント状況を確認するときは、[マウント状況]をクリックしてください。以下は、３つのライブラリをマウントしたときの表示例です。
マウントしたフォルダを開くときは、[フォルダを開く]をクリックしてください。Windows エクスプローラーまたは Mac のファイダーで対象フォルダを
開きます。
Mass BROWSE 画面のフォルダやファイル構成と、マウント先のファイルやフォルダ構成に差異があるときは、
をクリックしてください。クラウ
ド上の状態と同期をとります。
マウント解除
① マウントを解除する前に、マウント先フォルダやファイルにアクセスしているアプリケーションがある場合は、それらのアプリケーションを終了してアクセスを停止してください。
② 本アプリのアイコンメニューから「ウィンドウを開く」を選択するかアイコンをクリックして本アプリのウィンドウを開き、[マウント状況」を表示してください。
③ 以下のような画面が表示されるので、マウントを解除したい項目の[マウント解除]をクリックします。
マウント プリキャッシュ機能
マウント開始後、デスクトップアプリは指定された拡張子のファイルを先行してクラウド上から自動でローカルキャッシュフォルダにキャッシュします。 プリキャッシュ状況はマウント一覧に Pre.XX% という形式で進捗を表示し、キャッシュ上限サイズに達した場合は途中で止まり、進捗率も途中で停止します。
キャッシュの定時処理は１分おきに再スキャンを行います。クラウド上にファイルが追加された場合、１分間隔でファイルリストを sy キャンし、キャッシュ動作を行います。
アップロード
大きなサイズのファイルや大量のファイルをアップロードするときは、Mass BROWSE 画面（Web ブラウザ）からのアップロードよりも、本アプリを使用してアップロードすることをおすすめします。
① Mass BROWSE 画面（Web ブラウザ）のライブラリまたはフォルダを選択して右クリックメニューから[Mass Desktop]>[アップロード]の順に選択します。
フォルダの右クリックメニュー表示例
選択したフォルダ以下全てのフォルダ、ファイルをアップロードします。
ライブラリの右クリックメニュー表示例
② 以下のようなウィンドウが表示されるので、フォルダごとアップロードするときは[フォルダ]を、ファイルをアップロードするときは[ファイル]を、アップロードを中止するときは[キャンセル]をクリックしてください。
③ アップロードするフォルダまたはファイルを選択するとアップロードが開始され、「アップロード状況」に現在の状態を表示します。以下は、複数ファイルアップロード指定したときの表示例です。
注意事項
- アップロードは、リストの上から順に実行されます。
- リストからファイルを選択して[▲]または[▼]をクリックすると、アップロード順を入れ替えることができます。
- 完了したリストは 300 件まで保持します。完了件数が 300 件を超える場合、古いものから削除されます。
- 同じファイル名がある場合は、上書きアップロードされます。
ただしファイルサイズやタイムスタンプが同じの同一のファイルである場合は、アップロードはスキップされます。
- リストからファイルを選択して[保留切替]をクリックするごとに、アップロードを中断・再開することができます。ただし、再開はファイルの先頭からアップロードを開始します。
フォルダのアップロードを中断し再開した場合、フォルダ内の既にアップロード完了済みのファイルは再度転送を行いません。登録中のファイル・フォルダの保留切替はできません。
- 「状態」に関わらず[削除]をクリックすると、アップロードを中止してリストから削除されます。
ダウンロード
大きなサイズのファイルや大量のファイルをダウンロードするときは、Mass BROWSE 画面（Web ブラウザ）からのダウンロードではなく、本アプリを使用してダウンロードすることをおすすめします。連番ファイルのダウンロードは、本アプリでのみ行えます。
① Mass BROWSE 画面（Web ブラウザ）のライブラリまたはフォルダ、ファイルを選択して右クリックメニューから Mass Desktop によるダウンロードを選択します。
ファイルの右クリックメニュー表示例
複数ファイルを選択してダウンロード指定が可能です。
フォルダの右クリックメニュー表示例
② メニュー選択すると、ダウンロード先のフォルダを選択するダイアログを表示するので、ダウンロード先フォルダを選択してください。
③ 「ダウンロード状況」に現在の状態を表示します。以下は、複数ファイルをダウンロード指定したときの表示例です。
注意事項
- ダウンロードは、リストの上から順に実行されます。「 7.2 rclone 詳細設定-1 」の—transfers で指定したファイル数が同時にダウンロードされます。
- リストから項目を選択して[▲]または[▼]をクリックすると、ダウンロード順を入れ替えることができます。
- 完了したリストは 300 件まで保持します。完了件数が 300 件を超える場合、古いものから削除されます。
- ダウンロード先に同じファイル名がある場合は、ファイル名の末尾に(1)(2)などの番号を付加したファイル名でダウンロードされます。
- リストから項目を選択して[保留切替]をクリックするごとに、ダウンロードを中断・再開することができます。ただし、再開はファイルの先頭からダウンロードを開始します。
- 「状態」に関わらず[削除]をクリックすると、ダウンロードを中止してリストから削除されます。
設定
ウィンドウ左のカテゴリをクリックして設定項目を切り替えることができます。
ウィンドウ左下の[すべてデフォルトに戻す]をクリックすると、デフォルト値を表示します。保存するときは[設定保存]を、保存しないときは[キャンセル]をクリックしてください。
マウントフォルダ設定
№
項目名
説明
特記事項など
1
--cache-dir
マウント時の作業用フォルダを指定します。十分な空き容量を確保できるローカルディスクまたは NAS のフォルダを指定してください。設定保存したフォルダは、隠しフォルダとなり、ファイルエクスプローラーなどから見え
なくなります。
2
--vfs-cache-max-size
キャッシュの最大サイズを指定します。この値を超えた場合、アクセスの少ないファイルがキャッシュから削除されます。ただし、アクセス中のファイルは削除されません。メモリ使用量を管理し、過剰なキャッシュを防ぐこ
とに使用します。
3
--vfs-cache-min-free- space
--cache-dir 指定したドライブで最低限確保したい空き容量（キャッシュを含む）を指定します。この値を下回った場合、アクセスの少ないファイルがキャッシュから削除されます。ただし、アクセス中のファイルは削除されま
せん。
4
mountPoint
マウント先のルートフォルダを指定します。マウント指定したライブラリの
フォルダやファイルは、このフォルダ下に仮想的に配置されます。
5
driveMode
有効にすると、固定ディスクトライブとしてマウントします。未使用のドライ
ブレターが自動的に割り当てられます。
Windows PC のみ
6
networkMode
有効にすると、driveMode の設定に関わらずネットワークドライブとしてマ
ウントします。未使用のドライブレターが自動的に割り当てられます。
Windows PC のみ
7
--file-perms
ファイルのアクセス権限を指定します。
8
--dir-perms
フォルダのアクセス権限を指定します。
9
preLoadCacheExt
プリキャッシュ対象とするファイルの拡張子を指定します。何も指定しない場合、すべての拡張子のファイルがキャッシュ対象となります。ここで指定していない拡張子はプリキャッシュの対象とはなりませんが、ファイルオー
プン時のキャッシュは問題なく行われます。
rclone 詳細設定-1
№
項目名
説明
特記事項など
1
--transfers
平行して実行するファイル転送（アップロード、ダウンロード）の数を指定します。低スペック PC やネットワーク速度が遅い環境で使用する場合、小さな値（４程度）にした方がファイル転送が早く終わる可能性がありま
す。
2
--dir-cache-time
ディレクトリがバックエンドからリフレッシュされずに最新とみなされる時間
を指定します。
3
--use-server-modtime
有効にすると、オブジェクトメタデータの代わりにサーバー変更時刻を使
用します。
4
--use-mmap
mmap アロケーターを使用するかを指定します。有効にすると各ファイル
転送時（--transfer）に確保したバッファ（--buffer-size）を効率よく開放し
全ての動作環境で有効でない可
能性があります。
メモリ消費を抑えます。
5
--buffer-size
各ファイル転送時（--transfer）のバッファサイズを指定します。
6
--multi-thread-cutoff
このサイズを超えるファイル転送（--transfer）は、マルチスレッドを使用し
ます。
7
--multi-thread-streams
マルチスレッド（--multi-thread-cutoff）でファイル転送（--transfer）する
場合のスレッド数を指定します。
8
--no-seek
ファイル内のシークを許可するかを指定します。有効にすると不許可とな
ります。
9
--checkers
ファイルの等価性チェックを並列に実行する数を指定します。低スペック
PC やネットワーク速度が遅い環境で使用する場合、４以下にする必要があるかもしれません。
10
--check-first
転送を開始する前にファイルチェックを行います。
OFF 推奨
11
--s3-disable-checksum
MD5 チェックサムをオブジェクトメタデータとともに保存しません。
ON 推奨
rclone 詳細設定-2
上級者向けの設定です。特別な理由がない限り変更不要です。
№
項目名
説明
特記事項など
1
--s3-chunk-size
マルチパートアップロードに使用するチャンクサイズを指定します。高速
ネットワークで大きなサイズのファイルをアップロードしていて十分なメモリがある場合、この値を増やすとアップロードが速くなります。
2
--s3-upload-concurrency
マルチパートアップロードとコピーの同時実行数を指定します。少数の大きなファイルを高速ネットワークでアップロードしており、これらのアップロードが帯域幅を十分に利用していない場合、これを増やすと転送速度
が速くなる可能性があります。
3
--s3-upload-cutoff
指定したサイズ以上のファイルアップロード時にシングルパートのアップ
ロードからマルチパートのアップロードに切り替わります。
4
--vfs-cache-mode
キャッシュモードを指定します。full をおすすめします。
5
--vfs-used-is-size
使用済サイズには rclone サイズアルゴリズムを使用します。
6
--vfs-fast-fingerprint
有効にすると、rclone はフィンガープリントに低速な操作を含めません。これにより、フィンガープリントの精度は低下しますが、速度は大幅に向
上し、キャッシュされたファイルを開く時間が改善されます。
7
--vfs-cache-max-age
最終アクセスから指定した時間が経過すると、キャッシュからファイルを削除します。例えば１時間にすると、1 時間アクセスされなかったファイルをキャッシュから削除し始めます。キャッシュされたファイルにアクセスがあると、1 時間タイマーは 0 にリセットされ、さらに 1 時間待ってからキャッ
シュを削除します。
8
--vfs-cache-poll-interval
古いオブジェクトのキャッシュをポーリングする間隔を指定します。この間隔は、--vfs-cache-max-size と--vfs-cache-min-free-space で削除する
ファイルをチェックする間隔となります。
9
--vfs-read-chunk-size
ソースオブジェクトを指定した値単位で読み込みます。
10
--vfs-read-chunk-size- limit
rclone は--vfs-read-chunk-size サイズのチャンクから読み込みを開始し、読み込みごとにサイズを倍増する。--vfs-read-chunk-size-limit が指定され、--vfs-read-chunk-size より大きい場合、各オープンファイルのチャンクサイズは、指定された値に達するまで倍増されます。この値が
0 のとき、制限は無効となり、チャンクサイズは無制限に大きくなります。
11
--vfs-read-ahead
rclone はファイルを読み込むとき、--buffer-size に--vfs-read-ahead を加えたサイズで読み込む。--buffer-size はメモリ上にバッファされ、--vfs- read-ahead はディスク上にバッファされます。
このモードを使用する場合、--buffer-size はあまり大きく設定せず、 --
vfs-read-ahead は必要に応じて大きく設定することをおすすめします。
12
--vfs-disk-space-total- size
ディスクの総容量を指定します。
リモートのオペレーティングシステム(Unix/Windows)に報告されるディスク領域の合計サイズを手動で設定することができます。このフラグは、リモートの使用可能領域に関する表示に影響します。
たとえば、無料の Box アカウントを使用している場合、--vfs-disk-space- total-size 10G と設定すると、10GB の外付けドライブとして表示されます。こうすることで、無料クォータの超過を避けることができます。
S3 のようなバックエンドの中には、使用バイト数を正確に報告しないもの
があるので、このフラグは報告される容量をコントロールする別の方法を提供することに注意してください。
その他アプリケーション設定
№
項目名
説明
特記事項など
1
logFolder
動作ログファイルを保存しているフォルダを表示します。本アプリの不具
合が発生した場合など、必要に応じて動作ログファイルを開発者へ提供するときに使用します。
2
logExpire
動作ログファイルの保存日数を指定します。特別な理由がない限り変更
不要です。
3
autoExec
PC ログインしたときに本アプリを自動起動するかを指定します。
注意・制限事項
- マウント指定したライブラリのフォルダやファイル数、ファイルサイズ、動作環境に依存しますが、マウントが完了するまで数分かかる場合があります。完了前に[フォルダを開く]をクリックすると以下のようなエラーメッセージを表示するので、少し待ってから再度[フォルダを開く]をクリックしてくださ い。
- マウント中のワークスペース、ライブラリの名称変更、削除はしないでください。マウント中にこられの操作をすると、想定外の挙動になる可能性があります。今後のバージョンアップで改善予定です。
- Windows の場合、ネットワークドライブとしてマウント後に切断すると、Windows エクスプローラー上にネットワークドライブが表示上残り続けることがあります。解消するには PC を再起動してください。
- Windows の場合、デフォルトの「マウント先ルートフォルダ」と「マウントキャッシュフォルダ」は、カレントユーザーのドキュメントフォルダが自動で指定されます。
マウント先ルートフォルダ: C:\Users\[user フォルダ]\ドキュメント\mass
マウントキャッシュフォルダ: C:\Users\[user フォルダ]\ドキュメント\rclone_cache
- Windows の設定で OneDrive の同期を有効にしている場合は、「マウント先ルートフォルダ」、「マウントキャッシュフォルダ」を変更することを推奨します。
- 一つの端末で複数ユーザーが同時に同じプロジェクトのライブラリにマウントすることはできません。
- 「 7.1 マウントフォルダ設定 」--cache-dir で指定したフォルダは、ファイルエクスプローラーなどで見えなくなります（非表示属性となります）。
- 配下階層にフォルダが存在するフォルダのダウンロードを行う場合、ログインユーザーがダウンロード先に書き込み権限を持っていない場合にフォルダダウンロードに失敗する場合があります。その場合、ダウンロード先の書き込み権限を確認し、書き込み権限を持つフォルダをダウンロード先に指定してください。
以上