From b4909dcab39e48327eab35cd0a85a6ceb69c5352 Mon Sep 17 00:00:00 2001 From: licyk Date: Thu, 4 Apr 2024 18:04:00 +0800 Subject: [PATCH] update README --- README.md | 126 ++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 88 insertions(+), 38 deletions(-) diff --git a/README.md b/README.md index 3f9532d..1927921 100644 --- a/README.md +++ b/README.md @@ -1,39 +1,89 @@ # ani2xcur -一个将windows鼠标指针转换为linux鼠标指针的脚本，拥有TUI界面，转换核心基于win2xcur -使用前需要安装python(3.6~3.9)，aria2，dialog。 - -## 使用方法： - -下载ani2xcur - - aria2c https://raw.githubusercontent.com/licyk/ani2xcur/main/ani2xcur.sh &&chmod +x ani2xcur.sh - -如果下载失败可以使用代理站下载 - - aria2c https://ghproxy.com/https://raw.githubusercontent.com/licyk/ani2xcur/main/ani2xcur.sh &&chmod +x ani2xcur.sh - -运行ani2xcur - - ./ani2xcur.sh - -# ani2xcur-core -这个是ani2xcur的核心版本，去掉了dialog,只保留基本的转换功能 - -## 使用方法： - -下载ani2xcur-core - - aria2c https://raw.githubusercontent.com/licyk/ani2xcur/main/ani2xcur-core.sh &&chmod +x ani2xcur-core.sh - -如果下载失败可以使用代理站下载 - - aria2c https://ghproxy.com/https://raw.githubusercontent.com/licyk/ani2xcur/main/ani2xcur-core.sh &&chmod +x ani2xcur-core.sh - -将ani2xcur-core脚本和鼠标指针放在一起(所在目录要有.inf文件)，运行 - - ./ani2xcur-core.sh - -# 使用项目 - -[win2xcur](https://github.com/quantum5/win2xcur)@quantum5 --- 转换核心 -[breeze cursor](https://store.kde.org/p/999927) --- 用作鼠标指针的补全 +## 简介 +一个将 Windows鼠标指针转换为 Linux 鼠标指针的脚本，基于GNU 项目的 Dialog 实现显示界面，转换核心基于 win2xcur + +## 环境要求 +- Python（3.6 ~ 3.9） +- Dialog + +## 安装 +- 1、克隆项目 +``` +git clone https://github.com/licyk/ani2xcur +``` + +- 2、进入目录并给予执行权限 +``` +cd ani2xcur +chmod +x ani2xcur +``` + +- 3、创建并进入虚拟环境 +>该步骤为可选步骤 +``` +python -m venv venv +source venv/bin/activate +``` + +- 4、运行 +``` +./ani2xcur.sh +``` + +## 使用 +进入 Ani2xcur界面后，可以主界面选择`安装 win2xcur 核心`安装转换鼠标指针所需的必要核心 + +安装核心完成后，可选择`进入文件浏览器`进入 Ani2xcur 的文件浏览器来寻找鼠标指针文件，一般 Windows 的鼠标指针文件包含`cur`/`ani`格式的文件（鼠标指针图标）和`inf`格式的文件（安装鼠标指针的配置文件） +>这是 Windows 鼠标指针安装文件的结构 +``` +咩咩 +├── bashi.ani +├── dianliu.ani +├── DJye1.ani +├── DJye2.ani +├── doki.ani +├── help.ani +├── lightning.ani +├── lingdang.ani +├── merry.ani +├── Mye.ani +├── Pye.ani +├── Sye.ani +├── wink.ani +├── woniu.ani +├── yangtuo.ani +└── 右键安装.inf +``` + +在 Ani2xcur 文件浏览器中选中其中一种格式后即可开始转换，转换好的鼠标指针文件将保存在 Ani2xcur 文件夹中的`output`文件夹 + +Ani2xcur 也支持命令行模式运行，通过启动参数指定`安装鼠标指针的配置文件`的路径后即可进行转换 +例如 +``` +./ani2xcur.sh --inf "/home/licyk/Downloads/咩咩/lingdang.ani" +./ani2xcur.sh --inf "/home/licyk/Downloads/咩咩/右键安装.inf" +``` +>以上命令的执行效果等效 + +Ani2xcur 支持以下启动参数 +``` +使用: + ./ani2xcur.sh --help [--set-python-path python_path] [--inf inf_file_path] [--install-win2xcur] [--remove-win2xcur] + +参数: + --help + 显示 Ani2xcur 启动参数帮助 + --set-python-path python_path + 指定 Python 解释器路径。推荐在 Python 虚拟环境中启动 Ani2xcur, 这将可省去使用启动参数指定 Python 路径 + --inf inf_file_path + 指定 inf 鼠标配置文件路径, 若路径有效, 则 Ani2xcur 将以命令行模式启动, 直接进行鼠标指针转换 + --install-win2xcur + 安装 win2xcur 核心 + --remove-win2xcur + 卸载 win2xcur 核心 +``` + +## 使用项目 + +[win2xcur](https://github.com/quantum5/win2xcur) @quantum5 --- 转换核心 +[breeze cursor](https://store.kde.org/p/999927) --- 用作鼠标指针的补全