# Technical notes

This page is a home for some technical details that didn't quite fit anywhere
else.

## Release terminology

The documentation uses the following terminology to refer to PopClip releases:

- **Edition:** _Standalone_, _Mac App Store_ or _Setapp_. (See:
  [Obtaining PopClip](https://www.popclip.app/guide/install.md#obtaining-popclip).)
- **Channel:** [Production](https://www.popclip.app/download) or [Beta](https://www.popclip.app/beta).

## Version numbering

PopClip versions are presented in the form `version string (build number)`, for
example `2023.7 (4151)`, with the following meaning:

- **Version string:**
  - **Production releases:** Production releases of PopClip have a version
    string in the form `year.month`, e.g. `2023.7`, corresponding to when the
    version was released. For minor bugfix releases, a third number is added,
    e.g. `2023.7.1`.

  - **Beta releases:** Beta versions have version strings such as `Build 4151`.

- **Build number:** The number in parentheses after the version string is the
  build number, which identifies the source code version that generated
  this release. The build number increases monotonically — it's simply a count
  of git commits on the release branch.

**Note: Build number anomaly**

The build number is consistent across all editions and release channels, except
that the Mac App Store edition build number is always 1000000 higher than the
other editions. For example, version `2023.7 (4151)` of the Standalone Edition
is the same version as `2023.7 (1004151)` of the Mac App Store Edition.

## How to take screenshots of PopClip

> When I try to take a screenshot, the PopClip bar disappears. Is there a secret
> to taking such a screenshot?

In Terminal, enter:

`defaults write com.pilotmoon.popclip ScreenshotMode -bool YES`

then Quit and restart PopClip. Now you can use ⌘⇧4 to take a shot, and PopClip
won't disappear when you press the keys.

When you've done with screenshots and want to go back to normal:

`defaults write com.pilotmoon.popclip ScreenshotMode -bool NO`

## How to find all instances of PopClip.app on your Mac

Terminal command:

```
mdfind "kMDItemCFBundleIdentifier == 'com.pilotmoon.popclip*'"
```

Example output:

```
/Applications/PopClip.app
/Users/nick/Downloads/PopClip.app
/Applications/Setapp/PopClip.app
```

To delete them all:

```
mdfind -0 "kMDItemCFBundleIdentifier == 'com.pilotmoon.popclip*'" | xargs -0 -n1 rm -r
```

## Transfer extensions and settings to a different Mac

Enable PopClip's [iCloud sync](https://www.popclip.app/kb/sync.md) on your current Mac first.
Everything will sync to the new Mac automatically.

## Browser support for website exclusion

The PopClip feature for excluding websites only works in some browsers — these
have "Page Info" checked on the [browser support](https://www.popclip.app/kb/browsers.md) table.