Managing Overlays

This guide covers everything you need to know about creating, organizing, and managing your VR overlays in catnet VR OS.

Overview

Overlays are the core of catnet VR OS. Each overlay is a 2D surface in 3D space that can display:

• Desktop windows
• Web content
• Media players
• System information
• Custom applications

Creating Overlays

Using the Dashboard

1. Open the catnet dashboard (dashboard button on controller)
2. Navigate to Process Manager tab
3. Click ➕ Spawn Process
4. Choose overlay type and configure settings
5. Click Spawn

Overlay Types

Display Capture

Shows your desktop or a specific window

• Use for: Desktop applications, productivity
• Settings: Monitor selection, capture area

Browser

Web browser overlay

• Use for: Web apps, videos, documentation
• Settings: URL, user agent, cookies

Media Player

Optimized for video playback

• Use for: Movies, streams, tutorials
• Settings: File path, streaming URL

Tool/Utility

Specialized overlay types

• Use for: System monitors, notes, controls
• Settings: Varies by tool type

Organizing Overlays

Positioning

Manual Positioning

• Grab: Grip button on overlay
• Move: Move controller while gripping
• Rotate: Twist wrist while gripping
• Resize: Use both controllers

Snap Points

Enable snap-to-grid for precise alignment:

1. Settings → Position Layout
2. Enable "Grid Snap"
3. Set grid size (default: 0.1m)

Anchor Types

• World: Stays in physical space
• HMD: Follows your head movement
• Hand: Attached to controller
• Tracker: Follows tracking puck

Grouping

Create overlay groups for better organization:

1. Select multiple overlays (hold Shift)
2. Right-click → "Create Group"
3. Name your group
4. Groups move/hide together

Layouts

Save and load overlay arrangements:

Saving a Layout

1. Arrange overlays as desired
2. Position Layout tab → Save Layout
3. Enter layout name
4. Optional: Set as default

Loading a Layout

1. Position Layout tab
2. Select saved layout
3. Click "Load"
4. Overlays restore to saved positions

Layout Profiles

Create different layouts for different activities:

• Work: Multiple monitors, documentation
• Entertainment: Media player, chat
• Gaming: Discord, guides, performance

Overlay Properties

Visibility

• Opacity: 0-100% transparency
• Fade Distance: Auto-fade when far away
• Backface: Show/hide reverse side

Interaction

• Input: Enable/disable interaction
• Pass-through: Click through to overlays behind
• Focus Behavior: Auto-focus on hover

Performance

• Resolution: Balance quality vs performance
• Refresh Rate: 30/60/90 FPS
• LOD: Level of detail settings

Advanced Management

Overlay Shortcuts

Create quick-access shortcuts:

1. Right-click overlay in Process Manager
2. Select "Create Shortcut"
3. Assign hotkey or gesture
4. Access from shortcuts menu

Automation

Rules

Set up automatic behaviors:

• Auto-show overlay when app launches
• Hide overlays in specific games
• Position based on controller location

Scripting

Advanced users can script overlay behavior:

TODO: Add scripting examples

Multi-User

Share overlays with others in same space:

1. Enable overlay sharing in settings
2. Set permissions (view/interact)
3. Others see shared overlays

Performance Tips

Overlay Limits

• Recommended: 3-6 active overlays
• Maximum: System dependent
• Monitor performance tab for impact

Optimization

• Lower resolution for distant overlays
• Disable interaction on view-only overlays
• Use static refresh rates when possible
• Close unused overlays

Troubleshooting

Overlay Won't Spawn

• Check available system resources
• Verify overlay type is installed
• Review error in debug tab

Can't Interact

• Ensure input is enabled
• Check if overlay is behind another
• Verify controller tracking

Performance Issues

• Reduce overlay count
• Lower resolution/refresh rate
• Check GPU usage
• Update graphics drivers

Best Practices

Ergonomics

• Position at comfortable viewing distance
• Avoid neck strain from high/low placement
• Use curved overlays for wide content

Organization

• Name overlays descriptively
• Use consistent sizing
• Group related content
• Save layouts frequently

Workflow

• Start with essential overlays only
• Add more as needed
• Remove when done
• Use hotkeys for quick toggle

Keyboard Shortcuts

Action	Shortcut
Toggle All	Ctrl+Alt+H
Next Overlay	Ctrl+Tab
Close Overlay	Ctrl+W
Save Layout	Ctrl+S
Quick Spawn	Ctrl+N

Next Steps

• Positioning Guide - Advanced positioning techniques
• Performance Optimization - Get the best performance
• Overlay Shortcuts - Complete shortcut list