Merge pull request #31 from SideStore/wesleybryie/aug-update

macOS and Linux Pairing File Instructions

Author: nythepegasus

TODO.md

@@ -1,4 +1,11 @@
 # Todo List for SideStore-Docs
 
-[] Fix error codes and troubleshooting
-[] Add details in faq about 3 app limit
+[ ] Fix error codes and troubleshooting
+
+[ ] Add details in faq about 3 app limit
+
+[X] macOS Pairing File Instructions
+
+[X] Linux Pairing File Instructions
+
+[ ] SideJITServer Docs (start)

docs/getting-started/pairing-file.mdx

@@ -10,14 +10,44 @@ Download Jitterbugpair for [Windows (64-bit)](https://github.com/osy/Jitterbug/r
 
 ## Pairing Instructions
 
+### Windows
+
 1. Extract the Jitterbugpair zip file.
 2. Plug your device into your computer, and open your device to its home screen. Once done, execute the program.
     * Your device may ask you to trust your computer. Make sure to accept this prompt, as it is required for the pairing process.
 3. Once it is done, you will get a file that ends with `.mobiledevicepairing`.
 4. Transfer this file to your device using iTunes, or any other method.
     * Transferring using cloud storage may change the file's extension (most likely turning into a .txt file), so be careful. It is also possible to change the extension to `.plist` for use with older SideStore versions, like `0.1.1`.
+
 On Windows, you might have to execute the program using Command Prompt or Powershell, as it can sometimes not open by double clicking the `.exe` file.
 
 5. In File Explorer, navigate to the folder where jitterbugpair is located.
 6. In the navigation bar where the folder location is, click an empty spot and type `powershell`. It should open a (possibly blue colored) window called PowerShell.
 7. From there, type `./jitterbugpair.exe` and press enter while your device is plugged in.
+
+
+<!-- Credit: Stossy11 -->
+### macOS
+
+1. Download Jitterbugpair then Double Click it to extract the zip file.
+2. Find the Extracted jitterbugpair file. (it should have a black and green icon)
+3. Open Terminal. (In launchpad its in the "Utilities" folder)
+4. Drag the jitterbugpair file into Terminal and press "Return" or Enter. (Make sure your device is plugged in)
+    * If you get "macOS cannot verify that this app is free from malware" put into terminal `xattr ` (with a space after) then drag jitterbugpair then press enter. after that try doing step number 4 again.
+5. Transfer this file to your device in a way of your choosing.
+    * Transferring using cloud storage may change the file's extension (most likely turning into a .txt file), so be careful. It is also possible to change the extension to `.plist` for use with older SideStore versions, like `0.1.1`.
+
+### Linux
+
+These instructions expect that you are familiar with the linux commandline.
+
+1. Extract the Jitterbug zip file, and open a terminal (if you haven't already) to the extracted directory. 
+2. In that terminal, run `chmod +x ./jitterbugpair`
+3. Plug your device into your computer, and open your device to its home screen. Once done, execute the program in your terminal with `./jitterbugpair`
+    * If you get a prompt saying you need to trust the computer from your iDevice, make sure to do so. You may need to rerun jitterbugpair.
+4. Once it is done, you will get a file that ends with `.mobiledevicepairing` in the directory you ran jitterbugpair from.
+5. Transfer this file to your device in a way of your choosing.
+    * Transferring using cloud storage may change the file's extension (most likely turning into a .txt file), so be careful. It is also possible to change the extension to `.plist` for use with older SideStore versions, like `0.1.1`.
+
+You might have success with just adding execute permissions and running jitterbugpair from a file manager, but it is recommended to just do it from the terminal.
+