Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/professionalgriefer/quickposition
Quickly position an iPad to the left or right of a Mac display
https://github.com/professionalgriefer/quickposition
apple applescript macos productivity shortcuts
Last synced: 14 days ago
JSON representation
Quickly position an iPad to the left or right of a Mac display
- Host: GitHub
- URL: https://github.com/professionalgriefer/quickposition
- Owner: ProfessionalGriefer
- License: mit
- Created: 2024-10-22T16:13:27.000Z (24 days ago)
- Default Branch: main
- Last Pushed: 2024-10-27T14:07:53.000Z (19 days ago)
- Last Synced: 2024-10-27T16:03:58.041Z (19 days ago)
- Topics: apple, applescript, macos, productivity, shortcuts
- Language: Shell
- Homepage:
- Size: 23.4 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/ProfessionalGriefer/quickposition/actions/workflows/main.yml)
# Quick Position
QuickPosition is a command-line tool designed to streamline the process of configuring display positions on macOS. Specifically, it allows users to easily move their iPad (used as a secondary display via Sidecar) to either the left or right side of their Mac screen, without the need to manually adjust display settings through the system preferences.
With QuickPosition, three `.app` files are generated in your `/Applications` folder. These can be executed to quickly switch the iPad display position with just one click in Finder.
## Features
- Automates the process of moving an iPad display to the left or right of your Mac screen.
- Activates the iPad as a second monitor with the **sidecar** app
- Saves display configurations in two separate apps: **iPad Left** and **iPad Right**.
- No need to open display settings manually – simply run the apps to apply your preferred display arrangement.
## Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/quickposition.git
```
2. Navigate to the QuickPosition directory:
```bash
cd quickposition
```
3. Make the `quickposition.sh` script executable:
```bash
chmod +x quickposition.sh
```
4. Run the script to generate the display configuration apps:
```bash
./quickposition.sh
```
## How It Works
- The script first prompts you to confirm whether you'd like to proceed with creating the display positioning apps.
- It opens the display settings for you to configure the iPad on the **left** side.
- After configuration, it saves the display settings into the app **iPad Left**.
- The script then reopens the display settings for you to configure the iPad on the **right** side.
- It saves this configuration into the app **iPad Right**.
- Both apps are copied to the `/Applications` folder for easy access.
## Usage
Once installed, simply open Finder and run the corresponding `.app` file from your `/Applications` folder to reposition your iPad:
- **iPad Left.app**: Positions your iPad display on the left of your Mac.
- **iPad Right.app**: Positions your iPad display on the right of your Mac.
You can also customize these display positions by editing the `quickposition.sh` script and updating the display settings commands as needed.
## Troubleshooting
- It is important that the name of your iPad is the same name as the one you entered into the script. It is case sensitive.
- "Vincent's iPad" is not the same as "Vincent`s iPad": Be careful with special characters
- You should be automatically prompted to grant Accessibility permissions. If not, manually enable it under `System Settings > Privacy and Security > Accessibility`
## Requirements
- macOS with Sidecar enabled.
- [displayplacer](https://github.com/jakehilborn/displayplacer) must be installed via Homebrew:
```bash
brew install displayplacer
```
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Contributing
Feel free to submit a pull request or open an issue if you find any bugs or have suggestions for new features!
## Acknowledgements
- [displayplacer](https://github.com/jakehilborn/displayplacer) for the excellent tool to manage display configurations on macOS.
---
Found my add-on useful? Consider buying me a coffee!
