Add screenshots and README.

cormiertyshawn895 · Oct 31, 2019 · 8a8c760 · 8a8c760
1 parent 6af400b
commit 8a8c760
Show file tree

Hide file tree

Showing 13 changed files with 100 additions and 5 deletions.
diff --git a/README.md b/README.md
@@ -0,0 +1,94 @@
+## Retroactive is an app that lets you run Aperture, iPhoto, and iTunes on macOS Catalina. [Click to download the Retroactive app](https://github.com/cormiertyshawn895/Retroactive/releases/download/1.0/Retroactive.1.0.zip), or [view the release page](https://github.com/cormiertyshawn895/Retroactive/releases).
+
+---
+
+### Opening Retroactive
+
+After downloading Retroactive, double click to open it. macOS may prompt you “Retroactive cannot be opened because it is from an unidentified developer.” This is completely normal and expected.
+
+![](screenshots/2.jpg)
+
+To open Retroactive, [right-click](https://support.apple.com/HT207700) on the Retroactive app in Finder, and click “Open” as shown below.
+
+![](screenshots/3.jpg)
+
+If you right-clicked when opening Retroactive for the first time, you need to [right-click](https://support.apple.com/HT207700) for a second time. If Retroactive still can’t be opened, [check your GateKeeper settings](https://support.apple.com/en-us/HT202491) under the General tab in System Preferences > Security & Privacy. Click “Open Anyway” to open Retroactive.
+
+Retroactive will not harm your Mac. This alert only shows up because Retroactive is not notarized. Retroactive is open source, so you can always examine its source code to make sure it’s safe.
+
+---
+
+### Picking an app
+
+Pick the app you want to run on macOS Catalina. If you want to run multiple apps from here, pick any one of them. You will always be able to get back to this screen later.
+
+![](screenshots/4.jpg)
+
+I’ll use Aperture as the example, but the same process also works for iPhoto and iTunes.
+
+---
+
+### Locating the app or choosing a version
+
+Retroactive will automatically scan your Mac to locate an existing Aperture, iPhoto, or iTunes install. If Retroactive has already located the app you would like to run, skip to the next section.
+
+If Retroactive can’t locate an existing install, you’ll be asked to download it from the Purchased list in App Store. You can also find the app on another Mac you own, then AirDrop it to this Mac, or restore the app from a Time Machine backup.
+
+![](screenshots/5.jpg)
+
+If you chose iTunes, Retroactive will ask you which version to install, then automatically download and install it for you.
+
+- iTunes 12.9.5 supports Dark Mode and most DJ apps.
+- iTunes 12.6.5 supports downloading and archiving iOS apps.
+- iTunes 10.7 (not recommended) supports CoverFlow.
+
+If you don’t know which version to install, keep the default setting and click “Continue”.
+
+---
+
+### Authenticating Retroactive
+
+To install or modify the app you chose, you need to authenticate with your login password first. Click “Authenticate”, and enter your login password.
+
+![](screenshots/6.jpg)
+
+Your password is never stored or sent anywhere. To verify this, you can view Retroactive’s source code.
+
+---
+
+### Modifying the app
+
+Retroactive will install or modify the app you chose. Modifying Aperture and iPhoto to run on macOS Catalina should only take about 2 minutes.
+
+![](screenshots/7.jpg)
+
+If you chose to install iTunes, this process takes longer. Depending on the version you chose, it can take between 10 minutes to an hour. It is completely normal for the fans to spin up during the process.
+
+If Retroactive asks for your login password again, enter it again. Otherwise, the iTunes installation may be damaged or incomplete. If iTunes 12.9.5 can’t be installed, try to install iTunes 12.6.5.
+
+![](screenshots/8.jpg)
+
+---
+
+### Using the app
+
+After successfully modifying or installing the app, you can play with it to your heart's content.
+
+![](screenshots/9.jpg)
+
+- All Aperture features should be available except for playing videos, exporting slideshows, printing, Photo Stream, and iCloud Photo Sharing.
+
+- All iPhoto features should be available except for playing videos, exporting slideshows, printing, Photo Stream, and iCloud Photo Sharing.
+
+- All features should work for iTunes 12.9.5.
+
+- All features should work for iTunes 12.6.5 except for backing up an iOS device. Use iTunes 12.9.5 or Finder to back up instead. Thumbnails of download apps may appear distorted.
+
+- iTunes 10.7 may prompt “A required iTunes component is not installed. Please reinstall iTunes (-42401).” There is no need to reinstall iTunes.
+
+---
+
+### Last Words
+- If GateKeeper prevents you from running modified versions of Aperture, iPhoto or iTunes, [temporarily disable GateKeeper in Terminal with `sudo spctl --master-disable`](http://osxdaily.com/2015/05/04/disable-gatekeeper-command-line-mac-osx/).
+
+- To learn more about how Retroactive works, [take a technical deep dive](https://medium.com/@cormiertyshawn895/deep-dive-how-does-retroactive-work-95fe0e5ea49e).
diff --git a/Retroactive/Help/What to do if Retroactive can't be opened.pages b/Retroactive/Help/What to do if Retroactive can't be opened.pages
diff --git a/Retroactive/StepThree/ProgressViewController.swift b/Retroactive/StepThree/ProgressViewController.swift
@@ -253,8 +253,9 @@ class ProgressViewController: NSViewController, URLSessionDelegate, URLSessionDa
         guard let urlString = AppManager.shared.downloadURLOfChosenApp, let chosenURL = URL(string: urlString) else { return }
         if let freeSpace = self.getGBFreeSpace() {
             print("free space: \(String(describing: freeSpace))")
-            if ((freeSpace < 20.0 && AppManager.shared.choseniTunesVersion == .darkMode) || freeSpace < 2.0) {
-                AppDelegate.showOptionSheet(title: "There isn't enough free space to install iTunes", text: "Your startup disk only has \(Int(freeSpace)) GB available. To install iTunes, your startup disk needs to at least have 20 GB of available space.\n\nFree up some space and try again.", firstButtonText: "Check Again", secondButtonText: "Cancel", thirdButtonText: "") { (response) in
+            let freeSpaceRequirement = AppManager.shared.choseniTunesVersion == .darkMode ? 20.0 : 2.0
+            if (freeSpace < freeSpaceRequirement) {
+                AppDelegate.showOptionSheet(title: "There isn't enough free space to install iTunes", text: "Your startup disk only has \(Int(freeSpace)) GB available. To install iTunes, your startup disk needs to at least have \(Int(freeSpaceRequirement)) GB of available space.\n\nFree up some space and try again.", firstButtonText: "Check Again", secondButtonText: "Cancel", thirdButtonText: "") { (response) in
                     if (response == .alertFirstButtonReturn) {
                         self.kickoffiTunesDownload()
                     } else {

diff --git a/Retroactive/Support/Base.lproj/Main.storyboard b/Retroactive/Support/Base.lproj/Main.storyboard
@@ -837,7 +837,7 @@ I’ll modify it to work on macOS Catalina.</string>
                                 </connections>
                             </button>
                             <textField horizontalHuggingPriority="251" verticalHuggingPriority="750" fixedFrame="YES" translatesAutoresizingMaskIntoConstraints="NO" id="boF-ID-sBM">
-                                <rect key="frame" x="150" y="118" width="90" height="24"/>
+                                <rect key="frame" x="154" y="112" width="90" height="24"/>
                                 <autoresizingMask key="autoresizingMask"/>
                                 <textFieldCell key="cell" lineBreakMode="clipping" alignment="center" title="Aperture" id="5wq-le-A3N">
                                     <font key="font" metaFont="system" size="21"/>
@@ -846,7 +846,7 @@ I’ll modify it to work on macOS Catalina.</string>
                                 </textFieldCell>
                             </textField>
                             <textField horizontalHuggingPriority="251" verticalHuggingPriority="750" fixedFrame="YES" translatesAutoresizingMaskIntoConstraints="NO" id="bmv-bW-JTb">
-                                <rect key="frame" x="468" y="112" width="72" height="24"/>
+                                <rect key="frame" x="477" y="112" width="72" height="24"/>
                                 <autoresizingMask key="autoresizingMask"/>
                                 <textFieldCell key="cell" lineBreakMode="clipping" alignment="center" title="iPhoto" id="UsG-Bx-gH6">
                                     <font key="font" metaFont="system" size="21"/>
@@ -855,7 +855,7 @@ I’ll modify it to work on macOS Catalina.</string>
                                 </textFieldCell>
                             </textField>
                             <textField horizontalHuggingPriority="251" verticalHuggingPriority="750" fixedFrame="YES" translatesAutoresizingMaskIntoConstraints="NO" id="RYp-Oi-nLs">
-                                <rect key="frame" x="781" y="112" width="68" height="24"/>
+                                <rect key="frame" x="782" y="112" width="68" height="24"/>
                                 <autoresizingMask key="autoresizingMask"/>
                                 <textFieldCell key="cell" lineBreakMode="clipping" alignment="center" title="iTunes" id="iPE-Jd-BL4">
                                     <font key="font" metaFont="system" size="21"/>

diff --git a/screenshots/1.jpg b/screenshots/1.jpg
diff --git a/screenshots/2.jpg b/screenshots/2.jpg
diff --git a/screenshots/3.jpg b/screenshots/3.jpg
diff --git a/screenshots/4.jpg b/screenshots/4.jpg
diff --git a/screenshots/5.jpg b/screenshots/5.jpg
diff --git a/screenshots/6.jpg b/screenshots/6.jpg
diff --git a/screenshots/7.jpg b/screenshots/7.jpg
diff --git a/screenshots/8.jpg b/screenshots/8.jpg
diff --git a/screenshots/9.jpg b/screenshots/9.jpg