跳转到内容
iTally

安装

iTally 服务端和启动器安装在一台电脑上，其他终端通过局域网连接这台电脑。

系统要求

Section titled “系统要求”
  • 一台电脑：Mac（macOS 15 Sequoia 或更高版本）、Windows（x64）或 Linux（x64、ARM64）。
  • 这台电脑与切换台、手机处于同一局域网，并能 ping 通切换台的 IP。

选择安装包

Section titled “选择安装包”
系统 安装包
macOS，Apple 芯片（M1 及更新机型） iTally <版本> arm64.dmg
macOS，Intel iTally <版本> amd64.dmg
Windows（x64） iTally Setup <版本> amd64.exe
Linux（x64 / ARM64） Debian 安装包 itally_<版本>_<架构>.deb，或包含 install.sh 的 itally-<版本>-linux-<架构>.tar.gz（无需 root 权限）

如何确认 Mac 类型：选择苹果菜单 >「关于本机」，查看「芯片」（Apple 芯片）或「处理器」（Intel）。

安装步骤

Section titled “安装步骤”
  1. 从官网下载区下载对应的安装包，然后安装：
    • macOS：打开 DMG，将 iTally 拖入「应用程序」。
    • Windows：运行安装程序。
    • Linux：运行 sudo apt install ./itally_<版本>_<架构>.deb；或解压后运行 sh install.sh。
  2. 打开 iTally。首次打开时会安装后台服务；macOS 会显示「已添加后台项目」通知，属正常现象。
  3. 点击窗口中间的「打开控制台」，浏览器即打开控制台。下一步请参阅首次设置。

Linux 的托盘图标需要 libayatana-appindicator3-1（Debian 安装包会自动安装；GNOME 还需启用 AppIndicator 扩展）。没有托盘时，可从应用程序菜单打开启动器窗口。

启动器

Section titled “启动器”

启动器位于 macOS 的菜单栏，或 Windows、Linux 的任务栏托盘。

  • 打开控制台：服务运行时直接打开；未运行时先启动服务，最多等待约 10 秒后打开浏览器。启动失败时，错误仅显示在启动器窗口中。
  • 服务状态：显示服务当前是否在运行；在菜单中点击可打开启动器窗口。
  • 启动服务 / 停止服务：同一个菜单项，根据服务当前状态显示。
  • 开机自启动（默认开启）：登录后自动运行服务并打开启动器。关闭后，需要时请点击「启动服务」。
  • 打开日志：打开服务日志所在的文件夹。
  • 检查更新…：检查 iTally 是否有新版本；启动器也会在后台自动检查。
  • 其他电脑（仅在窗口中）：允许局域网内的其他电脑凭访问码打开控制台，详见其他电脑访问。

服务以当前用户身份在后台独立运行，无需管理员权限。关闭浏览器、关闭窗口或退出启动器，都不影响终端显示。服务意外退出后会自动重启；点击「停止服务」后则不会。

文件位置

Section titled “文件位置”
系统 配置 日志
macOS ~/Library/Application Support/iTally/config.yaml ~/Library/Logs/iTally/server.log
Windows %APPDATA%\iTally\config.yaml %LOCALAPPDATA%\iTally\Logs\server.log
Linux ~/.config/iTally/config.yaml（设置了 XDG_CONFIG_HOME 时，位于该目录下） ~/.local/state/iTally/server.log

配置文件仅当前用户可读写，其中保存管理令牌和切换台密码。控制台中的修改即时生效，并写回配置文件。手动编辑配置文件后，需在启动器中依次点击「停止服务」和「启动服务」才能生效。配置有误时服务不会启动，原因记录在日志中。

卸载

Section titled “卸载”
  1. 在启动器菜单中点击「停止服务」。
  2. 关闭「开机自启动」。
  3. 在菜单中点击「退出」，然后删除 App：
    • macOS：把 iTally 移到废纸篓。
    • Windows：在「设置 > 应用」中卸载 iTally。
    • Linux：运行 sudo apt remove itally 或 sh install.sh --uninstall。
  4. 可选：删除设置和数据：
    • macOS：~/Library/Application Support/iTally/（配置文件和服务的 plist）以及 ~/Library/Logs/iTally/。如果跳过了第 2 步，还需删除 ~/Library/LaunchAgents/com.itally.server.plist。
    • Windows：%APPDATA%\iTally\ 和 %LOCALAPPDATA%\iTally\。
    • Linux：~/.config/systemd/user/itally-server.service、~/.config/iTally/ 和 ~/.local/state/iTally/。