Manage shared pinboards with the Goblin

You can share a pinboard from its tab menu, as Sync and sharing describes. This page is the other way in: typing a request to the Goblin. It is useful when you want to check who has access, or change access, without opening the Share Pinboard window.

Every request that changes something opens a review window in Goblin first. The review shows the pinboard's name, how many clips it holds and exactly what will change. Nothing happens until you confirm it there. Sharing needs Clipboard and iCloud sync on, and a pinboard that isn't locked.

Before you start#

1. Click Talk to Goblin in the main window toolbar.
2. Type List Clipboard Boards and send it. The reply lists each pinboard with its full ID, a long code of letters, numbers and dashes.
3. Copy the ID of the pinboard you want. The requests below take that ID where you see <board ID>.

Type each request exactly as written. A request that isn't understood changes nothing.

Check who can open a shared pinboard#

1. Type Read Clipboard Pinboard Sharing State <board ID> and send it.
2. The reply lists who can open the link and what they can do, then every other person with their ID and permission. The invitation link itself is never shown.

If the pinboard is someone else's, the reply says what you can do in it. Only the owner can manage other people's access. Goblin checks with iCloud each time, so the answer is current.

Invite someone#

1. Type Review Invite To Clipboard Pinboard <board ID> and send it.
2. An Invite To Clipboard Pinboard window opens. It warns that current and future clips in the pinboard may become visible to the people you invite.
3. Click Invite Using Native System Picker….
4. In the macOS sharing picker, choose how to send it (Messages, Mail or a link), who gets it, and whether they can only view or also change clips.

Opening the window or the picker doesn't send anything, and the Goblin can't tell whether an invitation was delivered. Ask for the sharing state afterwards to see who joined. Only the owner of an unlocked pinboard can invite.

Change link access#

The link can be open only to people you invited, or to anyone who has it.

1. Type Review Clipboard Pinboard Link Access followed by the board ID and your choices, like this:

   {"boardID":"<board ID>","access":"invitedOnly","permission":"readOnly"}

2. Use invitedOnly or anyoneWithLink for access, and readOnly or readWrite for permission (what people who open the link can do).
3. Read the review that opens, then confirm it.

Change or remove one person's access#

Get the person's ID from the sharing state first (see above).

1. To change what they can do, type Review Clipboard Pinboard Participant Permission followed by:

   {"boardID":"<board ID>","participantID":"<person ID>","permission":"readWrite"}

readOnly means they can view and paste. readWrite means they can also add and delete.

2. To remove them, type Review Remove Clipboard Pinboard Participant followed by:

   {"boardID":"<board ID>","participantID":"<person ID>"}

3. Read the review and confirm it. A removed person loses the pinboard from their Macs.

Use a person's ID exactly as it appears now. If it changed, Goblin refuses and asks for a fresh review.

Stop sharing a pinboard#

1. Type Review Stop Clipboard Pinboard Sharing <board ID> and send it.
2. Read the review and confirm it. Everyone else loses access. You keep the pinboard and everything in it.

Leave a shared pinboard#

For a pinboard someone else shared with you:

1. Type Review Leave Shared Clipboard Pinboard <board ID> and send it.
2. Read the review and confirm it. The pinboard comes off your Macs. The owner keeps it and can invite you again.

Removal can stay pending until sync finishes. The review can't be undone.

Cancel or check on a review#

• Read Clipboard Protection Review Result says how the last review ended.
• Cancel Clipboard Protection Review closes a review that is waiting, and closes the invitation window.

If the pinboard, its clips or its sharing changed while a review was open, Goblin refuses to apply it and asks you to start again. Cancel never undoes something already done in iCloud or in the sharing picker, and Undo in the strip doesn't either.