https://github.com/lfroms/viewfinder

📷 A convenient webcam controller and preview for your menu bar.
https://github.com/lfroms/viewfinder

app camera controller macos menubar swift swiftui uvc webcam xcode

Last synced: 3 months ago
JSON representation

📷 A convenient webcam controller and preview for your menu bar.

• Host: GitHub
• URL: https://github.com/lfroms/viewfinder
• Owner: lfroms
• License: gpl-3.0
• Created: 2022-02-03T22:25:15.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2023-12-02T16:56:32.000Z (12 months ago)
• Last Synced: 2024-06-19T04:03:27.611Z (5 months ago)
• Topics: app, camera, controller, macos, menubar, swift, swiftui, uvc, webcam, xcode
• Language: Swift
• Homepage:
• Size: 2.27 MB
• Stars: 44
• Watchers: 3
• Forks: 2
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• Mac-Menubar-Megalist - Viewfinder

README

        


  

  


  Viewfinder 

  




A simple and convenient way to manage your webcam's picture settings, right from your menu bar.




  

  

  

  

  





  About •

  Download •

  Building from Source •

  Contributing •

  License





  



## About

Viewfinder aims to provide a more native-feeling alternative to, let's face it, the mediocre apps provided by your webcam's manufacturer. Viewfinder lives in your menu bar, and looks and feels just like other system menu bar items, so you'll feel right at home.

Viewfinder is written in [SwiftUI](https://developer.apple.com/xcode/swiftui/), a declarative framework for building user interfaces for macOS.

> 📝 **Note:** Viewfinder is currently _beta software_, so it's possible that you'll run into issues. Many of these issues should begin to disappear once the codebase matures.

## Download

You can download a pre-built **Apple notarized** universal binary of the latest version of Viewfinder from the latest GitHub release. Viewfinder supports macOS 12.0 and later. Click the button below to jump to it, then download the `.dmg` file:

[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/lfroms/viewfinder?color=black&label=download%20latest&logo=github&sort=semver&style=for-the-badge)](https://github.com/lfroms/viewfinder/releases/latest)

A full list of releases is available [here](https://github.com/lfroms/viewfinder/releases).

Viewfinder will automatically check for updates and let you know if a new one is available. You'll be prompted to enable automatic update checks when you first launch the app.

## Building from Source

To open and build the project in Xcode on your local machine, you'll need to pull the source code. Find yourself a working directory, and clone this repo to it. I recommend using [GitHub Desktop](https://desktop.github.com).

Alternatively, pull it using the `git` CLI:

```sh

git clone https://github.com/lfroms/viewfinder.git

```

Then, navigate into the cloned repository:

```sh

cd viewfinder

```

You can then open the Xcode project (named `Viewfinder.xcodeproj`) in Xcode.

## Contributing

Viewfinder is open to contributions from the open source community. If you found a bug, feel free to open an issue and pull request if you know the fix! Thought of an improvement? Open a discussion, and once aligned, open a pull request with your changes.

## License

Viewfinder is released under the [GPL-3.0 License](LICENSE). However, source files that have not been forked from third party GPL-3.0 software may be made available under a less restrictive license upon request. License subject to change should the software cease to include GPL-3.0 code.