Installation

Install yanklog without hiding the trust tradeoff.

The Mac App Store is the simplest macOS path. The Linux app and shared Rust core are open source under MIT. On Linux, download and inspect the installer before running it, or build from source.

Supported architectures

Linux ships x86_64 and aarch64 AppImages for Ubuntu 22.04+ era systems. macOS is available from the Mac App Store for macOS 13+ or as a direct universal app ZIP.

Update behavior

App Store installs update through the Mac App Store. Direct installs can use the tray/menu bar update item, in-app update dialog, or yanklog --update.

Linux installer behavior

The script downloads the AppImage and checksum, verifies SHA-256, installs to~/.local/bin/yanklog, creates desktop entries, and may add~/.local/bin to shell startup files unless you pass--no-path-update.

Build provenance

Linux AppImage releases publish SHA-256 checksums and build info files next to the binaries. The build info records the source commit, Cargo lockfile hash, Rust toolchain, build OS, and artifact hash.

Install on macOS from the Mac App Store

Recommended for most macOS users. Install yanklog for free and receive updates through Apple.

View in Mac App Store

Install on Linux

Recommended Linux path: download the installer, read it, then run it. Requires glibc 2.35+.

# Supports x86_64 and aarch64 on Ubuntu 22.04+ era systems
curl -fsSLO https://downloads.yanklog.com/install.sh
less install.sh
sh install.sh --no-path-update

Build Linux from source

Use this when you want to inspect the Linux app/core source and build locally.

git clone https://github.com/thisiseesmaeel/yanklog-linux.git
cd yanklog-linux
cargo test -p yanklog-core
cargo check -p yanklog-linux-native

Linux automation shortcut

Use this only when you are comfortable piping a remote installer into your shell.

curl -fsSL https://downloads.yanklog.com/install.sh | sh

Direct install on macOS

Install the signed and notarized universal app to ~/Applications and add ~/.local/bin/yanklog. The Mac App Store path is preferred for most macOS users.

curl -fsSLO https://downloads.yanklog.com/install-macos.sh
less install-macos.sh
sh install-macos.sh

Architecture-specific install

Force architecture explicitly when needed.

# x86_64
sh install.sh --arch x86_64 --no-path-update
# aarch64
sh install.sh --arch aarch64 --no-path-update
# shorthand for aarch64
sh install.sh --aarch --no-path-update

Install a specific version

Pin a specific release when validating or rolling back.

# Linux
sh install.sh --version 1.2.0 --no-path-update
# macOS
sh install-macos.sh --version 1.2.0

Update

Mac App Store installs update through the Mac App Store. Direct installs can use the app update action or terminal updater.

# Direct Linux or macOS install, after installing the CLI launcher
yanklog --update
# Linux manual fallback
curl -fsSLO https://downloads.yanklog.com/install.sh
less install.sh
sh install.sh --no-path-update
# macOS manual fallback
curl -fsSLO https://downloads.yanklog.com/install-macos.sh
less install-macos.sh
sh install-macos.sh

Uninstall

Remove installed app files. For Mac App Store installs, remove YankLog from Launchpad or Finder. Add the data-removal commands only when you also want to erase clipboard history and settings.

# Linux app files
curl -fsSLO https://downloads.yanklog.com/uninstall.sh
less uninstall.sh
sh uninstall.sh
# Linux app files plus local history/config
sh uninstall.sh --remove-data
# macOS app files
rm -rf "$HOME/Applications/YankLog.app" "$HOME/.local/bin/yanklog"
# macOS local history/config
rm -rf "$HOME/Library/Application Support/YankLog"