https://github.com/ejbills/DockDoor

Window peeking for macOS
https://github.com/ejbills/DockDoor

Last synced: 3 days ago
JSON representation

Window peeking for macOS

• Host: GitHub
• URL: https://github.com/ejbills/DockDoor
• Owner: ejbills
• License: mit
• Created: 2024-06-03T17:18:17.000Z (29 days ago)
• Default Branch: main
• Last Pushed: 2024-06-27T17:42:31.000Z (5 days ago)
• Last Synced: 2024-06-27T18:21:46.625Z (5 days ago)
• Language: Swift
• Size: 4.95 MB
• Stars: 231
• Watchers: 5
• Forks: 5
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars-eryajf - ejbills/DockDoor - Window peeking for macOS (Swift)

README

        
# DockDoor

Want to support development? [Buy me a coffee here, thank you!](https://www.buymeacoffee.com/keplercafe)

DockDoor is a macOS application developed with Swift and SwiftUI that allows users to manage and interact with application windows on their desktop. It emphasizes ease of use and seamless integration with the macOS environment. This project is open-source, inviting contributions from developers to enhance its functionality and user experience.

[Download the latest release here](https://github.com/ejbills/DockDoor/releases).

## Usage

- **How do I use the alt-tab functionality?**

  - Ctrl + Tab to open the menu, continue pressing tab to increment forwards, shift + tab to go back. Letting go of control will select the window.

- **How do I use the dock peeking functionality?**

  - Simply hover over any application with active windows in the dock.

## Installation (for contributors)

### Prerequisites

- macOS 14.0 or later.

- Xcode installed on your machine.

### Setting Up the Project

1. Fork the repository.

2. Clone your forked repository to your local machine.

3. Open the project in Xcode.

4. Build and run the project.

## How to Contribute

Contributions to DockDoor are welcome! Here’s how you can get started:

### Prerequisites

- Basic knowledge of Swift and SwiftUI.

### Contribution Guide

1. **Branching:**

    - Base all new features off of `main`.

    - Create a new branch for each feature or bug fix: `git checkout -b feature/your-feature-name`.

2. **Coding Standards:**

    - Follow Swift coding conventions and style guidelines.

    - Aim for clear, concise, and expressive code.

3. **Documentation:**

    - Document your code using comments to explain complex logic or functionality.

4. **Testing:**

    - Write unit tests for new features or changes.

    - Ensure existing tests pass before submitting a pull request.