Libre Alt-Tab

GPLv3 fork of AltTab-macOS with all Pro/paywall features unlocked.

---

Building Locally

1. Clone the repository:

   git clone https://github.com/salernoelia/lib-alt-tab.git
   cd lib-alt-tab

2. Build the project using Xcode or command-line tools:

   xcodebuild -scheme Release

   Note: Code signing is pre-configured to use ad-hoc signing (-) locally, which means you do not need developer certificates to compile and run.

---

Upstream Synchronization

To integrate updates from the upstream repository without losing your custom modifications:

1. Add Upstream Remote:

   git remote add upstream https://github.com/lwouis/alt-tab-macos.git

2. Fetch and Merge Upstream Changes:

   git fetch upstream
   git merge upstream/master

3. Resolving Conflicts:
   • If there are conflicts in LicenseManager.swift or base.xcconfig, resolve them in favor of the Libre Alt-Tab version to preserve the paywall bypass.
   • If you replaced your app icons and upstream updates them, restore your custom icons using:

     git checkout --ours resources/icons/app/app.icns

---

License

This project is licensed under the GNU General Public License v3.0 (GPLv3). In accordance with the terms of GPLv3:

• You are free to run, copy, distribute, study, change and improve this software.
• If you distribute modified versions of the software, you must make the source code available under the same GPLv3 license.
• All original copyrights and attributions have been preserved in accordance with the license.