-
-
Notifications
You must be signed in to change notification settings - Fork 7
Expand file tree
/
Copy pathmacos-install.html
More file actions
117 lines (107 loc) · 5.7 KB
/
Copy pathmacos-install.html
File metadata and controls
117 lines (107 loc) · 5.7 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
<!DOCTYPE html>
<html lang="en-GB">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>macOS install — OscarWatch Help</title>
<link rel="stylesheet" href="styles.css" />
</head>
<body>
<div class="wrap">
<header>
<div class="brand">
<a href="index.html" class="brand-home" title="Home"><img src="oscarwatch-icon.png" alt="" class="brand-icon" width="56" height="56" /></a>
<div class="brand-text">
<h1>macOS install</h1>
<p class="tagline">Download, extract, and approve the first run</p>
</div>
</div>
<nav aria-label="Help topics">
<ul>
<li><a href="quick-start.html">Quick start</a></li>
<li><a href="map-and-sidebar.html">Map & sidebar</a></li>
<li><a href="frequencies.html">Frequencies</a></li>
<li><a href="satellites.html">Satellites & TLEs</a></li>
<li><a href="passes.html">Pass planning</a></li>
<li><a href="radio-rotator.html">Radio & rotator</a></li>
<li><a href="settings.html">Settings</a></li>
<li><a href="keyboard-shortcuts.html">Shortcuts</a></li>
<li><a href="troubleshooting.html">Problems?</a></li>
</ul>
</nav>
</header>
<main>
<p class="lead">
Pre-built OscarWatch releases from GitHub are not code-signed or notarised. On a Mac, the first launch
usually needs a few extra steps to extract the archive, clear quarantine, and approve bundled native
libraries. These prompts are normally <strong>one-time per install</strong>. It sounds worse than it is.
</p>
<div class="tip">
<strong>Which download?</strong> Pick the archive that matches your Mac:
<code>OscarWatch-osx-arm64</code> for Apple Silicon (M-series), or <code>OscarWatch-osx-x64</code> for Intel.
Both are on the <a href="https://github.com/magicbug/OscarWatch-Tracker/releases" target="_blank" rel="noopener">Releases</a> page.
</div>
<h2>1. Download and extract</h2>
<ol>
<li>Download the <code>.zip</code> or <code>.tar.gz</code> archive for your Mac from GitHub Releases.</li>
<li>In Finder, right-click the downloaded file and choose <strong>Open With → Archive Utility</strong>.
That creates a folder in Downloads (for example <code>OscarWatch-osx-arm64</code>).</li>
<li>For convenience, rename that folder to <code>OscarWatch</code>.</li>
</ol>
<h2>2. Remove quarantine (Terminal)</h2>
<p>
Open <strong>Terminal</strong> and run the following, replacing <code>xxxx</code> with your macOS user name
and adjusting the path if you saved the folder somewhere other than Downloads:
</p>
<pre><code>xattr -d com.apple.quarantine /Users/xxxx/Downloads/OscarWatch/OscarWatch</code></pre>
<p>
If you extracted to a different location, point the command at the <code>OscarWatch</code> executable
inside your folder.
</p>
<h2>3. Start OscarWatch</h2>
<ol>
<li>In Finder, open your <code>OscarWatch</code> folder.</li>
<li>Double-click the <code>OscarWatch</code> executable (no <code>.app</code> wrapper — the file is named <code>OscarWatch</code>).</li>
</ol>
<p>
Alternatively, right-click <code>OscarWatch</code> → <strong>Open</strong> once if Finder says the file
“cannot be opened”.
</p>
<h2>4. Approve blocked libraries</h2>
<p>
macOS may show errors about a <code>.dylib</code> file (for example
<code>libportaudio.dylib</code> under <code>runtimes/osx-*/native/</code> inside the app folder).
You may need to approve <strong>several</strong> bundled libraries — often about three — before the app
starts cleanly.
</p>
<ol>
<li>Open <strong>System Settings → Privacy & Security</strong>.</li>
<li>Scroll to <strong>Security</strong> and look for a message about a blocked file from OscarWatch.</li>
<li>Click <strong>Allow Anyway</strong>.</li>
<li>If a “file not open” dialogue is still showing, click <strong>Done</strong>, then try launching
<code>OscarWatch</code> again.</li>
<li>Enter your Mac password when macOS asks you to authorise the library.</li>
<li>Repeat for each blocked <code>.dylib</code> until OscarWatch opens.</li>
</ol>
<p>
Tracking, passes, and radio/rotator control work without pass recording if you skip PortAudio approval.
If you use <strong>Settings → Recording</strong>, also grant <strong>microphone</strong> access when prompted.
</p>
<h2>After install</h2>
<p>
Settings and logs live under <code>~/.config/OscarWatch/</code> (or your XDG config directory).
See <a href="quick-start.html">Quick start</a> for station setup, TLE refresh, and your first pass.
</p>
<h2>Troubleshooting</h2>
<ul>
<li><strong>Still blocked after Allow Anyway</strong> — quit OscarWatch, run the <code>xattr</code> command again on the executable, then relaunch.</li>
<li><strong>Wrong architecture</strong> — an Intel Mac needs <code>osx-x64</code>; Apple Silicon needs <code>osx-arm64</code>.</li>
<li><strong>Serial ports</strong> — pick <code>/dev/cu.*</code> under Settings → Radio / Rotator; see <a href="radio-rotator.html">Radio & rotator</a>.</li>
</ul>
<p>See also <a href="troubleshooting.html#macos-install">Problems? → macOS install</a>.</p>
<p><em>Install steps adapted from a guide by Tim GW4VXE.</em></p>
</main>
<footer><a href="index.html">Back to help home</a></footer>
</div>
</body>
</html>