VSA-Mainapp-Release

Favorites Feature Guide

The Favorites feature allows you to mark important screenshots and manage them in a dedicated view. You can also automatically back up your favorite photos to Google Drive.

Overview

With Favorites, you can:

Adding Favorites

Mark photos as favorite directly from the gallery thumbnail display.

Steps:

  1. View the gallery grid
  2. Locate the star icon (★) on the thumbnail’s top-right corner
  3. Click the star icon
  4. Star fills in, indicating photo is now a favorite

Method 2: Photo Detail Sidebar

Mark favorites from the detailed photo information panel.

Steps:

  1. Click a photo in the gallery
  2. Photo detail sidebar opens on the right
  3. Click the star (★) button at the top of the sidebar
  4. Star fills in to confirm favorite status

Method 3: Table View

Mark favorites from the list/table display.

Steps:

  1. Switch to Table view
  2. Locate the star (★) column
  3. Click the star cell for desired photo
  4. Favorite status updates immediately

Sync Note: Favorite status syncs between Grid and Table views. Mark as favorite in either view and it appears in both.

Favorites View

Accessing Favorites

Steps:

  1. Click “Favorites” in the sidebar
  2. Dedicated Favorites view opens
  3. All marked favorite photos display

Display Format

Grid Display:

Displayed Information:

Sorting Options

Arrange your favorite photos in different orders:

Sort by Addition Date:

Sort by Capture Date:

Sort by File Size:

How to Sort:

  1. Open Favorites view
  2. Click sort dropdown menu
  3. Select desired sort order
  4. List updates immediately

Selection and Bulk Operations

Select multiple photos for batch actions.

Selection Methods:

  1. Click photo (single select)
  2. Ctrl+Click for multiple select
  3. Checkbox at photo corner (if available)

Bulk Operations:

Google Drive Integration

Automatically backup your favorite photos to Google Drive.

Login Process (OAuth2 Authentication)

Step 1: Access Account Settings:

  1. Click “Account” in the sidebar
  2. Account management screen opens

Step 2: Click “Login with Google Drive”:

  1. Click the login button
  2. Web browser opens automatically
  3. Google login page displays

Step 3: Select Account:

Step 4: Authorize VSA:

  1. Permission request screen appears
  2. Review requested permissions
  3. Click “Allow” or “Authorize” button
  4. Permissions shown:
    • Google Drive read/write access
    • VSA folder creation and management
    • File upload capability

Step 5: Return to VSA:

  1. Browser automatically returns to VSA
  2. Account screen shows “Logged in”
  3. Email address displayed
  4. Logout button appears

Step 6: Confirmation:

Auto-Upload Configuration

Enable automatic cloud backup when marking photos as favorites.

Enable Auto-Upload:

  1. Open Account settings
  2. Find “Auto-Upload” toggle
  3. Toggle ON
  4. Setting saves automatically

How It Works:

  1. Click favorite star on photo
  2. Upload to Google Drive starts automatically
  3. Takes seconds to minutes depending on file size
  4. Status updates in UI

Upload Destination:

Note: Requires internet connection. Upload pauses if connection drops.

Manual Upload

Upload favorite photos immediately without waiting for auto-upload.

Perform Manual Upload:

  1. Open Account settings
  2. Click “Upload Now” button
  3. Upload process begins
  4. Progress bar shows status

Progress Indicators:

Upload Duration:

Network Requirements:

Checking Upload Progress

Real-time feedback during upload operations.

Displayed Information:

Status Updates:

Error Handling

Upload Failures

Symptom: “Upload failed” error message

Possible Causes:

No Internet Connection:

Google Drive Storage Full:

Authentication Expired:

File Size Issues:

Authentication Errors

Symptom: “Authentication failed” message

Solutions:

Browser Popup Blocked:

  1. Check browser address bar
  2. Look for popup block notification
  3. Allow VSA popups
  4. Try login again

Security Software Blocking:

  1. Check firewall settings
  2. Add VSA to firewall exceptions
  3. Disable antivirus temporarily (carefully)
  4. Try login again

Google Account Security:

  1. Visit https://myaccount.google.com
  2. Open Security section
  3. Review “Less secure apps” setting
  4. May need to allow VSA access

Solution Steps:

  1. Clear browser cache (Ctrl + Shift + Delete)
  2. Try different browser (Chrome recommended)
  3. Restart VSA
  4. Attempt login again

Data Management

Favorites Database

Favorite information stored locally in SQLite database.

Database Location:

%APPDATA%\VSA\favorites.db

Characteristics:

Creating Backups

Backup your favorite photos metadata.

Backup Steps:

  1. Close VSA completely
  2. Navigate to: %APPDATA%\VSA\
  3. Copy favorites.db file
  4. Save copy to safe location
    • USB drive
    • Cloud storage
    • External hard drive

Restoring from Backup

Restore favorites from previous backup.

Restore Steps:

  1. Close VSA
  2. Obtain your backup favorites.db file
  3. Copy it to %APPDATA%\VSA\
  4. Overwrite current file (confirm replacement)
  5. Restart VSA
  6. Favorites restored

Troubleshooting

Favorites Not Saving

Symptom: Marked photos revert to non-favorite after restart

Possible Causes:

Disk Space Issues:

File Permission Problems:

  1. Right-click %APPDATA%\VSA\ folder
  2. Open Properties
  3. Check Security tab
  4. Verify Write permission enabled
  5. Apply if needed

Database Corruption:

  1. Enable Developer Mode
  2. Open Developer menu
  3. Rebuild database
  4. Restart VSA

Google Drive Upload Fails

Symptom: Upload stops with error midway

Solutions:

Network Connection Lost:

Google Drive Full:

  1. Open Google Drive in browser
  2. Check storage usage
  3. Delete old files
  4. Upgrade storage if needed
  5. Retry upload

File Too Large:

Retry Steps:

  1. Check network/storage
  2. Click “Upload Now” again
  3. Previously uploaded files skip
  4. Resume from where stopped

Authentication Lost

Symptom: “Re-login required” message appears

Causes:

Solution:

  1. Click “Re-login” button
  2. Complete Google authentication again
  3. Resume uploads

Privacy and Security

Data Protection

Authentication Tokens:

Photo Data:

Permissions

VSA Requests:

VSA Does NOT Request:

Tips