Skip to content

shadowcodex/Overview

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Overview: Window Previews on macOS

Create live window previews for any application, and activate them efficiently with built-in task-switching

Example Screenshot

Beta Release

Note: Overview is beta software. It may contain bugs or unexpected behavior. Use at your own risk.

For development updates, please join our Discord:

Discord Banner

Features

Live Window Previews: Real-time window previews with configurable frame rates and automatic hiding

Quick Application Switching: Switch applications through preview clicks or keyboard shortcuts

Preview Customization: Customize preview window appearance, visibility, and saving/restoration options

Glanceable Info Overlays: Display source app names, window titles, and focus status at a glance

Saved Preview Layouts: Save and restore collections of preconfigured preview windows

System Requirements

  • macOS Ventura (13.0) or later
  • Screen Recording permission (required for window capture)

Installation

  1. Download the latest version from the Overview website williampierce.io/overview/.
  2. Mount the disk image and drag Overview into your Applications folder.

Usage

Quick Start

  1. Launch Overview and grant screen recording permission when prompted
  2. Create a new preview window from the menu bar icon (⌘N)
  3. Select a window to capture from the source windows list
  4. Enable edit mode to move/resize preview windows
  5. Customize behavior through the settings panel (⌘,)

Controls

  • Left-click preview: Switch to source application
  • Right-click preview: Access context menu
    • Toggle Edit Mode for repositioning/resizing
    • Stop capture
    • Close preview window
  • ⌘N Create new preview window
  • ⌘E Toggle edit mode
  • ⌘, Open settings

Settings

See setting menu info panels for full details

  • Previews
    • Frame Rate
    • Automatic Hiding
      • Hide previews for inactive source applications
      • Hide preview for focused source window
  • Windows
    • Appearance
      • Opacity
      • Default dimensions
      • Shadows
      • Synchronize aspect ratio
    • System Visibility
      • Show windows in Mission Control
      • Show windows on all desktops (including fullscreen)
    • Management
      • Always create window on launch
      • Close window with preview source
      • Save window positions on quit
      • Restore window positions on launch
  • Overlays
    • Source Focus
      • Border width
      • Border color
    • Source Title
      • Font size
      • Background opacity
      • Location
      • Type (window, application, or both)
  • Layouts
    • Window Layouts
      • Create layouts to save window arrangements
      • Apply layouts to restore window configurations
      • Update existing layouts
    • Apply layout on launch
    • Close all windows when applying layouts
  • Shortcuts
    • Source Activation
      • Keyboard shortcuts for focusing source windows
      • Multiple source window titles per shortcut for cycling
      • Enable or disable individual shortcuts
  • Sources
    • Source Application Filter
      • Source list filtering
    • Filter mode (blocklist/allowlist)
  • Updates
    • Automatically check for updates
    • Automatically download updates
    • Enable beta updates

Privacy & Security

Overview requires Screen Recording permission to function, but:

  • Only captures window content for preview purposes
  • Does not store or transmit window content
  • All operations remain local to the device

Known Issues

For the complete list of known issues, see github.com/williamcpierce/Overview/issues

Project Funding

Support Overview's development:

100% of donations will be used for project expenses or reinvested in development - no profits will be distributed to any individuals.

See FUNDING.md for full details.

Development

Technical Requirements

  • Xcode 15.0
  • Swift 5.0
  • macOS 13.0+ deployment target

Frameworks and Libraries

  • SwiftUI for user interface
  • ScreenCaptureKit for window capture
  • KeyboardShortcuts for shortcut handling
  • Sparkle for automatic updates

Coding Standards

The project adheres to a style guide (see STYLE.md) that emphasizes:

  • Self-documenting code with clear naming
  • Consistent file organization and documentation
  • Structured logging with appropriate levels
  • Clear separation of concerns and modularity

License

This project is MIT licensed (see LICENSE.md)

Acknowledgments

The design, features, and general purpose of Overview are heavily inspired by Eve-O Preview.

Eve-O Preview was originally developed by StinkRay, and is currently maintained by Dal Shooth and Devilen.

Parts of this application include code derived from Apple Inc.'s ScreenRecorder sample code, used under the MIT License.

About

A free and open source window preview and task switcher tool for macOS

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Swift 100.0%