docs: add macOS installation guide

akiirui · Jan 23, 2023 · d8ca48b · d8ca48b
1 parent 9738fcb
commit d8ca48b
Show file tree

Hide file tree

Showing 3 changed files with 59 additions and 17 deletions.
diff --git a/README.md b/README.md
@@ -53,7 +53,7 @@ v_codec = [ av01, vp9, h265, h264 ]
 
 #### Manual installation
 
-1. Download [latest/linux][download-linux]
+1. Download [latest Linux release][download-linux]
 2. Unzip the archive
 3. Copy `mpv-handler` to `$HOME/.local/bin`
 4. Copy `mpv-handler.desktop` to `$HOME/.local/share/applications/`
@@ -74,16 +74,29 @@ $ xdg-mime default mpv-handler.desktop x-scheme-handler/mpv
 
 ### Windows
 
-Windows users need to install `mpv-handler` manually.
+Windows users need to install manually.
 
 #### Manual installation
 
-1. Download [latest/windows][download-windows]
+1. Download [latest Windows release][download-windows]
 2. Unzip the archive to the directory you want
 3. Run `handler-install.bat` register protocol handler
 4. Add **mpv** and **yt-dlp** to environment variable `PATH` (if needed)
 5. Edit `config.toml` (if needed)
 
+### macOS (Alpha)
+
+**I haven't tested it, if it doesn't work, please open an issue.**
+
+macOS users need to install manually
+
+#### Manual installation
+
+1. Download [latest macOS release][download-macos]
+2. Unzip the archive and copy `mpv-handler.app` directory to `$HOME/Applications`
+3. Add **mpv** and **yt-dlp** to environment variable `PATH` (if needed)
+4. Create `$HOME/Library/Application Support/mpv-handler/config.toml` and edit it (if needed)
+
 ## Configuration
 
 If you have already added **mpv** and **yt-dlp** to `PATH`, manual configuration is usually not required.
@@ -115,7 +128,8 @@ ytdl = "/usr/bin/yt-dlp"
 [badges-play-with-mpv]: https://img.shields.io/badge/dynamic/json?style=for-the-badge&label=play-with-mpv&prefix=v&query=version&url=https%3A%2F%2Fgreasyfork.org%2Fscripts%2F416271.json
 [download-aur-git]: https://aur.archlinux.org/packages/mpv-handler-git/
 [download-aur]: https://aur.archlinux.org/packages/mpv-handler/
-[download-linux]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-linux-x64.zip
-[download-windows]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-windows-x64.zip
+[download-linux]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-linux-amd64.zip
+[download-macos]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-macos-amd64.zip
+[download-windows]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-windows-amd64.zip
 [greasyfork-play-with-mpv]: https://greasyfork.org/scripts/416271-play-with-mpv
 [linuxuprising]: https://www.linuxuprising.com/2021/07/open-youtube-and-more-videos-from-your.html
diff --git a/README.zh-Hans.md b/README.zh-Hans.md
@@ -53,7 +53,7 @@ v_codec = [ av01, vp9, h265, h264 ]
 
 #### 手动安装
 
-1. 下载 [latest/linux][download-linux]
+1. 下载 [最新的 Linux 压缩包][download-linux]
 2. 解压缩压缩包
 3. 复制 `mpv-handler` 至 `$HOME/.local/bin`
 4. 复制 `mpv-handler.desktop` 至 `$HOME/.local/share/applications/`
@@ -74,16 +74,29 @@ $ xdg-mime default mpv-handler.desktop x-scheme-handler/mpv
 
 ### Windows
 
-Windows 用户目前只能手动安装 `mpv-handler`。
+Windows 用户目前只能手动安装。
 
 #### 手动安装
 
-1. 下载 [latest/windows][download-windows]
+1. 下载 [最新的 Windows 压缩包][download-windows]
 2. 解压缩档案到你想要的位置
 3. 运行 `handler-install.bat` 注册协议处理程序
-4. 添加 **mpv** 和 **yt-dlp** 到环境变量 `PATH`
+4. 如果需要，添加 **mpv** 和 **yt-dlp** 到环境变量 `PATH`
 5. 如果需要，更改 `config.toml`
 
+### macOS (Alpha)
+
+**我没有测试过它，如果它不工作，请通过 issue 反馈。**
+
+macOS 用户目前只能手动安装。
+
+#### 手动安装
+
+1. 下载 [最新的 macOS 压缩包][download-macos]
+2. 解压缩档案并复制 `mpv-handler.app` 文件夹到 `$HOME/Applications`
+3. 如果需要，添加 **mpv** 和 **yt-dlp** 到环境变量 `PATH`
+4. 如果需要，创建 `$HOME/Library/Application Support/mpv-handler/config.toml` 并按需更改
+
 ## 配置
 
 如果您已经把 **mpv** 和 **yt-dlp** 添加到了 `PATH`，通常来说不需要手动配置。
@@ -115,7 +128,8 @@ ytdl = "/usr/bin/yt-dlp"
 [badges-play-with-mpv]: https://img.shields.io/badge/dynamic/json?style=for-the-badge&label=play-with-mpv&prefix=v&query=version&url=https%3A%2F%2Fgreasyfork.org%2Fscripts%2F416271.json
 [download-aur-git]: https://aur.archlinux.org/packages/mpv-handler-git/
 [download-aur]: https://aur.archlinux.org/packages/mpv-handler/
-[download-linux]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-linux-x64.zip
-[download-windows]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-windows-x64.zip
+[download-linux]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-linux-amd64.zip
+[download-macos]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-macos-amd64.zip
+[download-windows]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-windows-amd64.zip
 [greasyfork-play-with-mpv]: https://greasyfork.org/scripts/416271-play-with-mpv
 [linuxuprising]: https://www.linuxuprising.com/2021/07/open-youtube-and-more-videos-from-your.html
diff --git a/README.zh-Hant.md b/README.zh-Hant.md
@@ -53,7 +53,7 @@ v_codec = [ av01, vp9, h265, h264 ]
 
 #### 手動安裝
 
-1. 下載 [latest/linux][download-linux]
+1. 下載 [最新的 Linux 壓縮包][download-linux]
 2. 解壓縮壓縮包
 3. 複製 `mpv-handler` 至 `$HOME/.local/bin`
 4. 複製 `mpv-handler.desktop` 至 `$HOME/.local/share/applications/`
@@ -74,16 +74,29 @@ $ xdg-mime default mpv-handler.desktop x-scheme-handler/mpv
 
 ### Windows
 
-Windows 用戶目前只能手動安裝 `mpv-handler`。
+Windows 用戶目前只能手動安裝。
 
 #### 手動安裝
 
-1. 下載 [latest/windows][download-windows]
+1. 下載 [最新的 Windows 壓縮包][download-windows]
 2. 解壓縮檔案到你想要的位置
 3. 運行 `handler-install.bat` 註冊協議處理程序
-4. 添加 **mpv** 和 **yt-dlp** 到環境變量 `PATH`
+4. 如果需要，添加 **mpv** 和 **yt-dlp** 到環境變量 `PATH`
 5. 如果需要，更改 `config.toml`
 
+### macOS (Alpha)
+
+**我沒有測試過它，如果它不工作，請通過 issue 反饋。**
+
+macOS 用戶目前只能手動安裝。
+
+#### 手動安裝
+
+1. 下載 [最新的 macOS 壓縮包][download-macos]
+2. 解壓縮檔案並複製 `mpv-handler.app` 文件夾到 `$HOME/Applications`
+3. 如果需要，添加 **mpv** 和 **yt-dlp** 到環境變量 `PATH`
+4. 如果需要，創建 `$HOME/Library/Application Support/mpv-handler/config.toml` 並按需更改
+
 ## 配置
 
 如果您已經把 **mpv** 和 **yt-dlp** 添加到了 `PATH`，通常來說不需要手動配置。
@@ -115,7 +128,8 @@ ytdl = "/usr/bin/yt-dlp"
 [badges-play-with-mpv]: https://img.shields.io/badge/dynamic/json?style=for-the-badge&label=play-with-mpv&prefix=v&query=version&url=https%3A%2F%2Fgreasyfork.org%2Fscripts%2F416271.json
 [download-aur-git]: https://aur.archlinux.org/packages/mpv-handler-git/
 [download-aur]: https://aur.archlinux.org/packages/mpv-handler/
-[download-linux]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-linux-x64.zip
-[download-windows]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-windows-x64.zip
+[download-linux]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-linux-amd64.zip
+[download-macos]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-macos-amd64.zip
+[download-windows]: https://github.com/akiirui/mpv-handler/releases/latest/download/mpv-handler-windows-amd64.zip
 [greasyfork-play-with-mpv]: https://greasyfork.org/scripts/416271-play-with-mpv
 [linuxuprising]: https://www.linuxuprising.com/2021/07/open-youtube-and-more-videos-from-your.html