Getting the beta
Open mahjable.com/beta on your iPhone or iPad and tap Get the beta. If the App Store offers you TestFlight first, install it, come back, and tap the button again. You’ll need iOS 17 or later.
Scanning your card
- Lay the card flat, in good light.
- Scan the whole card at once, holding your phone sideways, or one page at a time. Either works.
- Tap Auto at the top of the scanner so it says Manual, then take the picture yourself, holding still.
- Leave a little table showing all around the card. If the app says the edge was cut off, scan that page again.
A hand was read wrong
Nothing is stuck the way it was read. Open the card or the hand and put it right: every hand on a card can be reviewed one at a time against the line it came from.
Your hands and your privacy
MahjWins and MahjCoach need no account, and your journal stays on your device. The privacy page says exactly what is sent and why.
Keeping score at a real table
- One of you opens MahjMix, goes to Scores and taps Start keeping score. The others join the scorecard by scanning its QR code with the camera, tapping its link, or typing its five-letter code.
- Anyone without the app can be added by name. Their wins count on the scorecard.
- Anyone at the table can Record a win: who won, the points from the card, Jokerless, and who threw the winning tile.
- When you’re done, tap We’re done, from the app or the Lock Screen. Everyone is sent the results to look over. At a game posted in Games, wins show in the standings right away, and are final a day later, unless someone disputes one. Any other scorecard is casual: its wins stay with your table.
- Recorded a win wrong? Tap it to change it, or take it off. Whoever recorded it can, and so can the host, until it’s final.
- A win that isn’t right: swipe it and tap Not right. The host says whether it stands. Disagree with the host? Write to us.
Recording a win by voice
- Say it: on Record a win, tap the microphone and say something like “Bea won thirty off Cy” or “I won fifty, Jokerless, self-drawn”. The form fills in; check it, then Save.
- Siri: say “Hey Siri, record a win in MahjMix”, then what happened. Siri reads it back before it’s saved.
- One press, with the Action Button (iPhone 15 Pro and later): Settings, Action Button, Shortcut, then MahjMix’s Record a win.
- Two taps on the back of your phone: Settings, Accessibility, Touch, Back Tap, Double Tap, then MahjMix’s Record a win.
- Your own words for Siri: in the Shortcuts app, tap +, add MahjMix’s Record a win, and name it, say, “Mahjong”. Then “Siri, Mahjong” starts it.
Both can be switched off in MahjMix, in You, Recording wins.
Playing online
- In MahjMix’s Play tab, start a table and share its code, or ask people from the table: a player by user name, one of your groups, or players near you (within the distance you chose in You, among those looking for games nearby). They’re sent a notification, and tapping it sits them down.
- Fill empty seats with computer players, each at its own level: Relaxed passes at random and hardly ever calls, Steady plays toward the closest hands on the card, and Sharp picks one hand and goes after it, and Expert also counts the tiles in sight and won’t throw what you look to be waiting for. They’re the same as MahjCoach’s, and play toward the card chosen on the host’s phone. With none chosen, they play Mahjable’s own practice card, written by us; it isn’t the League’s.
- The host chooses the card in the table’s lobby. Everyone plays from their own copy: one scanned in MahjWins or MahjCoach, or the card on paper. The card’s hands never leave anyone’s phone: the others are only told its name. A scanned copy checks your Mahjong before it’s called.
- The Charleston is played in full: on the last pass of each, pick fewer than three and the rest go on blind, tiles passed to you that you never see. After it, the optional courtesy pass trades up to three with the player across; only as many change hands as the one offering fewer.
- Leave at any time with Leave: a computer takes your seat so the others can carry on. If someone loses their signal, a computer plays for them after 30 seconds, until they’re back.
Friends, groups and messages
- Friends, in MahjMix’s You, is your own list: nobody else sees it. Add someone and they’re told, so they can add you back. Your games for friends reach them once you’re on each other’s lists, so someone who adds you can’t send you games. Swipe to remove someone; they aren’t told.
- Groups are shared, for the people you play with together, like Family or Thursday Ladies: post games just to them, and chat. Someone you add to a group is asked first, and is in once they say yes, or send its code, link or QR code.
- Find people by part of their user name with Find people. Turn off Let people find me by user name in You, and only people who know you already (a group shared, or a game played together) can add or invite you.
- Played with, in You, lists everyone you’ve played a game with, at a scorecard with a win or a finished game online, each with Add to Friends.
- To message someone privately, open a group and tap them. Touch and hold any message to report it to us or block whoever wrote it.
Who sees your games
- A game you post is for your friends: friends who have you on their list too, everyone in your groups, and everyone you’ve played with. They’re told, and can take a seat.
- On a game, Invite someone invites friends, people you’ve played with, or anyone on MahjMix by user name. They’re told and can take a seat, whoever the game is for. Or send a link, for anyone.
- Post it Open to players nearby and players near you who look for open games see it too. They ask to join, and you say yes or no; they’re told either way. Anyone else you send a game’s link to asks too.
- In You, Finding games: show open games nearby or not, how far nearby reaches (5 to 50 miles), whether to measure from your ZIP code or roughly where your phone is, and whether your new games start open.
Signing in
Sign in with your password, or tap Email me a code instead: that’s also the way in if you forget your password. Signing in to one of the apps signs you in to all three on that phone. Your account is at mahjable.com/account.
Getting in touch
Write to support@mahjable.com. We read every message.
Trying the beta? In TestFlight, take a screenshot and it offers to send it, or tap Send Feedback. It comes straight to us, with the details attached.