MetalGoose

GPU-accelerated upscaling and frame generation for macOS

Features • Installation • Usage • Requirements • Building • License

MetalGoose is a native macOS application that provides real-time upscaling and frame generation for games and applications. Built entirely with Apple's Metal framework, it delivers a smooth, high-FPS experience similar to NVIDIA DLSS or AMD FSR, but designed specifically for macOS.

• Performance Mode — Fastest upscaling with minimal latency
• Balanced Mode — Optimal quality/performance ratio
• Quality Mode — Maximum visual fidelity
• Multiple render scales: Native, 75%, 67%, 50%, 33%
• Contrast-adaptive sharpening (CAS)

• 2x, 3x, 4x frame multipliers
• Adaptive or Fixed frame generation modes
• Motion-compensated interpolation
• Optical flow-based motion estimation
• Quality modes: Performance, Balanced, Quality

• FXAA — Fast approximate anti-aliasing
• SMAA — Enhanced subpixel morphological AA
• MSAA — Multi-sample anti-aliasing
• TAA — Temporal anti-aliasing with history

• Real-time HUD overlay
• Capture/Output/Interpolated FPS tracking
• GPU time and frame time metrics
• VRAM usage monitoring
• Frame statistics

1. Download the latest release from Releases
2. Move MetalGoose.app to /Applications
3. Grant Screen Recording and Accessibility permissions when prompted

git clone https://github.com/Stallion77RepoOfficial/MetalGoose
cd MetalGoose
open MetalGoose.xcodeproj

1. Launch MetalGoose
2. Select Target
   • Choose a window or display to capture
3. Configure Settings
   • Enable upscaling (MGUP-1)
   • Enable frame generation (MGFG-1)
   • Select anti-aliasing mode
4. Start Scaling
   • Click "Start" to begin processing

MetalGoose/
├── ContentView.swift      # Main SwiftUI interface
├── DirectRenderer.swift   # Metal rendering pipeline
├── DirectEngineBridge.mm  # Objective-C++ bridge layer
├── Engine.mm              # Core C++ processing engine
├── Shaders.metal          # GPU compute shaders
├── MGHUD.swift           # Performance overlay
└── CaptureSettings.swift  # Settings management

• SwiftUI — Modern declarative UI
• Metal 4 — GPU-accelerated processing
• ScreenCaptureKit — Low-latency screen capture
• MetalPerformanceShaders — Optimized GPU operations

1. Use Balanced mode for the best quality/performance ratio
2. Lower render scale if experiencing lag
3. Enable VSync to reduce tearing
4. Reduce Latency option available for competitive gaming
5. Adaptive frame gen automatically adjusts to game FPS

Contributions are welcome! Please read our Contributing Guidelines before submitting a pull request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

• Apple for the Metal framework and documentation
• The macOS gaming community for feedback and testing
• Contributors who helped improve the project

RESOURCES THAT USED FOR THIS PROJECT

https://developer.apple.com/documentation/metal https://developer.apple.com/documentation/metalfx/ https://developer.apple.com/documentation/coreimage https://developer.apple.com/documentation/screencapturekit/ https://developer.apple.com/documentation/appkit https://developer.apple.com/documentation/metal/mtltexture https://developer.apple.com/documentation/corevideo/cvpixelbuffer https://developer.apple.com/documentation/metalperformanceshaders https://developer.apple.com/documentation/metal/compute-passes https://developer.apple.com/documentation/vision https://developer.apple.com/documentation/vision/vngenerateopticalflowrequest https://developer.apple.com/documentation/ScreenCaptureKit/capturing-screen-content-in-macos