Both of you signed in to your own Straight Pool Deluxe account, each on your own iPad, with Straight Pool Cloud. (Everyone who bought the app before version 6.0 already has it. Otherwise it comes with Cloud Unlock.) Without it, the + SPD button doesn’t appear.
Their username, or the email address they registered with. It has to match exactly. To find your own username, look in Settings → Account, and read it to each other.
In the pictures, Alice is adding Bob.
On your iPad
Go to Settings → Players and tap the blue + SPD button. (The plain + next to it adds a local player. Don't use that one for Straight Pool Deluxe users.)
Type their username or email and tap Find.
Tap Send Request. Then tap OK on the "Request Sent" message.
That's it on your side. They're in your Players list right away with a gray SPD badge, and you can start a game against them now. Games you score are saved and wait for them until they accept.
Starting a game? You can do the same thing from the new-game screen: when choosing a player, tap + SPD, find them, and tap Add. The request goes out when the game is saved.
Already in your Players list?
If they’re already in your list with a gray SPD badge, you don’t need to search for them. Tap their name, then tap Send Request to Connect. If they’ve already asked you, the same screen shows Accept Request instead.
Changed your mind? Tap them again and choose Cancel Request.
On their iPad
The request shows up the next time their app syncs: when they open it after being away for a while, after they finish a game, or when they pull down on the Players list.
Settings → Requests shows a red number when something is waiting.
Tap Accept All. The card under Received says who it's from, with an Opponent request line and a Game against you line for each game they've already scored against you.
Done. You're now opponents. Every game between you, past and future, shows up on both iPads, and the other player gets a blue SPD badge in your Players list.
Other choices on the request
Accept or Decline one line at a time. Accepting a single game adds just that game to your history. It doesn’t connect you.
Accept on the Opponent request line connects you. If games are waiting too, the app asks “Also Accept 1 Game?” first, so you can decline any game you don’t want before connecting.
Decline asks for an optional reason, which the sender will see. They can’t ask again for a week.
Checking on a request you sent
Settings → Requests → Sent lists your requests: still waiting (with Cancel), accepted, declined (with their reason, if they gave one), or expired. A request that’s declined, cancelled or expired can be sent again with Send Again. Requests expire after 60 days.
Disconnecting or removing an opponent
Tap a connected opponent in Settings → Players to open their SPD Player screen:
Disconnect… stops your games from syncing automatically. They stay in your Players list, marked not connected, and games you’ve already synced stay put. From then on, a game either of you scores against the other arrives as a request the other can accept. To reconnect, either of you can send a new request.
Remove from Players… takes them off your list, and also ends the connection. The app then asks whether to keep the games you played against them.
Both ask you to confirm first. Remove from Players… is at the bottom of every player’s screen, including local players and opponents you aren’t connected to.
If something goes wrong
“No User Found”: check the spelling of the username, or try their email address. It must match exactly.
“Already Here”: they’re already in your Players list. Look for their name with an SPD or SPD badge.
“Try Again Later”: they declined a recent request. You can ask again after the date shown.
Accepted, but your iPad still shows a gray badge? Pull down on the Players list to sync, or tap Sync Now in Settings → Sync. You can also tap their name to see the request’s status.
They don’t see a Requests screen? They need app version 6.1 or later. Your request waits until they update.