Getting Started
🖥 Interface Overview 📁 Working with Folders 🖼 Viewing Photos
Tags
🏷 Adding Tags 🎨 Tag Colors 🔍 Searching by Tags
Integrations
☁ Google Drive
Reference
⌨ Keyboard Shortcuts ← Back to website
Getting Started

Interface Overview

PhotoCatalog has two main zones: the left sidebar for folder navigation and tag management, and the main area on the right for browsing photos.

PhotoCatalog
📁 Open
🗑
▶ 📁 Photos
▼ 📁 Vacation 2024
📁 Italy
📁 France
▶ 📁 Family
▶ 📁 Work
🏷 Tags
family× 4 photos
travel× 12 photos
☁ Google DriveConnect
Photos\Vacation 2024\Italy10 photos
family
IMG_0142.jpg
IMG_0143.jpg
IMG_0144.jpg
IMG_0145.jpg
IMG_0146.jpg
IMG_0147.jpg
IMG_0148.jpg
IMG_0149.jpg
travel
IMG_0150.jpg
IMG_0151.jpg
Folder: Photos\Vacation 2024\Italy | Folders: 0 | Photos: 10 | Selected: 0
📁 Folder tree sidebar
🖼 Photo grid with thumbnails
🏷 Tag panel
Google Drive
📊 Status bar
Navigation

Working with Folders

The sidebar displays your computer's folder tree. You can resize the panel width by dragging the splitter between the sidebar and the photo grid.

1
Open a root folder
Click the 📁 Open Folder button at the top of the sidebar, or choose File → Open Folder from the menu. Select the folder containing your archive — it will appear in the tree.
2
Select a folder to browse
Click any folder in the tree — its photos will load in the main area. The current path is shown at the top.
3
Manage folders
Right-click any folder to open the context menu. You can create a subfolder, rename, or delete. Drag and drop folders to move them — not copy.
4
Rename a folder
Double-click a folder name to rename it inline. Press Enter to save or Escape to cancel.
💡 Tip

Dragging a folder moves it (not copies). To create a nested structure, use the ➕ New Folder button instead.

Browsing

Viewing Photos

Photos load asynchronously — the app stays responsive even with thousands of images. Thumbnails are cached, so reopening a folder is instant.

🖱
Scroll with mouse wheel
Regular mouse wheel scrolling moves the photo grid up and down.
🔍
Zoom thumbnails — Ctrl + scroll
Hold Ctrl and scroll the mouse wheel to smoothly resize thumbnails from small to large. Range: 80 to 400 pixels.
👆
Select photos
Click a photo to select it. Hold Ctrl to select multiple. Hold Shift to select a range. The number of selected photos is shown in the status bar.
Open the original
Double-click a photo to open it in Windows' default viewer. Right-click → Open Folder shows the file in Explorer.
⚡ Performance

Thumbnails are cached between sessions. After the first load, reopening a folder is 10–20× faster. Clear the cache in File → Settings → Cache.

Tag System

Adding Tags

Tags let you categorize photos independently of your folder structure. One tag can be assigned to multiple photos at once.

1
Select photos
Click a photo or select several while holding Ctrl. You can select an entire folder at once.
2
Open the tag dialog
Right-click → Add / Edit Tags. The tag dialog will open.
Context Menu
🏷 Add / Edit Tags
🏷 Show photo tags
↗ Open
📁 Open Folder
📋 Copy Path
ℹ Properties
Tag Dialog
🏷 Add Tags
Selected files: 1
Tags (comma-separated):
Family
Home
3
Enter tags
Type a tag name and press , (comma) or Enter — it becomes a colored chip. Existing tags are highlighted in green. You can also click the popular tags below.
4
Apply
Click ✓ Apply. Tags will immediately appear on photo cards and in the sidebar.
💡 Bulk Tagging

Select multiple photos with Ctrl, then open the tag dialog. Tags will be applied to all selected files at once. Existing shared tags appear as green chips.

Tag System

Tag Colors

Each tag can have its own color. This helps you navigate the photo grid faster — your brain reads color quicker than text.

Tag menu in sidebar
🔍 Find photos with this tag
✏ Rename tag
🎨 Change color
🗑 Delete tag
Color tag examples
family travel nature events work
Color picker
🎨 Tag color
#00aa00
Cancel
OK
1
Open the tag menu
In the sidebar, find the tag in the TAGS section. Right-click → 🎨 Change color.
2
Pick a color
Click the gradient square for precise selection, use the hue slider, choose from 12 quick presets, or type a HEX code directly.
3
Apply
Click OK — the tag color updates everywhere: in the sidebar, on photo cards, and in the tag dialog.
Integrations

Google Drive

Connect Google Drive to browse your cloud photos directly in PhotoCatalog — no downloading required.

1
Click "Connect"
In the sidebar, find the ☁ Google Drive section and click Connect, or choose Google → Sign in with Google from the menu.
2
Sign in to your account
Your browser will open Google's authorization page. Select your account and allow PhotoCatalog read-only access to your files.
3
Browse Drive folders
After signing in, your Google Drive folder tree appears in the sidebar. Click a folder to load thumbnails. Double-click a photo to open it in your browser.
🔒 Security

PhotoCatalog requests read-only access. Your files are never modified or transmitted. The authorization token is stored locally on your computer and refreshes automatically.

Reference

Keyboard Shortcuts

All key actions are accessible from the keyboard.

Open folder
Ctrl+O
Quit
Ctrl+Q
Refresh folder
F5
Rename folder
F2
Zoom in thumbnails
Ctrl+=
Zoom out thumbnails
Ctrl+-
Reset thumbnail size
Ctrl+0
Zoom with scroll
Ctrl+🖱
Select all photos
Ctrl+A
Deselect
Escape
Add tag
T
Settings
Ctrl+,
Delete folder
Delete
Search by tags
Ctrl+F