中文文档

Introduction

This is a screen recording tool for Linux and Windows. It is based on Rust and the Slint GUI framework. Compatible Linux desktop environments include Sway, Hyprland, Ubuntu, KDE, and others.

Features

• Single screen recording
• Single input device audio recording
• Desktop audio recording
• Microphone noise reduction
• Cursor tracking
• Manage recorded video history
• Play recorded historical videos

How to build?

• Install Rust, Cargo, libpipewire, libalsa, libx264 and QT6

• Run make desktop-debug to run it on desktop platform

• Run make desktop-build-release to build a release version desktop application for wayland wlr. Likes: Sway and Hyprland.

• Run make desktop-build-release desktop-features=desktop-wayland-portal to build a release version desktop application for wayland xdg-desktop-portal. Likes: Ubuntu and kde

• Run make desktop-build-release desktop-features=desktop-windows to build a release version desktop application for Windows

• Run make cursor-release to build the program for fetching the cursor position. This program needs to be used together with the portal version of wayshot.

• Refer to Makefile for more information

Troubleshooting

• Using the Qt backend can resolve the issue of fuzzy fonts on the Windows platform. It is also recommended to prioritize the Qt backend to maintain a consistent build environment with the developers.

• Check program output log information: RUST_LOG=debug wayshot。Available log level：debug, info, warn, error

• To use the cursor tracking feature with the Wayland xdg portal version, it needs to be used together with the wayshot-cursor program. The program can be downloaded from the Github page. The program must be run with administrator privileges: sudo -E wayshot-cursor. If you need to view logs, you can use: RUST_LOG=debug sudo -E wayshot-cursor. Available log levels: debug, info, warn, error

• Program version selection:

  • portal version: Ubuntu and KDE, etc.
  • wlr version: Sway and Hyprland, etc.

• Install build dependences on Ubuntu ：

  sudo apt install \
      libxcb-composite0-dev libasound2-dev libpipewire-0.3-dev \
      libx264-dev libx11-dev libxi-dev libxtst-dev libevdev-dev \
      qt6-base-dev qt6-tools-dev qt6-tools-dev-tools

• Windows compiles ffmpeg-next

  • Install LLVM (through official installer, Visual Studio, Chocolatey, or any other means), and add LLVM's bin path to PATH, or set LIBCLANG_PATH to that (see clang-sys documentation for additional info).
  • Install FFmpeg (complete with headers) through any means, e.g. downloading a pre-built "full_build-shared" version from https://ffmpeg.org/download.html. Set FFMPEG_DIR to the directory containing include and lib.
  • cargo build.
  • Add FFmpeg's bin path to PATH
  • You can find an example in https://github.com/zmwangx/rust-ffmpeg/blob/master/.github/workflows/build.yml.
  • Program dependencies: ffmpeg related libraries and libx264.dll. You can download the program from the release page, which includes the necessary dependencies.
  • git bash examples：

      export FFMPEG_DIR=C:/ffmpeg-8.0.1-full_build-shared
      export LIBCLANG_PATH="C:/Program Files/Microsoft Visual Studio/18/Community/VC/Tools/Llvm/x64/bin"
      make desktop-build-release desktop-features=desktop-windows

Reference

• Slint Language Documentation
• slint::android
• Running In A Browser Using WebAssembly
• github/slint-ui
• Viewer for Slint
• LSP (Language Server Protocol) Server for Slint
• developer.android.com
• How to Deploy Rust Binaries with GitHub Actions