Install ClipHearth
Which build to pick for your machine, what each installer does, what the first start looks like, and how to verify the file you downloaded.
01Windows
Download the 64-bit installer unless you know you're on 32-bit Windows, then run it. ClipHearth needs Windows 10 or later - Windows 7 and 8.1 are no longer supported. Since 1.6.7 the installer puts ClipHearth into your own account (like most desktop apps), so neither installing nor updating asks for an administrator. If an earlier version was installed for everyone on the computer, the installer removes that copy after you click Install, and Windows asks for permission once. Everything the app uses, including FFmpeg, is bundled. The installer adds the Microsoft Edge WebView2 Runtime if your computer does not have it yet, so keep the internet connection on during setup.
02macOS
Pick Apple Silicon if your Mac has an M-series chip (Apple menu → About This Mac shows "Apple M…"), otherwise Intel. Open the disk image and drag ClipHearth onto Applications. The builds are signed with a Developer ID and notarized by Apple, so the first launch opens straight away.
03Linux
On Debian, Ubuntu, and Mint, download the .deb for your processor and install it with sudo apt install ./cliphearth_<version>_amd64.deb (arm64 on ARM machines). apt pulls in the system libraries the app needs and adds the ClipHearth repository. Later versions arrive with your normal system updates, and Update now in ClipHearth installs them through the system's own software service, which asks for a password only where your system requires one. On other distributions, unpack the tar.gz archive and run ./install.sh: it installs ClipHearth for your user (or system-wide with sudo and a target folder) and lists the packages your distribution still needs.
04Adding the repository by hand (optional)
The .deb adds it for you. If you prefer to set it up yourself first: curl -fsSL https://api.cliphearth.com/apt/cliphearth-archive-keyring.gpg | sudo tee /usr/share/keyrings/cliphearth-archive-keyring.gpg > /dev/null, then add the line deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/cliphearth-archive-keyring.gpg] https://api.cliphearth.com/apt stable main to /etc/apt/sources.list.d/cliphearth.list, and run sudo apt-get update && sudo apt-get install cliphearth.
05Verify the download (optional)
Every release has a SHA256SUMS.txt next to the files. Compare it with shasum -a 256 <file> on macOS or Linux, or Get-FileHash <file> -Algorithm SHA256 in Windows PowerShell. The values must match exactly.
06The first start
A new installation opens with a short welcome in three steps. Get started shows what ClipHearth does. Then come the Terms of Use, with the short version in three cards (Media you may save, 3 free tasks, Your files stay yours) and the full text below. Tick the box and press Accept and continue. The last step asks what to do first: Download from a link, Find it on a site, Record the screen, or Edit a file, and has I already have a license key for a key you bought. Start ClipHearth opens the app on Home, where the same choices sit as tiles. When the Terms of Use change in a later version, only that step is shown again.
Didn't solve it? Write to us - attach a diagnostics log if you have one. Missing a feature? Tell us what you would use it for; several of the recent ones started as a suggestion.