Changelog | Download | Other Go Projects

SWHub is a local-first Go/Baduk/Weiqi studying and playing app. It combines Tsumego Training modes, Pattern Search, Joseki/Fuseki Explorer, KataGo Analysis, complete Game Review and Drills, Online Play, Progress Tracking and Teaching Rooms in one app.

Free Cloud KataGo

For Play/Analysis

For Contribution

Screenshots/Demo

Feature Highlights

SWHub is organized around four destinations: Puzzles, Tools, Play, and Me. Compact layouts use bottom navigation, while wider windows use a navigation rail.

What can I do in Puzzles?

• Grading Exam: solve ten same-rank problems with 45 seconds per problem, eight correct answers pass the exam.
• Endgame Exam: the same ten-problem format using endgame positions.
• Time Frenzy: solve as many increasingly difficult problems as possible in three minutes, with the run ending after three mistakes.
• Ranked Mode: adaptive untimed solving that raises difficulty as accuracy and speed improve.
• Collections and Topics: work through curated books/sets or train a chosen topic, subtopic, and rank range.
• Custom Exam: combine selected topics, collections, rank ranges, or prior mistakes into a personal exam. Enable Unique tasks only to use each eligible task at most once per exam, including tasks solved in earlier sessions. Exams can request up to 10,000 problems, capped by the available pool in this mode.
• My Mistakes and SRS Review: inspect missed problems and revisit them on a spaced schedule. SRS remains independent when a mistake is cleared or ignored, and problems graduate after a sustained correct streak.
• Statistics and Leaderboards: review recent activity, rank/type breakdowns, personal bests, and global results for supported training modes and periods.
• Find Task: open a task directly from its shared identifier. Management tools remain developer/debug features.

Puzzle solving also supports multiple correct variations, optional solution continuation, color/orientation randomization, always-black-to-play, Auto-Next, Count and Status problem types, Count Hard Mode, and Ghost Mode for visualization training.

What can I do in Tools?

• Local Board: create and edit variations, navigate a visual game tree, annotate SGFs, count liberties and group status, and draw pen marks. Import a board photo, align its corners, correct detected stones, and turn the position into an SGF. A movable local score estimator supports rule-aware totals and whole-group dead/alive correction, plus click-to-cycle Black/White/neutral ownership on empty points. Ownership edits update the estimate without placing stones; the estimator remembers its window position across app restarts.
• Pattern Search: build a private Kombilo database from local 19x19 SGFs, search full-board, corner, or selected-area patterns, filter game metadata, inspect continuations, player profiles, date/win-rate statistics, and exact indexed hits, save search history and snapshots, or try Guess the Next Move. Large imports are checkpointed, invalid SGFs are skipped, and portable .db bundles keep the .ps database together with its required auxiliary files.
• Joseki: download about 20k Joseki positions once, then browse completely offline on a full 19x19 board. Use the Joseki toolbar’s Check for data updates button to download new dictionary versions independently of app updates. The explorer includes Joseki and Fuseki branches, pass and tenuki, official move categories and labels, board marks, descriptions, source/tag filters, and related-position or external links.
• KataGo Analysis: use a bundled/local process, custom command, or remote WebSocket engine on supported platforms. Review top moves, point loss, score/win-rate graphs, ownership, policy, variations, move statistics, notes, and a Performance Report with opening/midgame/endgame filters and optional HumanSL Rank(Avg.) estimates. Auto Setup detects compatible hardware, installs and verifies binaries/models, and tunes the engine. The shared Rank guide offers 20k–9d guidance and unranked teaching practice; named bots retain their distinct playing strategies. Details describes the next recorded move and follows the same rank filter as board suggestions. Mistake navigation stops before the mistake; hover or pin a variation link and use the mouse wheel to step through its preview. Image to SGF is also available here, alongside deeper analysis, alternatives, all-move analysis, and areas of interest.
• Game Focus: import local or supported server-account games, analyze them in a resumable queue, and keep completed reviews offline. Dashboard, Drills, and Weaknesses show a cumulative HumanSL style estimate, phase/region/severity breakdowns, accuracy trends, saved Performance Reports, and game tags such as Comeback or Dragon Slaying. Choose the recorded player rank or a 20k–9d target for new analysis. Export individual drills or selected categories as SGF, drills use an independent schedule up to two weeks.
• KataGo Contribution: contribute through a compatible controller or local KataGo process and watch live games, analysis, logs, and session progress, including rectangular contribution games. Colab and Modal guides cover analysis and contribution; both Colab workflows can cache reusable engine/model files in Google Drive. Finish & stop lets contribution shut down cleanly.

What can I do in Play?

• Career Mode: play ranked games against rank-guided KataGo HumanSL styles, track recent-window promotion/demotion progress and peak rank, save finished SGFs, and review games. Unranked guided practice is now part of the normal KataGo page.
• OGS, KGS, and IGS(Pandanet): sign in and play through native clients inside SWHub. Browse players and live games, send or answer challenges, resume ongoing games where supported, chat, and open game records. Record actions include Review in SWHub, Open in KataGo, and Download SGF. Each server retains its own rules and available controls.
• OGS Reviews: discover, create, and open shared reviews with a visual game tree, comments, setup stones, variations, marks, territory, and pen drawing. Follow the presenter or explore locally.
• Variant Server: play on variant.baduk.club. Combine the server's variants, design rectangular boards with missing intersections, use Circloid and Joseki cards, join multiplayer or Rengo seats, spectate, review, and score games. Your guest identity is saved on this device; browser identities are separate.
• Tsumego Battles: create or join a room code, configure rank/type/time ranges, chat and ready up, then solve the same synchronized problem set.
• Teaching Rooms: when enabled for a build, create password-protected shared boards with teacher/student roles, assigned colors and turns, chat, board annotations, scoring, and controlled voice participation.

What is on the Me page?

• Avatar and player identity, unique solved count, total problem count, and highest solved ranks for recent periods and all time.
• Personal bests, training activity, and a calendar heatmap. Full rank/type training statistics remain under Puzzles > Statistics.
• Your playing profile below the heatmap, with source-filterable rank history and win/loss results fetched directly from configured EGD and supported server identities. Charts cover the rolling past year; some servers provide a shorter result history.
• Actions to edit profile identities, refresh sources, share a stats image, or sync local training stats using a leaderboard username and private sync key.

What appearance and controls can I customize?

• Board and stone themes, including separate custom board, black-stone, and white-stone images under Settings > Appearance.
• Inside, outside, or hidden coordinates across boards, independent fuzzy placement and stone animation toggles, separate custom black/white stone sizes, shadows, hover stones, custom cursors, and move numbers.
• Separate stone, interface, and voice volumes, two randomized stone-sound pools, and English, Chinese, Spanish, Japanese, Korean, or Russian voice prompts.
• Desktop keyboard bindings under Settings > Keyboard shortcuts. Search by action, page, or key, or show only enabled actions. Actions start disabled with suggested keys visible: enable one or click its key field to assign and enable another combination. Changes apply immediately, recording can be cancelled, and conflicts between actions that share a page are blocked.
• Keyboard shortcuts use six groups: Global, Board & game tree, Online play, KataGo, Puzzle solving, and Study tools. Each action shows where it works. Shared navigation, coordinates, and move numbers expose page-specific overrides; Joseki navigation is included under Board. Global includes dialog submit/dismiss, and Puzzle solving includes Try custom moves after solving. All bindings start off. Main-page, Settings-page and numbered Server workspace bindings have been removed.
• Mouse gestures are always available independently of keyboard bindings. See Settings > FAQ > Visuals & Controls for the mouse reference, including Alt+left-click stone history, wheel navigation, previews, editing, scoring, and panel resizing.

F.A.Q.

Frequently Asked Questions

Where are keyboard shortcuts and mouse gestures documented?

Settings > Keyboard shortcuts lists keyboard-only app commands, their current bindings, and enable/rebind/reset controls. Bindings start disabled, including Fox room and KataGo dialog commands; ordinary platform text editing and focus navigation remain available. The App-wide coordinate command cycles inside → outside → hidden and persists the choice.

Mouse gestures stay enabled regardless of keyboard settings:

• Alt + left-click a stone: jump to its placement in the displayed branch/history. Initial setup stones select their setup position; captured and replayed stones select the current placement. Release over the same stone. Empty intersections do nothing, and no move is played. Available history, live-game permissions, scoring, and preview restrictions still apply.
• Wheel over a board or move controls: step through history. Shared navigation supports Shift + wheel for ten moves and Ctrl + wheel for start/end. KataGo previews and Contribution viewing step one position at a time.
• Hover a KataGo candidate/variation link: preview its line; click a Details link to pin it, scroll to step through it, and middle-click the board to commit an editable preview as a variation.
• Right-click: open available tree-node or puzzle-preview menus; remove Local Board/teacher annotations; place White in Pattern Search manual black/white mode; or toggle Variant no-score points during scoring.
• Drag: use selection/pen tools, resize supported panels, or move estimator windows. Click stones in an estimate to mark groups dead/alive and empty points to cycle ownership. KataGo sliders also accept wheel input.

The in-app FAQ contains the complete mouse reference and mode-specific details. Keyboard-only key lists live in the shortcut editor so they reflect your saved bindings.

Where should I start?

Start with Puzzles if you want structured reading practice, Tools if you have a game or position to study, Play for live games and shared sessions, and Me when you want to see progress, or sync data. The in-app Settings > FAQ contains longer operational notes and troubleshooting.

Which features work offline?

Downloaded puzzles, Local Board, downloaded Joseki data, existing Pattern Search databases, local statistics, saved SGFs, and saved Game Focus reviews work offline. Local KataGo also works offline after its executable and models are installed. Public-profile/archive imports, remote KataGo, leaderboards/sync, OGS, KGS, Pandanet, Fox, Variant Server, Tsumego Battles, and Teaching Rooms require a network connection. Board-photo detection runs locally. Puzzles and Joseki require an initial internet download when you first open those features, installed data then works offline. Tsumego-data updates activate after closing and reopening SWHub.

What is the difference between My Mistakes, SRS, and Game Focus Drills?

My Mistakes records failed attempts. SRS Review schedules those for long-term repetition. Game Focus Drills are generated from point losses in your own analyzed games, retain the full board and KataGo answers, and use a separate short schedule that tops out at two weeks.

How do I move a Pattern Search database?

Use Pattern Management's exported .db bundle. A raw .ps file is only one part of the database; its .pa, .ps1, .ps2, and other required siblings must stay together. Large bundle imports are streamed and installed through a staged rollback-safe process.

Where is my data, and what should I back up?

On desktop, app-managed data is under Documents/SWHub. Important items are swhub_stats.db, game_focus_v2.db, the PS directory, saved SGFs, and KataGo files. Close SWHub before copying live databases. Use exported Pattern Search bundles for portable backups and keep your leaderboard sync key somewhere safe; it cannot be recovered if lost.

Catalog updates preserve progress for surviving task IDs when their metadata changes and remove deleted tasks from saved references. Daily activity and exam history remain intact. An unfinished collection restarts if its task order or membership changed. If both devices change an unfinished collection, sync keeps the local resume session rather than adding their task positions; completed best results keep the higher success rate, then the shorter time.

Do I need a new account or sync key for the stats upgrade?

No. Version 0.2.8 uses compressed v2 stats sync with your existing username and sync key. Existing cloud statistics, including inactive accounts, have been migrated. Legacy-only apps must upgrade. Version 0.2.7 can still sync accounts using unversioned task data, but once any device upgrades the account to a dated task catalog, all other devices must update their app and task data before syncing again. Their offline progress remains local until they upgrade. SRS restore preserves newer local review progress when the cloud schedule has not changed; if both devices changed a schedule, the earlier review takes priority. Training statistics remain separate from Game Focus storage.

Where did my older Game Focus games go?

Version 0.2.8 starts storing these under a folder as I've added a feature to support multiple game focus profiles.

How do I connect my playing profile?

Edit identities on Me and enter your EGD PIN or supported server usernames. OGS, KGS, and Pandanet can use credentials saved on the device through Profile identities or Play; KGS/Pandanet archive access needs those credentials. A failed source can retain matching cached results. KGS exposes only the latest six months of game results, so its past-year chart may be incomplete.

Does SWHub upload my games?

Local KataGo analyzes on your machine; a remote engine receives the positions you send to it. Saved Game Focus reviews use stored analysis without reconnecting to KataGo. Stats sync sends leaderboard identity, supported attempts, and a statistics snapshot, not your SGF or Pattern Search library. Automatic app-open telemetry has been removed.

Why is a feature missing from my build?

Feature availability varies by platform and build configuration. Local KataGo needs a supported engine environment. Teaching Rooms, FoxWQ and Kata-Coach not available in the public build.

How do auto-updates work?

Production builds check for stable GitHub releases at launch once a week. Checks run after startup, and update prompts can be dismissed. Updates preserve saved data and show the installed version's release notes on the next launch. Android uses system installation confirmation; desktop updates use the platform's installation or replacement flow.

Feedback

• Report bugs through SWHub issues.
• Join my Discord for discussion, or the GUI channel in the Computer Go Community for KataGo and training contribution topics.

License

SWHub is proprietary software, it is not open source. It is distributed under the SWHub Non-Commercial Proprietary License, which prohibits unauthorized commercial use, monetization, modification, builds, and redistribution. Third-party components remain under their respective terms, available here. Official SWHub copies are available only from SoumyaK4 directly or through the official SWHub binary releases, third-party mirrors, stores, repositories, and re-uploads are not authorized. SWHub source code is not included in the public distribution or licensed for use.