Ani2xcur CLI

✨一站式鼠标指针转换与管理工具

• Ani2xcur CLI
• 简介
• 功能特性
• 安装
• 使用
  • 鼠标指针格式转换
    • Windows 转 Linux
    • Linux 转 Windows
  • 鼠标指针管理
    • 安装指针
    • 卸载指针
    • 设置指针主题和大小
    • 查看指针信息
    • 导出指针
  • ImageMagick 管理
    • 自动下载并安装 ImageMagick
    • 从系统中卸载 ImageMagick
  • 更新 Ani2xcur CLI
  • 查看 Ani2xcur CLI 使用的环境变量
  • 调试日志
  • 查看 Ani2xcur CLI 版本信息
• 使用的项目
• 许可证

---

简介

Ani2xcur CLI 是一个强大且易于使用的命令行工具，专为鼠标指针主题的管理、转换和安装而设计，支持 Windows 平台与 Linux 平台。

功能特性

• 跨平台支持: 完美兼容 Windows 和主流 Linux 桌面环境。
• 格式转换:
  • 将 Windows 鼠标指针主题 (.inf, .ani, .cur) 转换为 Linux Xcursor 主题。
  • 将 Linux Xcursor 鼠标指针主题 (index.theme) 转换为 Windows 格式。
• 指针管理:
  • 安装: 轻松将本地或压缩包中的指针主题安装到系统中。
  • 卸载: 按名称移除已安装的指针主题。
  • 设置: 一键应用系统中的指针主题和调整指针大小。
  • 查看: 列出所有已安装的指针主题，并显示当前使用的主题和大小。
  • 导出: 将系统中的指针主题导出为文件，方便备份和分享。
• 智能识别: 自动在压缩包或目录中查找指针配置文件 (.inf 或 index.theme)。
• 辅助管理: 保留独立的 ImageMagick 安装和卸载命令，可用于手动排障；当前转换流程不依赖 ImageMagick。

安装

确保您的系统已安装 Python 3.10+。

pip install ani2xcur

使用

Ani2xcur CLI 提供了丰富的子命令来满足不同需求。可使用--help查看可用的命令。

ani2xcur --help

鼠标指针格式转换

Windows 鼠标指针主题和 Linux 鼠标指针主题并不能互相兼容，而 Ani2xcur CLI 可以将鼠标指针主题文件转换为对应平台的文件。

鼠标指针主题的转换功能由 Ani2xcur 内置的 Pillow 转换器完成，不需要额外安装 ImageMagick。

Windows 转 Linux

将 Windows 指针主题转换为 Linux Xcursor 主题，兼容 X11 和 Wayland/XWayland 的标准 Xcursor 加载路径。转换结果默认会在每个真实光标文件中补齐 24, 28, 32, 40, 48, 56, 64, 72, 80 这些名义尺寸，方便桌面环境切换不同鼠标指针大小。

ani2xcur convert win2x <Windows 指针路径或者是鼠标指针压缩包下载链接>

• 高级选项:
  • --output-path <路径>: 保存转换后的鼠标指针路径。
  • --shadow: 是否模拟 Windows 的阴影效果。
  • --shadow-opacity <不透明度>: 阴影的不透明度 (0 到 255)。
  • --shadow-radius <分数值>: 阴影模糊效果的半径 (宽度的分数值)。
  • --shadow-sigma <分数值>: 阴影模糊效果的西格玛值 (宽度的分数值)。
  • --shadow-x <偏移量>: 阴影的 x 偏移量 (宽度的分数值)。
  • --shadow-y <偏移量>: 阴影的 y 偏移量 (宽度的分数值)。
  • --shadow-color: 阴影的颜色 (十六进制颜色格式)。
  • --scale <倍数>: 按指定倍数缩放光标。
  • --xcursor-size <尺寸>: 自定义写入的 Xcursor 名义尺寸，可重复传入；不传则使用默认尺寸列表。
  • --compress: 转换完成后将鼠标指针打包成压缩包。
  • --compress-format <压缩包格式>: 打包成压缩包时使用的压缩包格式 (.zip|.7z|.rar|.tar|.tar.Z|.tar.lz|.tar.lzma|.tar.bz2|.tar.7z|.tar.gz|.tar.xz|.tar.zst)。
  • --install: 在转换完成后立即安装鼠标指针到系统中。
  • --install-path <安装路径>: 自定义鼠标指针文件安装路径。

Linux 转 Windows

将 Linux Xcursor 指针主题转换为 Windows 格式。

ani2xcur convert x2win <Linux 指针路径或者是鼠标指针压缩包下载链接>

• 高级选项:
  • --output-path <路径>: 保存转换后的鼠标指针路径。
  • --scale <倍数>: 按指定倍数缩放光标。
  • --compress: 转换完成后将鼠标指针打包成压缩包。
  • --compress-format <压缩包格式>: 打包成压缩包时使用的压缩包格式 (.zip|.7z|.rar|.tar|.tar.Z|.tar.lz|.tar.lzma|.tar.bz2|.tar.7z|.tar.gz|.tar.xz|.tar.zst)。
  • --install: 在转换完成后立即安装鼠标指针到系统中。
  • --install-path <安装路径>: 自定义鼠标指针文件安装路径。

鼠标指针管理

安装指针

从本地路径（压缩包、.inf 文件或 index.theme 文件）安装指针主题。

ani2xcur cursor install <指针路径>

• 高级选项:
  • --install-path <安装路径>: 自定义鼠标指针文件安装路径, 默认为鼠标指针配置文件中指定的安装路径。
  • --use-inf-config-path: (仅 Windows 平台) 使用 INF 配置文件中的鼠标指针安装路径。

卸载指针

按名称删除一个已安装的指针主题。

ani2xcur cursor uninstall <指针名称>

• 高级选项:
  • -y|--yes: 直接确认卸载鼠标指针。

设置指针主题和大小

设置当前系统指针主题。

ani2xcur cursor set theme <指针名称>

设置指针大小。

ani2xcur cursor set size <大小值>

• 指针大小值范围:
  • Windows 系统中为 1-15, 对应 Windows 11 设置中的鼠标指针大小滑块, 默认值为 1。
  • Linux 系统中为 16-96, 默认值为 24。

查看指针信息

列出系统中所有已安装的指针。

ani2xcur cursor list

显示当前正在使用的指针主题和大小。

ani2xcur cursor status

导出指针

将已安装的指针导出到指定目录。

ani2xcur cursor export <指针名称> <导出路径>

• 高级选项:
  • --custom-install-path <路径>: 自定义鼠标指针配置文件在安装时的文件安装路径。
  • --compress: 导出完成后将鼠标指针打包成压缩包。
  • --compress-format <压缩包格式>: 打包成压缩包时使用的压缩包格式 (.zip|.7z|.rar|.tar|.tar.Z|.tar.lz|.tar.lzma|.tar.bz2|.tar.7z|.tar.gz|.tar.xz|.tar.zst)。

ImageMagick 管理

Ani2xcur CLI 保留 ImageMagick 管理命令用于手动排障；当前内置转换器不需要安装 ImageMagick。

自动下载并安装 ImageMagick

ani2xcur imagemagick install

• 高级选项:
  • --install-path <安装路径>: (仅 Windows 平台) 自定义安装 ImageMagick 的目录。
  • -y|--yes: 直接确认安装。

从系统中卸载 ImageMagick

ani2xcur imagemagick uninstall

• 高级选项:
  • -y|--yes: 直接确认卸载。

更新 Ani2xcur CLI

ani2xcur update

• 高级选项:
  • --install-from-source: 更新时是否从源码进行安装。
  • --ani2xcur-source <Git 仓库链接>: Ani2xcur 源仓库的 Git 链接。

查看 Ani2xcur CLI 使用的环境变量

ani2xcur env

调试日志

临时排查转换、安装或桌面刷新问题时，可以使用全局 --debug 选项输出关键链路日志：

ani2xcur --debug cursor set size 32 > log.txt 2>&1

也可以继续使用环境变量开启 debug 日志：

ANI2XCUR_LOGGER_LEVEL=10 ani2xcur cursor set theme Blue > log.txt 2>&1

调试日志会记录命令、会话类型、Xcursor 相关环境变量和转换摘要，不会输出完整环境变量或光标文件二进制内容。

查看 Ani2xcur CLI 版本信息

ani2xcur version

使用的项目

• Pillow: 图像解码与处理。
• Breeze cursor: 鼠标指针补全文件。

许可证

• GPL-3.0