GalShelf documentation

Getting started

• Getting startedInstall the Windows desktop app, find your data folder, import your first works and keep GalShelf up to date.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable
• Library and importAdd games from folders, Steam, drag and drop, the Explorer menu or watched folders, and understand how matching works.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable
• The website shelfUse your shelf at galshelf.com without the desktop app: add works, record status and scores, check the release calendar and character birthdays, and link Steam.
  • Desktop appNot applicable
  • WebsiteAvailable

Your library

• Status and dango ratingStatuses, completion flags, scores and the dango faces, story progress and how play time is recorded.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable
• Grouping and group statesGroup your shelf by company, brand family, collection or Steam series, and control how much of each group is shown.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot applicable
• Interface profiles and personalisationThemes, the A and B interface profiles, image, GIF and video backgrounds, OP and trailer media, and motion settings.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable

Identification and file safety

• Game fingerprintsHow GalShelf recognises releases and editions from their files, what is hashed, what stays on your computer and what the two separate consents mean.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable
• File integrity warningsWhat a "modified" warning means, how to handle patches and updates, how the Microsoft Defender scan works and what the launch check does.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot applicable

Accounts, sync and cloud

• AccountsGalShelf accounts, NextMoe sign-in, the desktop sign-in, galshelf.com, the earlier account copy, and email verification and password reset.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable
• Sync and conflictsHow library sync keeps the website and your computers in step, what syncs and what stays local, how conflicts, removals and offline changes are handled, and how galbd sync differs.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable
• Cloud storage (Google Drive, OneDrive, sync folder)Connect Google Drive, OneDrive or a sync folder for game cloud saves, the exact permissions GalShelf asks for, status and errors, encryption, and why a provider can show "Not configured".
  • Desktop appAvailable in 0.2.8
  • WebsiteNot applicable
• Game saves and cloud savesEnable automatic save management once, preserve explicit choices, review real conflicts, and keep private status separate from save files.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot applicable

Discover and resources

• Release calendarWhich releases the calendar lists (Japanese originals with Japanese text), where dates come from, how VNDB and NextMoe are cross-checked, partial dates, the month cache, character birthdays, subscriptions, the gold mark and the website calendar.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable
• Resources and downloadsResource links for a work, the resource list for NextMoe moyu, KUN Galgame and TouchGal, ad removal and its limits, concise notes, external fallback and the aria2 downloader.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot available yet
• Similar worksHow the similar-works list is chosen, the reasons shown for each suggestion, feedback and what stays private.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot available yet

Companions and creation

• CompanionsThe chat companions in the lower-left corner, their names, what they can and can't do, portrait and size, model providers and permissions, and how to hide them.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot available yet
• Share cards and editorsMake share cards from templates with editable layers in Create → Share cards, and edit screenshots with crop, mosaic, erase / cut out, upscaling and dialogue recognition.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot applicable

Tools and extensions

• Native toolsThe in-game menu, screenshots, window opacity and always-on-top, Magpie scaling, controller-to-keyboard mapping, Locale Emulator and big-screen mode.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot applicable
• Optional resource packsInstall extra artwork and other large material from a verified pack file only when you want it, and roll back or remove it at any time.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot applicable

Integrations

• SteamLink a Steam account, read your Steam library and playtime, what Steam's privacy settings change, and how Steam games are imported.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable
• galbd / AstrBot pluginConnect GalShelf to the galbd QQ bot (the GalBirthday plugin for AstrBot): prerequisites, supported versions, setup, permissions, verification and troubleshooting, then where to get the files.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable

Companion apps

• Galdrive · Save backup and multi-device synchronisationContinue on another PC with the progress you choose to keep.
  • Desktop appNot applicable
  • WebsiteNot applicable
• Galguard · File security and integrityUnderstand changes to game files and keep recovery possible.
  • Desktop appNot applicable
  • WebsiteNot applicable
• Galdex · Work fingerprints and save-location rulesVerifiable evidence for associating local files with the right work.
  • Desktop appNot applicable
  • WebsiteNot applicable

Help

• SettingsThe nine settings sections, search and deep links, which settings stay on this computer and which follow your account, where the former classic settings moved, language, reset and help.
  • Desktop appAvailable in 0.2.8
  • WebsiteNot applicable
• TroubleshootingFixes for common problems with starting the app, the local service, galbd, Steam, sync, the website language, and how to report an issue.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable
• Privacy and dataWhat stays on your computer, which services GalShelf contacts and when, what the website keeps, cookies, and the consents for fingerprints and cloud features.
  • Desktop appAvailable in 0.2.8
  • WebsiteAvailable

Availability at a glance

Badges are updated with each release. Features marked "Planned" or "In review candidate" are not in a released version yet; "Not available yet" means you can't use it today.