From 5000856b809711165e8530444c4ab1cae2cd4a02 Mon Sep 17 00:00:00 2001 From: timbergeron Date: Fri, 20 Sep 2024 14:42:27 -0700 Subject: [PATCH] add macOS run instructions --- MacOSX/QuakeSpasm.xcodeproj/project.pbxproj | 4 + Quake/macos_instructions.html | 97 +++++++++++++++++++++ 2 files changed, 101 insertions(+) create mode 100644 Quake/macos_instructions.html diff --git a/MacOSX/QuakeSpasm.xcodeproj/project.pbxproj b/MacOSX/QuakeSpasm.xcodeproj/project.pbxproj index b396e3e7..06af9b1d 100644 --- a/MacOSX/QuakeSpasm.xcodeproj/project.pbxproj +++ b/MacOSX/QuakeSpasm.xcodeproj/project.pbxproj @@ -112,6 +112,7 @@ 85AC9B2C2A70521E00228EF3 /* pmove.c in Sources */ = {isa = PBXBuildFile; fileRef = 85AC9B2A2A70521E00228EF3 /* pmove.c */; }; 85AC9B2D2A70521E00228EF3 /* pmovetst.c in Sources */ = {isa = PBXBuildFile; fileRef = 85AC9B2B2A70521E00228EF3 /* pmovetst.c */; }; 85C58F442B9D79580010F658 /* json.c in Sources */ = {isa = PBXBuildFile; fileRef = 85C58F432B9D79580010F658 /* json.c */; }; + 85F640312C9E1EE300615B7F /* macos_instructions.html in CopyFiles */ = {isa = PBXBuildFile; fileRef = 85F640302C9E1EE300615B7F /* macos_instructions.html */; }; 932AE8F92944103F0062F917 /* libopus.a in Frameworks */ = {isa = PBXBuildFile; fileRef = 932AE8F3294410200062F917 /* libopus.a */; }; 93B34FA22946BA0300FB5B72 /* libmad.a in Frameworks */ = {isa = PBXBuildFile; fileRef = 93B34FA02946BA0300FB5B72 /* libmad.a */; }; 93B34FA32946BA0300FB5B72 /* libFLAC.a in Frameworks */ = {isa = PBXBuildFile; fileRef = 93B34FA12946BA0300FB5B72 /* libFLAC.a */; }; @@ -147,6 +148,7 @@ files = ( 8558644E2B8421810016F8F6 /* qssm.pak in CopyFiles */, 668A0137277D80B0009D9427 /* Quakespasm-Spiked.txt in CopyFiles */, + 85F640312C9E1EE300615B7F /* macos_instructions.html in CopyFiles */, 66991C071DBAB4A600C373C0 /* quakespasm.pak in CopyFiles */, 66991C081DBAB4A600C373C0 /* LICENSE.txt in CopyFiles */, 66991C091DBAB4A600C373C0 /* Quakespasm-Music.txt in CopyFiles */, @@ -356,6 +358,7 @@ 85C58F432B9D79580010F658 /* json.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = json.c; path = ../Quake/json.c; sourceTree = ""; }; 85C58F452B9D79680010F658 /* json.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; name = json.h; path = ../Quake/json.h; sourceTree = SOURCE_ROOT; }; 85C58F472B9D7AAB0010F658 /* jsmn.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = jsmn.h; path = ../Quake/jsmn.h; sourceTree = SOURCE_ROOT; }; + 85F640302C9E1EE300615B7F /* macos_instructions.html */ = {isa = PBXFileReference; lastKnownFileType = text.html; name = macos_instructions.html; path = ../Quake/macos_instructions.html; sourceTree = ""; }; 85F94F5A2A606C26005D9F52 /* libmad.a */ = {isa = PBXFileReference; lastKnownFileType = archive.ar; name = libmad.a; path = libs_universal/libmad.a; sourceTree = ""; }; 85F94F5B2A606C31005D9F52 /* libFLAC.a */ = {isa = PBXFileReference; lastKnownFileType = archive.ar; name = libFLAC.a; path = libs_universal/libFLAC.a; sourceTree = ""; }; 8D1107310486CEB800E47090 /* Info.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist; path = Info.plist; sourceTree = ""; }; @@ -774,6 +777,7 @@ children = ( 66991C061DBAB48000C373C0 /* quakespasm.pak */, 8558644D2B8421770016F8F6 /* qssm.pak */, + 85F640302C9E1EE300615B7F /* macos_instructions.html */, 66991C021DBAB47000C373C0 /* LICENSE.txt */, 66991C031DBAB47000C373C0 /* Quakespasm-Music.txt */, 668A0133277D8068009D9427 /* Quakespasm-Spiked.txt */, diff --git a/Quake/macos_instructions.html b/Quake/macos_instructions.html new file mode 100644 index 00000000..b3d32786 --- /dev/null +++ b/Quake/macos_instructions.html @@ -0,0 +1,97 @@ + + + + + + Run QSS-M + + + + + + + +

How to Allow QSS-M App to Run on macOS

+

If you want to run the QSS-M app (because it was not downloaded from the App Store), you'll need to make it executable and remove any restrictions:

+ +
    +
  1. Open Terminal: You can find Terminal in your Applications folder under Utilities.
    2. +

    If you drag QSS-M.app (or the folder with it) to the terminal window it will show the path.

    + +
  2. Change Directory to QSS-M.app path:
    3. + cd path/to/QSS-M.app +

    Get the path from dragging to window or just type it if you know it.

    + + +
  3. Make the App Executable: Type the following command and hit Enter:
    4. + sudo chmod +x QSS-M.app + +

    This command gives the app permission to run.

    + +
  4. Remove Quarantine Restrictions: Next, enter this command and press Enter:
    5. + sudo xattr -r -d com.apple.quarantine QSS-M.app + +

    This removes any restrictions that might prevent the app from opening because it was downloaded from the internet.

    + +
+ + + +