macOS Platform Guide

Menu	Key Features
Rando	About, Preferences, Services, Hide, Quit
File	Select Folder, Recent Folders, Close Window
Edit	Copy, Paste, Select All (where applicable)
View	Full Screen, Customize Toolbar
Slideshow	Start Slideshow, Slideshow Settings
Tags (Pro)	Manage Tags, Assign Tags, Filter by Tag
Window	Minimize, Zoom, Bring All to Front
Help	Rando Help, Report Issue, Release Notes

Keyboard Shortcuts

macOS-specific shortcuts use Command (⌘) key:

Essential:

⌘O - Open folder
⌘, - Preferences
⌘Q - Quit app
⌘W - Close window
⌘M - Minimize window

Navigation:

⌘R - Random selection
⌘[ - Back (Pro)
⌘] - Forward (Pro)

File Operations:

⌘C - Copy image
⌘⇧C - Copy path
⌘S - Save to Desktop
⌘⇧R - Reveal in Finder

Tagging (Pro):

⌘T - Tag menu
⌘F - Filter by tag
1-9 - Quick tag

See Keyboard Shortcuts for complete reference.

Trackpad Gestures

Native macOS trackpad support:

Slideshow mode:

Pinch to zoom: Two-finger pinch gesture
Pan while zoomed: Two-finger drag
Swipe navigation: Three-finger swipe left/right (if enabled)

Thumbnail grid:

Scroll: Two-finger scroll to navigate
Smart zoom: Double-tap with two fingers

System Integration

Finder Integration

Reveal in Finder:

Right-click any photo in Rando
Select "Reveal in Finder"
Finder window opens with file selected
Works from slideshow or thumbnail view

File Operations:

Copy images to clipboard (⌘C)
Drag images from Rando to Finder
Export to Desktop with conflict resolution
Original files never modified

Quick Look Support

Preview integration:

Right-click image → "Open in Preview"
Opens in macOS Preview app
Full Preview editing tools available
Changes don't affect Rando's view

Spotlight Integration

Rando's files are indexed by Spotlight for system-wide search.

Rando appears in Services menu when compatible content is selected in other apps.

File System

Supported Locations

Local storage:

Internal SSD/HDD
External USB drives (USB 3.0+ recommended)
Thunderbolt/USB-C drives
SD cards and card readers
Network Attached Storage (mounted volumes)

Mounted volumes:

SMB/AFP network shares
NFS mounts
iCloud Drive (local files)
External cloud mounts (rclone, etc.)

File Format Support

Supported image formats:

PNG (.png)
JPEG (.jpg, .jpeg)
GIF (.gif) - Animated GIF playback in slideshow
BMP (.bmp)

Format detection:

Case-insensitive extension matching
Automatic format identification
Corrupted file handling
Invalid format skipping

Hidden Files

Automatic filtering:

Files starting with . are excluded (.DS_Store, etc.)
Hidden folders skipped during scan
System folders ignored
Cache directories excluded

Pro Features and Purchases

StoreKit Integration

Native Mac App Store purchases:

In-App Purchase Flow: Standard iOS/macOS StoreKit
Touch ID/Face ID: Biometric authentication for purchases
Family Sharing: Share Pro subscription with family (up to 6 people)
Purchase Restoration: Automatic on new devices signed in to same Apple ID

Subscription Management

Manage through macOS:

System Preferences → Apple ID → Media & Purchases
View Information → Manage Subscriptions
Find "Rando Pro"
Cancel, Change Plan, or View Billing

Or via App Store app:

Open App Store
Click profile icon (top-right)
Manage Subscriptions
Select Rando Pro

Trial Management

7-day free trial:

Automatically starts on first Pro feature access
Full access during trial period
Can cancel anytime during trial with no charge
Reminder notifications before trial ends

Trial status visible in:

Preferences window
Pro feature upgrade area
Subscription management in App Store

Legacy Purchasers

Grandfathered users:

If you purchased the one-time $4.99 Pro unlock before subscriptions:

Lifetime access maintained - No subscription required
All Pro features unlocked - Including new features
Special indicator - "Lifetime Pro" status shown
Family Sharing compatible - If purchased with Family Sharing enabled

Performance Optimization

Storage Performance

Optimize for your Mac:

Storage Type	Scan Performance Setting
Apple Silicon SSD	Fast (500)
Intel Mac SSD	Fast (500)
Fusion Drive	Balanced (150)
External SSD	Fast (500)
External HDD	Balanced (150)
USB 2.0 Drive	Responsive (50)
Network NAS	Responsive (50)

Adjust in Preferences → General → Scan Performance

Memory Management

Rando optimizes memory usage:

Thumbnail cache limited by system memory
Automatic cleanup during memory pressure
Lazy loading of images
Efficient SwiftUI rendering

Monitor memory usage:

Open Activity Monitor
Find "Rando" in process list
Check Memory column
Typical usage: 50-200MB depending on library size

macOS Optimizations

Native frameworks used:

SwiftUI: Modern declarative UI framework
Combine: Reactive programming for state management
Async/Await: Swift concurrency for responsive UI
Metal: Hardware-accelerated rendering
Core Image: Efficient image processing

Troubleshooting macOS Issues

Permission Problems

"Access Denied" errors:

Solution 1: Re-grant folder access

Select folder again through Rando
macOS will prompt for permission
Click "OK" to grant access

Solution 2: Reset permissions

System Preferences → Security & Privacy → Privacy
Select Files and Folders
Find Rando and adjust permissions

App Store Issues

Purchase not restoring:

Preferences → Subscription → Restore Purchases
Ensure signed in to correct Apple ID
Check internet connection
Restart app and try again

Updates not appearing:

Open App Store
Click profile icon
Scroll to Available Updates
If Rando missing, try: Account → Sign Out → Sign In

Slideshow Not Full Screen

Can't enter full screen:

Check if window is already in full screen mode
Try ⌃⌘F keyboard shortcut
Green window button → "Enter Full Screen"
Restart app if issue persists

Thumbnails Not Loading

Slow or missing thumbnails:

Possible causes:

Large image files (>50MB)
Slow external drive
Memory pressure
Corrupted image files

Solutions:

Wait for thumbnail generation to complete
Adjust scan performance in Preferences
Close other memory-intensive apps
Skip corrupted files (automatic)

macOS Version Compatibility

macOS 12 (Monterey)

Minimum supported version:

All features fully supported on Monterey and later.

macOS 13 (Ventura)

Enhanced features:

Better StoreKit 2 support
Improved SwiftUI performance
Enhanced memory management

macOS 14 (Sonoma)

Latest optimizations:

Widget support preparation
Enhanced privacy controls
Latest SwiftUI features

macOS 15+ (Future)

Rando will continue supporting new macOS releases with optimizations and feature enhancements.

Uninstalling Rando

Complete Removal

To completely remove Rando from your Mac:

Delete app:
- Open Finder → Applications
- Drag "Rando" to Trash
- Empty Trash
Remove preferences (optional):
- Open Finder → Go → Go to Folder...
- Type: ~/Library/Preferences/
- Delete: com.ijoseph.rando.plist
Remove cache (optional):
- Go to Folder: ~/Library/Caches/
- Delete: com.ijoseph.rando/ folder
Remove app support (optional):
- Go to Folder: ~/Library/Application Support/
- Delete: Rando/ folder if exists