Skip to content

Conversation

shawntz
Copy link

@shawntz shawntz commented Sep 2, 2025

This PR adds seamless Apple Studio Display webcam support to Omarchy with a simple Thunderbolt-only setup - no special cables required @dhh πŸ‘€ 🀞!

βœ… Key Features

  • πŸ”Œ Thunderbolt-Only Setup: Works with ONLY the Apple Studio Display's included Thunderbolt cable
  • πŸŽ₯ 1080p Webcam Activation: Configures the 12MP Ultra Wide camera at optimal 1080p 30fps MJPEG quality
  • πŸ”Š Smart Audio Switching: Automatically switches audio between Studio Display and laptop when docking/undocking
  • βš™οΈ Omarchy Menu Integration: Added to Setup > Video menu for easy access and one-click setup + enablement
  • βœ… Tested Hardware: Framework Laptop 13 with AMD 7040 Series

πŸ›  Changes Made

  1. New Script: bin/omarchy-setup-apple-studio-display-webcam

    • Installs bolt package for Thunderbolt management
    • Configures webcam with optimal v4l2 settings
    • Handles audio device switching automatically
  2. Menu Integration: Updated bin/omarchy-menu

    • Added "Video" option to the Omarchy Setup menu
    • Created show_setup_video_menu() function
    • Clean navigation: Setup > Video > 🍎 Studio Webcam

🎯 Why This Matters

This integration provides a one-click solution that works straight out of the box with just the Thunderbolt cable that comes with the display.

πŸ§ͺ Testing

  • Navigation works seamlessly through Omarchy menu system
  • Script handles missing dependencies gracefully
  • Audio switching works for both docked and undocked states
  • Webcam settings persist and work with all video apps (Zoom, Teams, Meet, etc.)

🌟 Omarchy menu navigation path: Main Menu β†’ Setup β†’ Video β†’ 🍎 Studio Webcam

πŸ“’ Acknowledgements

Shout out to @mikeytag for the invaluable code supplied on the Framework Community Forum, here: https://community.frame.work/t/apple-studio-display-any-experiences/34702

…pport

Adds `omarchy-setup-apple-studio-display-webcam` script that configures
Apple Studio Display webcam for optimal 1080p video quality using only
the included Thunderbolt cable. No special DisplayPort + USB-A adapters
required.

Key features:
  - Activates 12MP Ultra Wide camera at 1080p 30fps MJPEG
  - Auto-configures exposure, white balance, and positioning
  - Switches audio between Studio Display and laptop automatically
  - Integrates with Omarchy's Setup > Video menu for easy access
  - Tested on Framework Laptop 13 with AMD 7040 Series
@mikeytag
Copy link

mikeytag commented Sep 2, 2025

Love this! I wasn't sure how to include it in Omarchy. Thank you @shawntz!

@NixBiks
Copy link

NixBiks commented Sep 4, 2025

Great @shawntz ! Does the Framework 13 also get powered by the Thunderbolt cable?

@shawntz
Copy link
Author

shawntz commented Sep 4, 2025

@NixBiks yes indeed! ⚑⚑

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants