itch 中文文档 下载 App

itch:// 协议链接:从网页或命令行直达应用页面

安装客户端时会向系统注册 itch://(以及等价的 itchio://)协议。任何地方——网页、聊天工具、命令行——打开这类链接,应用都会被拉到前台执行对应动作。这是把应用当自动化组件用的官方入口。

两条规则先记住

  1. 没有链接会静默执行操作:动作类链接只是打开一个对话框等你确认,未登录时链接会被保存,登录完成后继续。
  2. 导航类链接只负责打开页面。

动作类链接

itch://install?game_id=<游戏id>
itch://install?game_id=<游戏id>&upload_id=<文件id>
itch://install?game_id=<游戏id>&launch
itch://steam-shortcuts
itch://steam-shortcuts?game_id=<游戏id>&mode=direct

常用导航链接

链接打开
itch://library / library/owned / library/installed库 / 拥有 / 已安装
itch://collections集合列表
itch://games/\<id\>某游戏页面
itch://featured探索页
itch://dashboard创作者面板
itch://downloads下载页
itch://preferences / locations偏好设置 / 安装位置
itch://applog应用日志(排障用)

普通的 itch.io 网址也认:把游戏页网址丢给应用,就在内置浏览器里打开那个页面。

命令行打开

# Linux
xdg-open "itch://install?game_id=12345&launch"
# macOS
open "itch://install?game_id=12345&launch"
# Windows (PowerShell/CMD)
start "" "itch://install?game_id=12345&launch"

把链接直接作为应用可执行文件的参数也可以(Linux 与 Windows)。需要无人确认的静默启动时,改用 itch-setup 的无头模式,见 无头启动游戏。