Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/binghuan/prevent_maximizer

A macOS utility to prevent apps from hijacking the screen into full-screen mode, ensuring uninterrupted multitasking for users.
https://github.com/binghuan/prevent_maximizer

applescript macos

Last synced: about 1 month ago
JSON representation

A macOS utility to prevent apps from hijacking the screen into full-screen mode, ensuring uninterrupted multitasking for users.

Host: GitHub
URL: https://github.com/binghuan/prevent_maximizer
Owner: binghuan
Created: 2023-11-25T16:34:57.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2023-11-26T19:31:45.000Z (about 1 year ago)
Last Synced: 2024-01-26T01:47:29.356Z (12 months ago)
Topics: applescript, macos
Language: AppleScript
Homepage: https://studiobinghuan.blogspot.com/2023/11/prevent-maximizer.html?view=sidebar
Size: 3.55 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        ![](icon.png)  

# Prevent Maximizer

- [Prevent Maximizer](#prevent-maximizer)

  - [Features](#features)

  - [How it Works](#how-it-works)

  - [Usage](#usage)

  - [Converting AppleScript to an Application](#converting-applescript-to-an-application)

  - [Adding an Icon to Your App](#adding-an-icon-to-your-app)

  - [Launching the Application on Startup](#launching-the-application-on-startup)

  - [System Requirements](#system-requirements)

  - [Control flow](#control-flow)

  - [Demo](#demo)

This utility for macOS is designed to address an often-overlooked issue where some applications may unpredictably enter full-screen mode, interrupting the user's workflow, especially when working with split-screen setups. This tool aims to mitigate unintended app behaviors by restoring the app back from full-screen to its original state, maintaining the user's workflow continuity.

## Features

- **Automatic Detection:** Monitors applications entering full-screen mode without user initiation.

- **Non-Disruptive:** Operates in the background, providing a seamless experience without interrupting the user's current tasks.

- **Quick Restore:** Reverts apps back from full-screen to windowed mode, allowing users to continue their work without manual adjustments.

## How it Works

`PreventMaximizer` runs discreetly in the background. When it detects an application has entered full-screen mode without user consent, it automatically triggers a command to exit the full-screen mode, effectively "preventing" the application from "maximizing" and taking over the entire screen.

## Usage

1. Double-click the file "PreventMaximizer.applescript".

2. Modify the application name in the script to the one you want to monitor. 

   ```applescript

   set appName to "Wea"

3. Convert AppleScript to an Application.

4. Move PreventMaximizer.app to your Applications folder.

5. Launch the application.

6. Allow the app to control your computer by granting Accessibility permissions.

![](./README/allow_the_app_to_control_your_computer.png)

## Converting AppleScript to an Application

Follow these steps to convert your script into a standalone application:

![](./README/convert_applescript_to_app.png)

## Adding an Icon to Your App

Personalize your application by adding a custom icon:

![](./README/add_icon_to_your_app.png)

## Launching the Application on Startup

To have PreventMaximizer automatically start when you log in:

![](./README/launch_app_on_startup.png)

## System Requirements

macOS version 10.14 (Mojave) or later.

## Control flow 

![](./README/control_flow.png)

## Demo 

![](./README/demo.gif)