Installation | yanklog

Before you install

Supported architectures: Linux 2.2.2 ships x86_64 and aarch64 AppImages for Ubuntu 22.04+ era systems, plus a Flatpak package for distributions with Flatpak support. macOS 1.4.0 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.
Shared product experience: All current builds include complete-history search, Quick Pick, privacy filters, timed pause, safe deletion, onboarding, and encrypted backup and restore. Update delivery and desktop integration differ by channel.
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.

Install on Linux

Recommended Linux path: download the installer, read it, then run it. Requires glibc 2.35+. Prefer Flatpak? See the Flatpak option below.

# 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

Install on Linux with Flatpak

Recommended for distributions with Flatpak support (Fedora, Linux Mint, etc.). Installs from the self-hosted yanklog repository and updates through your software center or flatpak update.

# Add the yanklog flatpak repository (unsigned, so no-gpg-verify)

flatpak remote-add --user --if-not-exists yanklog https://downloads.yanklog.com/linux/flatpak/yanklog.flatpakrepo --no-gpg-verify

flatpak install --user yanklog com.yanklog.YankLog

flatpak run com.yanklog.YankLog

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 2.2.2 --no-path-update

# macOS

sh install-macos.sh --version 1.4.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

# Linux Flatpak install

flatpak uninstall --delete-data com.yanklog.YankLog

flatpak remote-delete yanklog

# macOS app files

rm -rf "$HOME/Applications/YankLog.app" "$HOME/.local/bin/yanklog"

# macOS local history/config

rm -rf "$HOME/Library/Application Support/YankLog"