Skip to content

Commit 8862f4b

Browse files
committed
add page about scanning for games to install locations section
1 parent ccb961d commit 8862f4b

File tree

2 files changed

+20
-0
lines changed

2 files changed

+20
-0
lines changed

SUMMARY.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
* [Using a proxy](using/proxy.md)
1717
* [Downloading games](using/downloading.md)
1818
* [Install locations](using/install-locations.md)
19+
* [Scanning for games](using/scan-install-locations.md)
1920
* [Collections](using/collections.md)
2021
* [Game developer guide](integrating/README.md)
2122
* [Quick start](integrating/quickstart.md)

using/scan-install-locations.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Scanning for games
2+
3+
The itch app can scan your install locations to find games that are installed on disk but not currently showing up in your library. This is useful if the app's database was reset, you restored game files from a backup, or you're sharing an install folder between machines.
4+
5+
## How it works
6+
7+
The scan looks through every folder in your registered [install locations](install-locations.md) for game folders that contain an `.itch` metadata folder. This metadata is created by the app when it installs a game, and contains information about which game and upload the folder belongs to. When the scan finds a game folder with valid metadata that isn't already in your library, it offers to re-import it.
8+
9+
## When it runs
10+
11+
- **On startup** - the app automatically scans in the background each time it launches. Any games it finds are imported silently.
12+
- **When you add a new install location** - the app scans the new location automatically.
13+
- **Manually** - you can trigger a scan from the install locations preferences. This opens a window that shows you which games were found and asks you to confirm the import.
14+
15+
## What it can't do
16+
17+
The scan can only find games that were **previously installed by the itch app**. It cannot detect games that were downloaded through the itch.io website and placed into an install location manually, because those downloads don't have the `.itch` metadata folder that the app creates during installation.
18+
19+
If you want a game in your app library, you'll need to install it through the app directly.

0 commit comments

Comments
 (0)