From 45b073217dbdea0c616e32efc5a2a56637d19d30 Mon Sep 17 00:00:00 2001 From: Vito Van Date: Wed, 7 Aug 2024 19:04:17 +0800 Subject: [PATCH 1/2] doc: improve the guide for running macos applications bundle mainly for macos-14, the right click method didn't work, it seems the user has to de-quarantine with command. I changed the search links from duckduckgo to google, for the search results of better relevance. --- README.md | 4 ++-- README_JA.md | 4 ++-- docs/installation.md | 16 ++++++++++------ docs/installation_JA.md | 14 +++++++++----- 4 files changed, 23 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index b2f27677..3daad595 100644 --- a/README.md +++ b/README.md @@ -56,9 +56,9 @@ For more applications made with CALM, please check [Made with CALM](https://gith 3. Add the extracted directory into your PATH environment - for macOS, add `/path/to/Calm.app/Contents/MacOS/` instead + for macOS, add `/Applications/Calm.app/Contents/MacOS/` instead -For macOS and Windows users, you need to be smarter than [Windows SmartScreen](https://duckduckgo.com/?q=how+to+bypass+smartscreen) or able to [tame macOS](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac) to use CALM. In case anything went wrong, here is an [Installation Guide](docs/installation.md). +For macOS and Windows users, you need to be smarter than [Windows SmartScreen](https://www.google.com/search?q=how+to+get+around+windows+smartscreen) or able to [tame macOS](https://www.google.com/search?q=how+to+remove+quarantine+flags+in+macos) to use CALM. In case anything went wrong, here is an [Installation Guide](docs/installation.md). ### Run from Source diff --git a/README_JA.md b/README_JA.md index bfdd3abb..794a7674 100644 --- a/README_JA.md +++ b/README_JA.md @@ -56,9 +56,9 @@ CALM で作られた他のアプリケーションについては、[Made with C 3. 解凍したディレクトリを PATH 環境に追加する - macOS の場合は、代わりに `/path/to/Calm.app/Contents/MacOS/` を追加する + macOS の場合は、代わりに `/Applications/Calm.app/Contents/MacOS/` を追加する -macOS と Windows ユーザーの場合、CALM を使うには [Windows SmartScreen](https://duckduckgo.com/?q=how+to+bypass+smartscreen) よりもスマートであるか、[macOS を飼いならす事](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac)ができる必要があります。万が一何かあったときのために、ここに[インストールガイド](docs/installation_JA.md)があります。 +macOS と Windows ユーザーの場合、CALM を使うには [Windows SmartScreen](https://www.google.com/search?q=how+to+get+around+windows+smartscreen) よりもスマートであるか、[macOS を飼いならす事](https://www.google.com/search?q=how+to+remove+quarantine+flags+in+macos)ができる必要があります。万が一何かあったときのために、ここに[インストールガイド](docs/installation_JA.md)があります。 ### ソースからの実行 diff --git a/docs/installation.md b/docs/installation.md index bdfac9f9..d2b5c990 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -14,15 +14,19 @@ Now let's set up the environment for the ease of use. - macOS 1. Open the downloaded DMG file - 2. Drage the .app to the Applications folder + 2. Drag the .app to the Applications folder - 3. Eject the DMG and run Calm.app + 3. Trust me and de-quarantine Calm.app - **It may take a while** for the first run. + ```bash + xattr -d com.apple.quarantine /Applications/Calm.app + ``` - > On macOS, it's very likely the system will stop you from running the software, since it's not verified by Apple. If you have problem to run it, please check [this](https://support.apple.com/HT202491). + 4. Eject the DMG and run Calm.app + + **It may take a while** for the first run. - 4. Add command `calm` to the PATH environment + 5. Add command `calm` to the PATH environment ```bash echo 'export PATH="/Applications/Calm.app/Contents/MacOS/:$PATH"'>> ~/.bashrc @@ -42,7 +46,7 @@ Now let's set up the environment for the ease of use. > echo 'export PATH="/c/calm/:$PATH"' >> ~/.bashrc > ``` - > On Windows, it's very likely the system will stop you from running the software, since it's not verified by Microsoft. If you have problem to run it, please [find a way to bypass SmartScreen](https://duckduckgo.com/?q=how+to+bypass+smartscreen). + > On Windows, it's very likely the system will stop you from running the software, since it's not verified by Microsoft. If you have problem to run it, please [find a way to bypass SmartScreen](https://www.google.com/search?q=how+to+get+around+windows+smartscreen). Now you are all set, enjoy. diff --git a/docs/installation_JA.md b/docs/installation_JA.md index d2b76a02..2e5d40fc 100644 --- a/docs/installation_JA.md +++ b/docs/installation_JA.md @@ -16,13 +16,17 @@ 2. .app をアプリケーションフォルダにドラッグします - 3. DMG を取り出し、Calm.app を実行する + 3. Trust me and de-quarantine Calm.app - 初回の実行には **時間がかかるかもしれません。** + ```bash + xattr -d com.apple.quarantine /Applications/Calm.app + ``` - > macOS の場合、Apple によって検証されていないため、システムによってソフトウェアの実行が停止される確率が非常に高いです。実行に問題がある場合は、[こちら](https://support.apple.com/HT202491)を確認してください。 + 4. DMG を取り出し、Calm.app を実行する + + 初回の実行には **時間がかかるかもしれません。** - 4. コマンド `calm` を PATH 環境に追加する + 5. コマンド `calm` を PATH 環境に追加する ```bash echo 'export PATH="/Applications/Calm.app/Contents/MacOS/:$PATH"'>> ~/.bashrc @@ -42,7 +46,7 @@ > echo 'export PATH="/c/calm/:$PATH"' >> ~/.bashrc > ``` - > Windows の場合、マイクロソフト社によって検証されていないため、システムがソフトウェアの実行を停止する確率が非常に高いです。実行に問題がある場合は、[SmartScreen をバイパスする方法を見つけてください](https://duckduckgo.com/?q=how+to+bypass+smartscreen)。 + > Windows の場合、マイクロソフト社によって検証されていないため、システムがソフトウェアの実行を停止する確率が非常に高いです。実行に問題がある場合は、[SmartScreen をバイパスする方法を見つけてください](https://www.google.com/search?q=how+to+bypass+smartscreen)。 これで準備万端、お楽しみください。 From 7ebc2d64306a9d867d65829d8c8f35605646321c Mon Sep 17 00:00:00 2001 From: VitoVan Date: Wed, 7 Aug 2024 19:20:37 +0800 Subject: [PATCH 2/2] Update docs/installation_JA.md Co-authored-by: Ikko Eltociear Ashimine --- docs/installation_JA.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/installation_JA.md b/docs/installation_JA.md index 2e5d40fc..565f3b6c 100644 --- a/docs/installation_JA.md +++ b/docs/installation_JA.md @@ -16,7 +16,7 @@ 2. .app をアプリケーションフォルダにドラッグします - 3. Trust me and de-quarantine Calm.app + 3. 私を信じて、Calm.appの隔離を解除してください。 ```bash xattr -d com.apple.quarantine /Applications/Calm.app