Pikafish Web Help
Screenshots show the Chinese interface; follow the numbered labels.
Usage guide
Basics
Interface
- 1Toolbar: buttons for the main features
- 2Board: select a piece, then its destination
- 3Navigation: step through the moves; ▶ in the middle autoplays
- 4Panels: engine, ChessDB (switchable to master games), evaluation and moves; swipe, or tap the panel name (such as
Engine) left of the move buttons, to switch - 5Move list: tap a move to jump to it
- 1Toolbar: labeled buttons
- 2Board: select a piece, then its destination
- 3Move list: select a move to jump to it;
Game analysisis at the bottom - 4Move details: notes and variations for the current move
- 5Evaluation graph: how the advantage shifts
- 6Engine and ChessDB: engine analysis and database results
- 7Sidebar: Analyze, Play, Library, Practice, Jieqi; below are Help, Feedback, Appearance, Me and Settings
Analyze a position
- Play out the position you want to analyze.
- Select
Analyze(highlighted when on), orStart analysisin the engine panel. - Wait for the score, recommended line and board arrows.
- 1Start or stop analysis
- 2Blue arrow: recommended move; pink arrow: expected reply
- 3Latest result at the top
- 1Start or stop analysis
- 2Blue arrow: recommended move; pink arrow: expected reply
- 3Latest result at the top
- Recommended line: Red's moves in red, Black's in black.
- Change position: play a move or step with ; the AI analyzes the new position automatically.
- Stop: click again.
Tip
The AI runs on your device, using power and generating heat; turn analysis off when not needed.
Scores
- 1Score:
Red 12means Red has a slight advantage - 2Search: the number after the branch icon is the depth; after the lightning icon, positions per second (731K ≈ 731,000); wider panels also show the time
- 3Recommended line: the continuation from the current position
- Positive favors Red, negative favors Black; near 0 is roughly equal.
- Above +200, Red has a large advantage; below −200, Red is at a large disadvantage.
Red mates in 5: Red can checkmate within 5 moves;Black mates in 5likewise.
After Flip puts Black at the bottom, the score reads Black and positive favors Black.
Tip
Scores change with depth; let the engine search deeper before judging.
Set up a position
- Tap
Edit. - Select a piece in the tray, then tap a square on the board to place it.
- Move: tap the piece, then the new square. Remove: tap the piece, then the tray.
- Under
To move, choose Red or Black. - Tap
Doneat the top right, then to analyze.
- 1
Cancel: discard edits;Done: confirm the position - 2Start position, clear, rotate, mirror, swap colors and image recognition
- Click
Edit. - Select a piece in the tray, then click a square on the board to place it, or drag it there.
- Remove a piece: drag it off the board or right-click it.
- Under
To move, choose Red or Black. - Click
Doneat the top right, then to analyze.
Note
An invalid position (such as a missing king or facing kings) shows a warning; fix it before finishing.
Import a game
Click Import and choose text, a file or an image; see Import.
- Text: supports DhtmlXQ, PGN, Chinese move notation (such as “炮二平五 马8进7”), FEN and links to games on this site.
- Images: the recognized board opens in the position editor; check it, then confirm. Photograph the board straight on. The phone and desktop apps need a free sign-in to recognize images.
Tip
Copy a board screenshot and press Ctrl+V (Mac: ⌘V) on the board page to recognize it. The desktop app's Screenshot recognition (default: Alt+Shift+X) also recognizes boards in other apps.
Tip
From other sites, copy the move text; URLs can't be imported.
Unsaved changes prompt a save before importing. Games with an illegal position (such as facing generals) can't be imported.
Large libraries are imported and saved in batches. A brief switch to the background tries to continue, but the browser or system may pause or end the task, so stay in the foreground until it finishes. Stopping or switching accounts keeps batches already saved; after closing or refreshing the page, or if the system ends the app, continuing is not guaranteed.
Common features
Play against AI
- On a phone, open
Menuand switch toPlayat the top; on a computer, selectPlayin the sidebar. - Choose a
Mode:Play vs AI,With AssistantorLocal two-player. - Set
Style,LevelandPlay as(clock, start position and assists are underOptions), then selectPlay. - After the game, select
Review,Save gameorPlay again.
Play vs AI: 3 hints and 3 takebacks per game.With Assistant: Assistant Fish gives advice as you play; hints and takebacks are unlimited.Local two-player: two people take turns on the same device.
On the analysis board, AI as Red or AI as Black makes the AI move for that side; turn on both and it plays itself. Its strength is set in Settings › AI analysis & moves › AI move settings, separately from the Play page.
Note
Analyze and AI as Red / AI as Black can't run together; turning one on turns the other off.ChessDB
ChessDB (chessdb.cn) provides precomputed moves and scores.
- Engine: calculates the current position on your device.
- ChessDB: looks up stored results online; some positions aren't included.
Tap the panel name left of the move buttons (Engine by default) and choose ChessDB, or swipe the analysis panel.
The ChessDB and engine panels are shown together; no switching needed.
- Each row is a move and its score, best at the top. Select a row to play that move.
- Endgame tablebase results are marked
Red mates in n,Black mates in norDraw. Position not in ChessDB: use engine analysis instead.
Master games: switch the ChessDB panel to Master games (top left) to see how masters fared in this position (Red wins, draws, Black wins), what they played next, and the games themselves, filterable by player, event, year and result; select a game to open it.
Note
ChessDB needs an internet connection but no sign-in.
Local opening books are a separate feature: the web version can only import existing books for lookup; to create or edit books, download the app from the official site.
Analyze a game
- Import or enter the game; see Import a game.
- Select
Reviewat the bottom of the move list (it changes toResultswhen analysis has finished), orMenu›Game analysis. - Choose
Fast,Standard(recommended) orThorough.Thoroughtakes the longest and also finds brilliant and great moves. - Select
Startand wait.
- Import or enter the game; see Import a game.
- Select
Game analysisat the bottom of the move list. - Choose
Fast,Standard(recommended) orThorough.Thoroughtakes the longest and also finds brilliant and great moves. - Select
Startand wait.
When it finishes, Analysis results opens automatically:
- 1Accuracy and problem moves for each side
- 2
Highlights/Problemstabs - 3Select a move to jump to it; select
??to see the suggested move
- 1Accuracy and problem moves for each side
- 2
Highlights/Problemstabs - 3Select a move to jump to it; select
??to see the suggested move - 4Evaluation graph: a sharp drop indicates a mistake
Moves are graded by lost win chance, shown at the top right of the moved piece; the move list marks only brilliant, great, book and problem moves:
!!Brilliant: a hard-to-find good move, often a sacrifice!Great: the only move that holds- 📖 Book: an opening move ECCO recognizes; mistakes and blunders are still marked. Standard openings only; rare openings excluded
- ★ Best: the engine's top choice
- 👍 Excellent: under 2% loss
- ✓ Good: 2%–5% loss
?!Inaccuracy: 5%–10% loss?Mistake: 10%–20% loss??Blunder: over 20% loss×Missed opportunity: failed to punish an error, or let a mate slipM+: still mates, but a faster mate existed; not an error
Select the question mark in the results to see this list.
Evaluation graph
The horizontal axis is turns. Higher favors Red, lower favors Black; rotating the board reverses this. Select a point to jump to that move.
Stepping through moves with analysis on also records scores on the graph.
Note
Playing a move or leaving the page stops game analysis; finished results are kept.
Variations and notes
Add a variation: go back and play a different move. The original line is kept, and a badge such as 1 var appears.
Move panel: tap the highlighted move again, tap the panel name left of the move buttons and choose Moves, or swipe the analysis panel.
- 1Notes: edit, then tap
Done; saved automatically - 2Variations: tap to switch; row numbers match the board arrows
Move details: select a move; its notes and variations appear under Move.
- 1Notes: saved automatically after editing
- 2Variations: click to switch
- 3Arrows: draw the variations on the board; press Esc to hide them
Reordering, deleting and browsing moves: see Move panel and navigation.
Save games
Click Save / share, choose the first option and enter a title.
- After the first save, changes are saved automatically. Orange dot: unsaved; green check: saved; red exclamation mark: saving failed.
- Web: sign in to save to your account and open games on other devices.
- Phone and desktop apps: save locally without signing in; signed in, choose local or cloud. If a cloud save fails (no connection or cloud full), the game is saved locally in “Uncategorized” with a notice.
Saving locally puts the game in the app’s library. For a separate file, use Save / share › Share / export… › Export…; the desktop app also offers Save / share › Save as file….
The apps don't support WeChat sign-in yet. To use one account across devices, register with a phone number or email; if you already use WeChat, first sign in on the web version and link a phone number or email. Linking WeChat is also done in the web account settings.
Find saved games in Library and recent games.
Tip
In a game opened from a collection, ‹ › above the board switches games.
Note
Local games are stored only on this device and are deleted when you uninstall the app, so export a backup first. On Android, turn on Settings › Storage › Keep after uninstalling to restore them after reinstalling; the desktop app keeps local games in the folder chosen in Settings › Storage.
Mistake books
- Open the move panel and select
Save to mistakes; the AI analyzes the position thoroughly, then saves it. - On a phone, open
Menu›Mistake books; on a computer, selectPracticein the sidebar and switch toMistakesat the top. Pick a book if you have several, then selectPractice. - Play the best move; the app checks it.
Show answershows the solution.
- The card uses the position before the move; your actual move is labeled
Played. - Correct answers lengthen the review interval; a wrong answer brings the card back after 10 minutes.
Tip
After game analysis, open each problem move in the results and select Save to mistakes.
Note
Mistake books require sign-in.
Puzzles
On a phone, open Menu › Puzzles; on a computer, select Practice in the sidebar (switch between Puzzles and Mistakes at the top):
Solve puzzles: puzzles matched to your rating; set the difficulty next to the button.Daily puzzle: one a day, the same for everyone.Themes: practice by pattern, length or type. Not rated.My puzzle setstab: create an empty set, import game files, or pick a collection from your library (Create or import a puzzle set). Each game is one puzzle; results and progress are tracked per puzzle. To add an answer to a puzzle in your own set, play it on the board and selectSave / share›Save answer to “set name”.
Rating:
- When signed in,
Solve puzzlesandDaily puzzleare rated; signed out, nothing is rated. - Solving on the first try is a win; a wrong move, a hint or showing the answer is a loss.
- Only your first attempt at each puzzle counts. New accounts show
Provisionaluntil the rating settles. ⋯on the rating card resets your rating; history, missed puzzles and streak are kept, and solved puzzles can be rated again.
Share and export
Open Save / share › Share / export… (on a phone, also Menu › Export & share).
- 1Share a link, animated GIF or image
- 2Copy text or export a file
What each option includes: see Share and export options.
Note
Paste a copied link or text into a chat app to send it. The phone app saves or sends exported files through the system share menu.
Troubleshooting
Analysis does not start
On first open, wait for the engine to download. If the web version keeps failing to load, try a newer browser.
Analysis can't start while editing or with an invalid position.
Changing scores
Scores change with search depth; see Scores.
Add to the home screen
On Android, open the site in Chrome or Edge and select Menu › Help › Add to Home Screen. On a computer, open it in Chrome or Edge and select Help › Install on computer in the sidebar. The item only appears when the browser supports installing. On iPhone, open it in Safari and select Share › Add to Home Screen.
Settings sync
When signed in, settings such as language, skins and AI strength sync to your other devices on the same account; device-specific ones such as threads, text size and layout don't. The switch is Settings sync in Settings (phone: at the end of the group with Display & language and Sound & animation; computer: top of the left column of the settings page).
Other devices update when they start or sign in; a device left open updates when reopened, or when you return after a few hours. The two replace buttons overwrite everything at once and are rarely needed.
Report a problem
On a phone, open Feedback at the bottom of Menu; on a computer, select Feedback in the sidebar. Describe the issue and attach a screenshot; replies appear under My feedback. You can also join QQ group 829220986.
Share your work
Authors and rights holders can leave their contact details in Settings › About › Share your work to share books and game collections for free. After a check they are added to Featured.
Button reference
Toolbar
-
Menu(phone; computers use the sidebar): library, puzzles, mistake books, recently read, plus display mode, import, export & share, help and settings -
New: return to the starting position -
AI as Red,AI as Black: the AI plays that side; see Play against AI -
Analyze: analyze the current position; see Analyze a position -
Move now,Other move: move immediately or choose another move -
Flip: rotate the board; long-press (right-click on a computer) to mirror it -
Import: open a game file, paste moves or recognize a board from an image -
Save / share: save, share or export; an orange dot means unsaved changes -
Edit: set up a position
Tip
Help › Button guide explains each button (in Menu on a phone, in the sidebar on a computer).
Move now and Other move
-
Move now: play the AI's current best move. -
Other move: if the AI has moved, take it back and play another; if it's still thinking, exclude its current candidate. Can be used repeatedly.
Position editor
Clear: remove all pieces except the two kings.Swap: swap the colors of all pieces and change the side to move.
Import
Click Import and choose:
- 1
Photo: photograph a board (desktop:Screenshot) - 2
Image: recognize a photo or screenshot - 3
Game file: PGN, XQF, CBL, CBR, DhtmlXQ, Qingyi, CHM, tree pages and more - 4Text: paste move text, FEN or a link from this site, then select
Import
Folder: import every game in a folder; hidden on devices that don't support it. When importing from the library, the desktop and Android apps also offer Open folder, which browses without importing.
Share and export options
Position link: share the current position only.Game link: signed in, share a read-only game with variations and notes; signed out, only the main line.Animated GIF: the whole game as an animation.Export image: the current position as an image.FEN,FEN + moves,Move text,DhtmlXQ: copy as text.Export…: save a file.XQG: this app's own game file;XQF,CBR,PGN: for other Xiangqi software.Tree: a web page that opens in any browser to step through every variation and note, optionally with scores.Book: a printed-book layout, as a print page (Print / Save as PDF) or a Word document, with options for paper, columns, spacing, diagrams, variations, notes and moves.
Library and recent games
On a phone, open Menu; on a computer, use Library and Practice in the sidebar:
Library: organize your games inCollections;Featuredoffers selected games. The search box at the top searches the current place (on a computer, Ctrl+F or ⌘F on a Mac), andPosition Searchfinds games by position.Puzzles: puzzle practice and your own puzzle sets; see Puzzles.Recently read: cloud games and collections you opened recently; requires sign-in. On a phone it is inMenu; on a computer it is at the top of the library's left tree, where right-click offersRemove from historyandClear history.
In your own collections, in the default order, you can reorder games: drag them on a computer; on a phone, long-press a game and choose Move to top, Move to bottom or Move to position….
On a computer, the library has a tree on the left: drag collections to reorder or nest them; right-click to create a subcollection, move, export the whole collection or delete it; ticking games turns the game-count row into batch actions.
Share several cloud games or collections
Currently only in the library on phones.
- In the cloud collection list or subcollection area, select ☑, pick the items, then choose
Copy collection list. For games within a collection, open the cloud collection, select ☑, tick the games, then chooseCopy share list. - The list follows the displayed order and includes names and HTTPS links by default; you can add the event, players, date and result (empty fields are omitted).
- Unshared items are added only after
Enable sharing and generate. Check the preview, chooseCopy listand paste it into your message; if copying fails, copy the preview text manually.
Anyone with a share link can view it; access isn't per recipient. A collection link also opens its games; subcollections need sharing enabled separately. Local items can't get cloud share links.
Move panel and navigation
Move to top: make the variation the first one. The first is the main line, used for export.Delete from here: remove this move and everything after it.- On a phone, tap or hold ⋮⋮ at the end of a row for actions, and drag it to reorder; on a computer, hover over the row or right-click.
Try: add an unrecorded AI-recommended move as a new variation.
▶: autoplay; long-press (right-click on a computer) to set the interval.
Forward button: after a long-press (right-click on a computer), a tap-proof strip appears at the top of the move list, so a near-miss on the button doesn't jump to a move. To cancel, long-press it or the move list again, or start a new game. See Settings › Interface › Shortcuts.
Tip
Keyboard: ← → step back or forward one move; ↑ ↓ jump to positions with variations; Space plays or pauses.
Board orientation and display
Select Flip to rotate the board; long-press it (right-click on a computer) for:
Rotate board: rotate 180°, put Black at the bottom and switch the score toBlack.Mirror board: mirror left and right without changing the game.
On a phone, Menu › Display mode:
Analyze: the default; shows the analysis panels and move list.Floating window: only the board and a one-line score; select⋯at the bottom right to exit.
Computers use the sidebar by default and have no such item. To use the floating window, set Settings › Display & language › Navigation to Menu, then open Menu › Display mode at the left end of the toolbar.
Settings (at the bottom of Menu on a phone, at the bottom of the sidebar on a computer):
Board & pieces: skins, coordinatesAI analysis & moves: engine, results, rules, AI movesArrows, marks & hints: board hintsInterface: toolbar, move list, panels and shortcutsDisplay & language: navigation, text size, appearance, language, layoutSound & animation: sounds, animation- Also
PrivacyandAbout; the apps addStorage
Settings › AI analysis & moves › Rules controls how analysis and engine moves handle perpetual check and chase; Allow all repetitions permits these repetitions. It doesn't change adjudication on the Play page. In the desktop app, available rules depend on the external engine you use.
On a computer, use Settings › Display & language › Layout preset to place the board on the left or in the center; Navigation can be Automatic, Sidebar or Menu (Automatic uses the sidebar when the window is wide enough).













