Watershot 安装和配置指南

Watershot 安装和配置指南

1. 项目基础介绍和主要编程语言

Watershot 是一个基于 Wayland 的简单截图工具，灵感来源于 Flameshot。该项目的主要编程语言是 Rust，Rust 是一种系统编程语言，以其安全性、并发性和性能而闻名。

2. 项目使用的关键技术和框架

Watershot 项目使用了以下关键技术和框架：

• Rust: 作为主要的编程语言，用于构建高效且安全的应用程序。
• Wayland: 用于实现原生的 Wayland 截图功能。
• Cargo: Rust 的包管理工具，用于管理依赖和构建项目。
• Nix: 用于管理项目的依赖和构建环境。
• Flameshot: 作为灵感的来源，提供了截图工具的基本功能。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在安装 Watershot 之前，请确保您的系统满足以下要求：

• Wayland 环境: Watershot 是一个 Wayland 原生应用，因此您需要在 Wayland 环境下运行。
• Rust 和 Cargo: 您需要安装 Rust 和 Cargo，以便编译和安装 Watershot。
• 系统依赖: 部分 Cargo 包依赖于系统库，您可能需要手动安装以下依赖：
  • fontconfig
  • pkgconfig
  • libxkbcommon

详细安装步骤

步骤 1: 安装 Rust 和 Cargo

如果您还没有安装 Rust 和 Cargo，可以通过以下命令安装：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装完成后，确保 Rust 和 Cargo 已正确安装：

rustc --version
cargo --version

步骤 2: 克隆 Watershot 仓库

使用 Git 克隆 Watershot 仓库到本地：

git clone https://github.com/Kirottu/watershot.git
cd watershot

步骤 3: 安装 Watershot

使用 Cargo 安装 Watershot：

cargo install --path .

步骤 4: 配置 Watershot

Watershot 支持通过配置文件自定义颜色、字体、大小等。配置文件位于 ~/.config/watershot.ron，使用 RON 配置格式。以下是一个示例配置：

Config(
    handle_radius: 10,
    line_width: 2,
    display_highlight_width: 5,
    selection_color: Color( r: 0.38, g: 0.68, b: 0.94, a: 1.0 ),
    shade_color: Color( r: 0.11, g: 0.0, b: 0.11, a: 0.6 ),
    text_color: Color( r: 1.0, g: 1.0, b: 1.0, a: 1.0 ),
    mode_text_size: 50,
    font_family: "monospace",
)

步骤 5: 运行 Watershot

安装完成后，您可以直接运行 Watershot：

watershot

使用说明

Watershot 提供了以下命令和选项：

• path: 指定保存截图的路径。
• directory: 指定保存截图的目录，文件名将自动生成。
• -c, --copy: 截图后复制到剪贴板。
• -s, --stdout: 将截图输出到标准输出，格式为 PNG。
• -g, --grim <GRIM>: 指定 grim 可执行文件的路径。
• -h, --help: 显示帮助信息。
• -V, --version: 显示版本信息。

通过以上步骤，您应该能够成功安装和配置 Watershot，并开始使用这个简单而强大的 Wayland 截图工具。