使い方ガイド

はじめに

Kagemusha を初めてお使いになる方は、この章の手順で準備を済ませてください。ダウンロードから最初のアプリの作成まで、10分ほどで終わります。

ダウンロードとインストール

動作環境は macOS 12 以降です。Apple シリコン（M1 以降）と Intel の Mac のどちらでも動きます。

Kagemusha をダウンロードします。「ダウンロード」フォルダに Kagemusha.dmg が保存されます
Kagemusha.dmg をダブルクリックして開きます
表示されたウィンドウで、Kagemusha のアイコンを「Applications」フォルダのアイコンへドラッグします
Finder の「アプリケーション」フォルダを開き、Kagemusha をダブルクリックして起動します
起動できたら、Finder のサイドバーに表示されている「Kagemusha」の取り出しボタンを押して、ディスクイメージを取り出します

初回起動で確認のメッセージが表示されたとき

初めて起動すると、macOS が「“Kagemusha”はインターネットからダウンロードされたアプリケーションです。開いてもよろしいですか？」と確認します。Kagemusha は Apple の公証を受けたアプリですので、「開く」をクリックしてください。2回目以降は表示されません。

「開けません」と表示されて起動できない場合は、次の手順で開きます。

メッセージを閉じ、アップルメニューから「システム設定」を開きます
左の一覧から「プライバシーとセキュリティ」を選びます
右側を下へスクロールし、「セキュリティ」の欄に表示されている「このまま開く」をクリックします
Mac のログインパスワード（または Touch ID）で確認すると、Kagemusha が起動します

Kagemusha は、Mac にインストール済みのブラウザを使ってアプリを作成します。Google Chrome、Microsoft Edge、Brave などのブラウザが1つも無い場合は、先に Google Chrome をインストールしてください。

ライセンスキーの登録

無料版でもすべての機能を使えます。無料版で作成できるアプリは3つまでです。ご購入や特典でライセンスキーを受け取った方は、次の手順で登録すると、アプリをいくつでも作成できるようになります。

ライセンスキーが書かれたメールを開き、キーをすべて選択してコピーします
Kagemusha の左のサイドバーで「ライセンス」をクリックします
「ライセンスキーをお持ちの方」の欄にある入力欄（「購入時のメールに届いたキーを貼り付けてください」と表示されています）をクリックし、⌘V で貼り付けます。キーの途中に改行が入っていても構いません
「登録する」をクリックします
「ライセンスを登録しました。ありがとうございます。」と表示され、「現在の状態」が「Pro」に変われば完了です

1つのライセンスで、Mac を3台まで登録できます。別の Mac に移すときは、使わなくなった Mac の「ライセンス」画面で「この Mac のライセンスを解除」をクリックしてから、新しい Mac で同じキーを登録してください。

キーが書かれたメールが見つからないときは、「ライセンス」画面の「キーが見つからないとき」の欄に、購入時のメールアドレスを入力して「送り直す」をクリックしてください。ご購入の記録があるアドレスへ、キーをお送りします。

最初にやること

まずは、毎日使っている Web サービスを1つ、アプリにしてみましょう。ここでは Gmail を例に説明します。

左のサイドバーで「新規作成」をクリックします
「サービスを検索...」の欄に「Gmail」と入力し、表示された Gmail を選びます。一覧に無いサービスは「カスタム」を選び、URL とアプリ名を入力します
「ブラウザエンジン」で、お使いのブラウザ（迷ったら Google Chrome）を選びます
「アプリを作成」をクリックします。作成したアプリは「アプリケーション」フォルダの中の「Kagemusha」フォルダに保存されます
左のサイドバーの「アプリ管理」で、作成したアプリの「起動」をクリックします。開いたウィンドウで、いつもどおりサービスにログインすれば準備は完了です

起動したアプリは、ほかのアプリと同じように Dock に表示されます。Dock のアイコンを右クリックし、「オプション」から「Dock に追加」を選ぶと、次からは Dock から1クリックで起動できます。

1. 基本の使い方

プリセットから作成する

Kagemusha には 300 以上のサービスプリセットが組み込まれています。Gmail、Slack、Notion、ChatGPT など主要な Web サービスのアイコンと URL があらかじめ登録されているため、リストから選ぶだけで即座にアプリを作成できます。

Kagemusha を起動し、「アプリを作成」ボタンをクリック
プリセット一覧から使いたいサービスを選択（検索バーでフィルタリング可能）
必要に応じてオプションを調整
「作成」ボタンをクリック

カスタム URL から作成する

プリセットにないサービスや社内ツールも、URL を直接入力して作成できます。

「カスタム」タブを選択
URL（例: https://example.com）を入力
アプリ名を入力
「画像を選択」を押して画像ファイルを選び、「アイコンの形状」で「なし」「角丸」「丸」のいずれかを選択（任意）
オプションを調整して「作成」をクリック

オプション設定

アプリ作成時に以下のオプションを設定できます。各項目の詳細は次章「設定項目リファレンス」を参照してください。すべてのオプションはアプリ作成後も変更可能です。

2. 設定項目リファレンス

ブラウザエンジン

アプリのベースとなるブラウザを選択します。お使いの Mac にインストールされているブラウザのみ選択可能です。

Chrome：最も安定。拡張機能のエコシステムが充実。迷ったらこれ
Brave：広告ブロック・トラッキング防止を標準搭載。ニュースサイトや動画視聴に最適
Edge：Microsoft 365 との相性が良い。Copilot 連携
Opera：軽量でメモリ効率が良い。VPN 機能を内蔵
Vivaldi：カスタマイズ性が高い。パワーユーザー向け
Chromium：オープンソース版 Chrome。余計な機能なし
Arc：モダンな UI。Space 機能との親和性が高い

選んだブラウザの実体ファイルを symlink で参照するため、ブラウザをアップデートするとアプリにも自動的に反映されます。ブラウザ本体に影響を与えることはありません。

タブバー

ブラウザのタブバー（アドレスバー + タブ）をアプリに表示するかどうかを切り替えます。

ON：アドレスバーとタブバーが表示されます。複数タブの操作やURL確認が必要な場合に便利です
OFF（デフォルト）：タブバーが非表示になり、Web コンテンツだけが表示されます。ネイティブアプリに近い見た目になります

Quick Setup で複数 URL を設定した場合、タブバーは自動的に ON になります。タブバーが OFF のまま Quick Setup を使うと、設定した URL は裏タブとして読み込まれますが、タブ切り替えの UI がないため操作しづらくなります。

Chrome 拡張機能

Chrome Web Store の拡張機能をアプリ内で使用できるようにします。

ON：アプリ起動時に拡張機能のサイドバーが表示され、Chrome Web Store から拡張機能をインストールして利用できます
OFF（デフォルト）：拡張機能は無効です

各アプリのプロファイルは独立しているため、アプリごとに異なる拡張機能をインストールできます。例えば翻訳アプリには翻訳拡張、開発ツールにはDevTools拡張といった使い分けが可能です。

拡張機能を登録してアプリに追加する

Chrome ウェブストアの拡張機能を Kagemusha に登録しておくと、作成済みのアプリにも、必要な拡張機能だけを追加できます。ログイン情報は引き継ぎません。

拡張機能を登録する:

Kagemusha の左の「拡張機能」を開き、「Chrome ウェブストアで追加」をクリック
拡張機能を登録するための Chrome が開くので、Chrome ウェブストアから追加したい拡張機能を追加
Kagemusha に戻って「一覧を更新」をクリックし、登録した拡張機能が一覧に表示されることを確認

作成済みのアプリに追加する:

拡張機能を追加したいアプリを終了しておく（起動中は保存できません）
「アプリ管理」で、そのアプリのメニュー（…）から「設定」を開く
「拡張機能」の欄で、追加したい拡張機能にチェックを付けて「保存」をクリック
アプリを起動すると、拡張機能が追加されています

新しくアプリを作成するときも、作成画面の「拡張機能」の欄で選択できます。外したいときは、同じ「設定」でチェックを外して保存します。

拡張機能の追加は、ブラウザエンジンに Google Chrome を選んだアプリで使用できます。

通知

Web サイトの Push 通知を macOS のシステム通知として表示します。

ON：アプリ内で通知許可が自動的に付与されます。Gmail の新着メール、Slack のメンション通知などを macOS の通知センターで受け取れます
OFF（デフォルト）：Web サイトの通知リクエストが自動拒否されます

通知の設定は macOS の「システム設定 > 通知」からアプリごとに細かく制御できます（通知スタイル、サウンドのON/OFFなど）。

シークレットモード

アプリを常にシークレット（プライベート）モードで起動します。

ON：閲覧履歴、Cookie、サイトデータが保存されません。アプリを閉じるたびにセッションがクリアされます
OFF（デフォルト）：通常モードで起動します。ログイン状態や閲覧履歴が保持されます

プロファイル分離との違い: Kagemusha はアプリごとに独立したプロファイルを自動作成するため、シークレットモードを OFF にしていても、ブラウザ本体やほかのアプリとは Cookie やデータが完全に分離されています。シークレットモードは「アプリ自身にもデータを残さない」ための設定です。

Dock に表示

macOS の Dock にアプリアイコンを表示するかどうかを制御します。

ON（デフォルト）：Dock にアイコンが常時表示されます。⌘+Tab でのアプリ切り替えが可能で、ウィンドウを閉じた後も Dock アイコンからアプリを復元できます
OFF：Dock にアイコンが表示されません。メニューバーのみの表示になります。バックグラウンドで常駐させたいユーティリティ系のアプリに適しています

終了確認ダイアログ

⌘Q でアプリを終了しようとしたときに確認ダイアログを表示します。

ON：「本当に終了しますか？」という確認が表示されます。作業中の誤終了を防ぎたい場合に有効です
OFF（デフォルト）：確認なしですぐに終了します。素早く閉じたい場合に適しています

タブ復元

前回終了時に開いていたタブとスクロール位置を、次回起動時に自動で復元します。

ON（デフォルト）：終了前の状態がそのまま復元されます。作業の続きからすぐに再開できます
OFF：毎回、設定した URL（ホーム URL）から新しく開始します

ウィンドウハンドリング

リンクをクリックした際に新しいウィンドウ（ポップアップ）をどう扱うかを設定します。3 つのモードから選べます。

すべてブロック：新しいウィンドウを一切開きません。すべてのリンクを現在のウィンドウ内で開きます。余計なポップアップを完全に防ぎたい場合に
スマート（デフォルト・推奨）：OAuth 認証やログインフローなど、必要なポップアップのみ許可し、広告や不要なポップアップはブロックします
すべて許可：新しいウィンドウの生成をすべて許可します。ポップアップが動作しない問題が起きた場合に試してください

多くの場合は「スマート」がベストです。Google OAuth のログインなど、ポップアップが必要な場面でのみ新しいウィンドウが開きます。ポップアップに問題がある場合は「すべて許可」に切り替えてください。

Quick Setup

アプリ起動時に、複数の URL をタブとして一括で開く機能です。1 つのアプリで関連する複数のサービスにすぐアクセスできます。

設定方法:

アプリの設定で「Quick Setup」の欄を表示（タブバーを有効にしたアプリにだけ表示されます）
開きたい URL を入力
「追加」ボタンをクリック（複数追加可能）
URL は追加した順に並びます。順番を変更する場合は、「削除」を押して追加し直します

使用例:

仕事セット：Gmail + Google Calendar + Google Drive を 1 アプリに
開発ツール：GitHub + CI/CD ダッシュボード + ドキュメントサイト
情報収集：日経 + Yahoo! ニュース + TradingView

Quick Setup を使う場合は「タブバー」を ON にすることを推奨します。タブバーなしでは複数タブ間の切り替えが困難です。

User-Agent

アプリがサーバーに送信する User-Agent 文字列を変更できます。Web サイトにどのブラウザ・デバイスからアクセスしているように見せるかを制御します。

デフォルト：選択したブラウザエンジンの標準 User-Agent をそのまま使用します
iPhone：iPhone 版 Safari の User-Agent を送信します。モバイル版の表示を確認したい場合や、モバイル版のほうが軽量で使いやすい場合に
Android：Android 版 Chrome の User-Agent を送信します
iPad：iPad 版 Safari の User-Agent を送信します。タブレット向けレイアウトを利用したい場合に
カスタム：任意の User-Agent 文字列を手動で入力できます。特殊な要件がある場合に使用します

URL ルール

アプリ内でアクセスできる URL を制限する機能です。ホワイトリスト（許可リスト）とブラックリスト（ブロックリスト）の 2 種類があります。

ホワイトリスト（許可リスト）

指定したドメインやパスにのみアクセスを許可し、それ以外をブロックします。業務用アプリでアクセス先を限定したい場合に便利です。

ブラックリスト（ブロックリスト）

指定したドメインやパスへのアクセスをブロックします。それ以外は自由にアクセスできます。特定の外部サイトや広告ドメインをブロックしたい場合に使います。

書式:

example.com：ドメイン全体にマッチ（サブドメインを含む）
*.example.com：サブドメインのみにマッチ
example.com/path/*：特定のパス配下にマッチ

使用例:

社内ツール用に company.slack.com と company.atlassian.net のみホワイトリストに登録
ニュースサイトの広告ドメインをブラックリストに登録して非表示に

Space モード

複数の Web サービスを 1 つのアプリウィンドウにまとめ、サイドバーで切り替えて使う機能です。通常のアプリが「1 アプリ = 1 サービス」なのに対し、Space は「1 アプリ = 複数サービス」を実現します。

Quick Setup との違い:

Quick Setup：同一ウィンドウの複数タブ。タブバーで切り替え。プロファイル（Cookie やログイン情報）は共通
Space モード：サイドバーのアイコンで切り替え。各サービスが独立したビューを持ち、見た目はタブバーなしのクリーンな表示。プロファイルは Space 全体で共通

設定手順:

「アプリを作成」画面で「Space」モードを選択
Space に含めるサービスをプリセットから選択、またはカスタム URL を追加
各サービスにアイコンを設定（自動取得またはカスタム）
Space 全体のアプリ名とアイコンを設定
「作成」をクリック

活用例:

仕事 Space：Gmail + Google Calendar + Slack + Notion
SNS Space: X + Instagram + Threads + Bluesky
動画 Space：YouTube + Netflix + Prime Video
開発 Space：GitHub + Vercel + Supabase + ChatGPT

テンプレートプロファイル

あらかじめログイン済みの状態を「テンプレート」として保存しておき、新しいアプリにそのプロファイルを適用できる機能です。アプリごとにログインし直す手間を省けます。

テンプレートの作成手順:

Kagemusha の設定画面で「テンプレートプロファイル」セクションを開く
「新規テンプレートを作成」をクリック
テンプレート名を入力（例: 「Google アカウント A」）
テンプレート用のブラウザウィンドウが開くので、必要なサービスにログイン
ログインが完了したらウィンドウを閉じる：プロファイルが自動保存されます

テンプレートの適用:

アプリの作成画面または編集画面で「テンプレートプロファイル」を選択
作成済みのテンプレートを選ぶと、ログイン情報（Cookie）がコピーされます

テンプレートから作成されたアプリは、コピー後は独立したプロファイルとして動作します。テンプレートを後から変更しても、既存アプリには影響しません。

3. アプリの管理

アプリの編集（設定変更）

作成済みのアプリは、メイン画面のアプリ一覧から選択して設定を変更できます。変更可能な項目は作成時と同じオプション（ブラウザエンジンを除く）です。変更は保存後、次回のアプリ起動時に反映されます。

アイコン変更

アプリのアイコンは作成後でも自由に変更できます。メイン画面のアプリを右クリックして「アイコンを変更」を選び、画像ファイルを指定してください。続いて「アイコンの形状」で「なし」「角丸」「丸」のいずれかを選択します。最初は macOS 標準の「角丸」が選択されています。

アプリの削除

不要になったアプリは一覧から削除できます。削除すると、アプリ本体（.app バンドル）とプロファイルデータの両方が削除されます。この操作は元に戻せません。

ブラウザ更新時の自動同期

Kagemusha で作成されたアプリはブラウザ本体へ symlink で参照しているため、ブラウザをアップデートするとアプリにも自動的に反映されます。特別な操作は必要ありません。

4. その他の設定

言語切替

32言語に対応しています。はじめは Mac の言語設定（システム設定の「一般」→「言語と地域」）に合わせて表示します。設定画面の「言語」から、別の言語を選ぶこともできます。

日本語、English、Deutsch、Français、Español、Italiano、Nederlands、Português (Portugal)、Português (Brasil)、Svenska、Dansk、Suomi、Norsk bokmål、Русский、Polski、Čeština、Slovenčina、Magyar、Română、Ελληνικά、Українська、Türkçe、简体中文、繁體中文、한국어、ไทย、Tiếng Việt、Bahasa Indonesia、Bahasa Melayu、हिन्दी、العربية、עברית

テーマ（外観）

ライト・ダーク・自動（システム設定に追従）の 3 つのテーマモードから選択できます。設定画面の「一般」セクションで変更します。

デフォルトアプリオプション

新しいアプリを作成する際のデフォルト設定を変更できます。よく使うオプションの組み合わせを保存しておくと、毎回設定する手間が省けます。

Dock ショートカット

Kagemusha 独自の Dock ランチャーを設定できます。作成したすべてのアプリをグリッド表示で一覧し、ワンクリックまたはキーボード操作で起動できます。背景色や透過度のカスタマイズも可能です。

データのエクスポート / インポート

Kagemusha の設定データ（アプリ一覧・各アプリの設定・ライセンス情報など）をファイルに書き出して、別の Mac に移行できます。

エクスポート：設定画面の「データ管理」から「エクスポート」をクリックすると、JSON 形式の設定ファイルが保存されます
インポート：エクスポートした JSON ファイルを「インポート」から読み込むと、設定が復元されます

プロファイルデータ（Cookie やログイン情報）はエクスポートに含まれません。プロファイルデータの移行には「テンプレートプロファイル」機能をご利用ください。

困ったとき

よくある質問

料金、対応ブラウザ、安全性、データの扱いなどは、よくある質問にまとめています。

よくあるつまずき

アプリを作成できない：無料版で作成できるアプリは3つまでです。4つ目からはライセンスキーの登録が必要です
ブラウザエンジンが選べない：「未インストール」と表示されたブラウザは使えません。表示されている「ダウンロード」からブラウザをインストールしてください
作成したアプリでログインできない：アプリごとにログイン情報を分けているため、アプリを作成したら最初に一度ログインが必要です。ログインの画面が開かない場合は、アプリの設定で「ウィンドウハンドリング」を「すべて許可」に切り替えてください
ライセンスキーを登録できない：メールのキーを最初から最後まで、欠けずにコピーできているか確認してください。Mac を3台登録済みの場合は、使っていない Mac の登録を「ライセンス」画面の「登録している Mac」から解除してください

お問い合わせ

解決しないときは、お問い合わせフォームからご連絡ください。メールの場合は info@kagemusha.app へお送りください。ご購入時のメールアドレスと、表示されたメッセージをお書き添えいただくと、早くご案内できます。