Bundle the app for macOS (#1375)

.docs/Troubleshooting.md

@@ -146,6 +146,12 @@ Red Hat: `cert-sync --user /etc/pki/tls/certs/ca-bundle.crt`
 
 If it still doesn't work, try mozroots: `mozroots --import --ask-remove`
 
+## macOS-specific
+
+### DiscordChatExporter is damaged and can’t be opened. You should move it to the Trash.
+
+Check the [Using the GUI page](Using-the-GUI.md#step-1) for instructions on how to run the app.
+
 ---
 
 > ❓ If you still have unanswered questions, feel free to [create a new discussion](https://github.com/Tyrrrz/DiscordChatExporter/discussions/new).

.docs/Using-the-GUI.md

@@ -10,7 +10,22 @@
 
 ### Step 1
 
-After extracting the `.zip`, run `DiscordChatExporter.exe` (Windows), or `DiscordChatExporter` (Mac OS and Linux).
+After extracting the `.zip`, run `DiscordChatExporter.exe` **(Windows)**, or `DiscordChatExporter` **(Linux)**.
+
+If you're using **macOS**, you'll need to manually grant permission for the app to run.  
+If you skip these steps, the "DiscordChatExporter is damaged and can’t be opened" error will be shown.
+
+1. Open Terminal.app. You can search for it in Spotlight (press <kbd>⌘</kbd> + <kbd>Space</kbd> and type "Terminal").
+2. Paste the following into the terminal window:
+   ```bash
+   xattr -rd com.apple.quarantine
+   ```
+3. Hit <kbd>Space</kbd> once to add a space after the command
+4. Drag and drop DiscordChatExporter.app into the terminal window
+5. Press <kbd>Return</kbd> to run the command
+6. Open DiscordChatExporter.app normally
+
+> Apple requires apps to be notarized and signed in order to run on macOS without warnings, which in turn requires an Apple Developer membership ($99/year). This open-source project is distributed for free and without commercial intent.
 
 ### Step 2
 

.github/workflows/main.yml

@@ -138,6 +138,16 @@ jobs:
           --runtime ${{ matrix.rid }}
           --self-contained
 
+      - name: Generate macOS .app bundle resources
+        if: ${{ startsWith(matrix.rid, 'osx-') && matrix.app == 'DiscordChatExporter.Gui' }}
+        shell: pwsh
+        run: >
+          ./bundle-macos-app.ps1
+          -BundleName "${{ matrix.asset }}"
+          -PublishDir "${{ matrix.app }}/bin/publish/"
+          -Version "${{ github.ref_type == 'tag' && github.ref_name || '999.9.9'}}"
+          -GitHubSha "${{ github.sha }}"
+
       - name: Upload artifacts
         uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
         with:
@@ -210,9 +220,13 @@ jobs:
           path: ${{ matrix.app }}/
 
       - name: Set permissions
-        if: ${{ !startsWith(matrix.rid, 'win-') }}
+        if: ${{ !startsWith(matrix.rid, 'win-') && !(startsWith(matrix.rid, 'osx-') && matrix.app == 'DiscordChatExporter.Gui') }}
         run: chmod +x ${{ matrix.app }}/${{ matrix.asset }}
 
+      - name: Set permissions for macOS .app bundle
+        if: ${{ startsWith(matrix.rid, 'osx-') && matrix.app == 'DiscordChatExporter.Gui' }}
+        run: chmod +x ${{ matrix.app }}/${{ matrix.asset }}.app/Contents/MacOS/${{ matrix.asset }}
+
       - name: Create package
         # Change into the artifacts directory to avoid including the directory itself in the zip archive
         working-directory: ${{ matrix.app }}/

bundle-macos-app.ps1

@@ -0,0 +1,71 @@
+param(
+    [Parameter(Mandatory=$true)]
+    [string]$BundleName,
+
+    [Parameter(Mandatory=$true)]
+    [string]$PublishDir,
+
+    [Parameter(Mandatory=$true)]
+    [string]$Version,
+    
+    [Parameter(Mandatory=$true)]
+    [string]$GitHubSha
+)
+
+# Setup paths
+$appName = "$BundleName.app"
+$appDir = Join-Path "bundle-macos-app-staging" $appName
+$contentsDir = Join-Path $appDir "Contents"
+$macosDir = Join-Path $contentsDir "MacOS"
+$resourcesDir = Join-Path $contentsDir "Resources"
+
+# Create the macOS .app bundle directory structure
+New-Item -ItemType Directory -Path $macosDir -Force
+New-Item -ItemType Directory -Path $resourcesDir -Force
+
+# Copy icon into the .app's Resources folder
+Copy-Item -Path "favicon.icns" -Destination (Join-Path $resourcesDir "AppIcon.icns") -Force
+
+# Generate Info.plist metadata file with app information
+$plistContent = @"
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>CFBundleDisplayName</key>
+    <string>$BundleName</string>
+    <key>CFBundleName</key>
+    <string>$BundleName</string>
+    <key>CFBundleExecutable</key>
+    <string>$BundleName</string>
+    <key>NSHumanReadableCopyright</key>
+    <string>© Oleksii Holub</string>
+    <key>CFBundleIdentifier</key>
+    <string>me.Tyrrrz.$BundleName</string>
+    <key>CFBundleSpokenName</key>
+    <string>Discord Chat Exporter</string>
+    <key>CFBundleIconFile</key>
+    <string>AppIcon</string>
+    <key>CFBundleIconName</key>
+    <string>AppIcon</string>
+    <key>CFBundleVersion</key>
+    <string>$GitHubSha</string>
+    <key>CFBundleShortVersionString</key>
+    <string>$Version</string>
+    <key>NSHighResolutionCapable</key>
+    <true/>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+  </dict>
+</plist>
+"@
+
+Set-Content -Path (Join-Path $contentsDir "Info.plist") -Value $plistContent
+
+# Move all files from the publish directory into the MacOS directory
+Get-ChildItem -Path $PublishDir | ForEach-Object {
+    Move-Item -Path $_.FullName -Destination $macosDir -Force
+}
+
+# Move the final .app bundle into the publish directory for upload
+Move-Item -Path $appDir -Destination $PublishDir -Force