pithos.sia: Windows downloads for the desktop app
The desktop card said "installers coming"; it now links the installer and portable exe, and says what quitting really does on Windows (s3d is stopped, and anything it accepted is already on disk) instead of promising a clean flush. The docs name where the hashes are, what SmartScreen will say about an unsigned build, and how the account label is filled in now.
This commit is contained in:
Local Dev
parent
0092662b57
commit
a539f2d90d
3 changed files with 12 additions and 7 deletions
|
|
@ -84,7 +84,7 @@
|
|||
<h2 id="the-pithos-screen"><a class="anchor" href="#the-pithos-screen" aria-hidden="true">#</a>The Pithos screen</h2>
|
||||
<p>The menu is in setup order. In the narrow sidebar it is the ☰ button at the top right; the ⤢ button next to it opens Pithos as a full page.</p>
|
||||
<h3 id="accounts"><a class="anchor" href="#accounts" aria-hidden="true">#</a>Accounts</h3>
|
||||
<ul><li><strong>Your Sia accounts</strong> at the top: the account in use (with its free space) and any accounts set aside on this computer, each with <strong>Switch to</strong>, plus <strong>Add another account</strong>.</li><li><strong>Add another account</strong> sets the current account aside (its users, keys and drives are kept on this computer, nothing is deleted), stops s3d and runs the guide for the new account. Files already on Sia stay in the old account; switch back any time.</li><li><strong>Account label</strong>: Pithos cannot see the login email, so name the account yourself (for example the email you approved the connection with).</li><li><strong>Which Sia account this is</strong>: the account key, app name, storage used, last use and indexer, read from the indexer.</li></ul>
|
||||
<ul><li><strong>Your Sia accounts</strong> at the top: the account in use (with its free space) and any accounts set aside on this computer, each with <strong>Switch to</strong>, plus <strong>Add another account</strong>.</li><li><strong>Add another account</strong> sets the current account aside (its users, keys and drives are kept on this computer, nothing is deleted), stops s3d and runs the guide for the new account. Files already on Sia stay in the old account; switch back any time.</li><li><strong>Account label</strong>: Sia Storage does not tell apps who signed in, so the guide asks for your Sia Storage email at the approval step and names the account after it. Change it here any time.</li><li><strong>Which Sia account this is</strong>: the account key, app name, storage used, last use and indexer, read from the indexer.</li></ul>
|
||||
<h3 id="overview"><a class="anchor" href="#overview" aria-hidden="true">#</a>Overview</h3>
|
||||
<ul><li><strong>Gateway</strong>: s3d's state (running, stopped, crashed, external), endpoint, version, config and data folders; Start, Restart, Stop.</li><li><strong>Upload pipeline</strong>: pending (waiting on this computer), on Sia, awaiting pin, open multipart uploads, failed and orphaned objects; <strong>Flush now</strong>.</li><li><strong>Free space</strong>: used and free storage on your Sia account.</li></ul>
|
||||
<h3 id="users-keys"><a class="anchor" href="#users-keys" aria-hidden="true">#</a>Users & keys</h3>
|
||||
|
|
@ -109,8 +109,10 @@ node bin/pithos-web.js</code></pre>
|
|||
<div class="table"><table><thead><tr><th>Flag</th><th>Meaning</th></tr></thead><tbody><tr><td><code>--listen host:port</code></td><td>Address to serve on (default <code>127.0.0.1:8700</code>). Anything beyond loopback needs a password.</td></tr><tr><td><code>--config <s3d.yml></code></td><td>Which s3d config to manage.</td></tr><tr><td><code>--s3d <binary></code></td><td>Use this s3d binary.</td></tr><tr><td><code>--bin-dir <dir></code></td><td>Where Pithos installs s3d.</td></tr><tr><td><code>--password-file <file></code></td><td>Password login (or set <code>PITHOS_PASSWORD</code>, at least 12 characters).</td></tr><tr><td><code>--allow-host <name[:port]></code></td><td>Extra Host names allowed (behind a reverse proxy). Repeatable.</td></tr></tbody></table></div>
|
||||
<p>Remote access: <code>PITHOS_PASSWORD='long random secret' node bin/pithos-web.js --listen 0.0.0.0:8700 --allow-host pithos.example.org</code>, behind a TLS reverse proxy.</p>
|
||||
<h3 id="desktop-app"><a class="anchor" href="#desktop-app" aria-hidden="true">#</a>Desktop app</h3>
|
||||
<pre class="code" data-lang="bash"><button class="copy" type="button" aria-label="Copy">Copy</button><code>npm run desktop</code></pre>
|
||||
<p>The window signs itself in; quitting stops s3d.</p>
|
||||
<p>Windows: <a href="https://dl.silentmode.st/latest/Pithos-Setup.exe">installer</a> or <a href="https://dl.silentmode.st/latest/Pithos-portable.exe">portable exe</a> (SHA-256 sums in <a href="https://dl.silentmode.st/releases-manifest.json">releases-manifest.json</a> under <code>pithos-desktop</code>). The builds are not code-signed yet, so Windows SmartScreen may ask you to confirm with More info › Run anyway. macOS and Linux builds are not published yet; run it from source:</p>
|
||||
<pre class="code" data-lang="bash"><button class="copy" type="button" aria-label="Copy">Copy</button><code>npm install
|
||||
npm run desktop</code></pre>
|
||||
<p>The window signs itself in, installs s3d into its own folder (<code>%APPDATA%\pithos\bin</code> on Windows) and stops s3d when you quit. The version in the footer turns into "↑ vX" when a newer build is out; click it to download that build, then run it to update. Build the installers yourself with <code>npm run dist:win</code> (or <code>dist:linux</code> / <code>dist:mac</code> on those systems).</p>
|
||||
<h3 id="which-s3d-pithos-manages"><a class="anchor" href="#which-s3d-pithos-manages" aria-hidden="true">#</a>Which s3d Pithos manages</h3>
|
||||
<p>The same one a hand-run <code>s3d</code> uses: <code>S3D_CONFIG_FILE</code> if set, otherwise <code>%APPDATA%\s3d\s3d.yml</code> (Windows), <code>~/Library/Application Support/s3d/s3d.yml</code> (macOS), <code>/etc/s3d/s3d.yml</code> (Linux). If another s3d already serves that config, Pithos shows it as <strong>external</strong> and does not start a second one.</p>
|
||||
<h2 id="s3d-on-the-command-line"><a class="anchor" href="#s3d-on-the-command-line" aria-hidden="true">#</a>s3d on the command line</h2>
|
||||
|
|
|
|||
|
|
@ -49,7 +49,7 @@ The menu is in setup order. In the narrow sidebar it is the ☰ button at the to
|
|||
|
||||
- **Your Sia accounts** at the top: the account in use (with its free space) and any accounts set aside on this computer, each with **Switch to**, plus **Add another account**.
|
||||
- **Add another account** sets the current account aside (its users, keys and drives are kept on this computer, nothing is deleted), stops s3d and runs the guide for the new account. Files already on Sia stay in the old account; switch back any time.
|
||||
- **Account label**: Pithos cannot see the login email, so name the account yourself (for example the email you approved the connection with).
|
||||
- **Account label**: Sia Storage does not tell apps who signed in, so the guide asks for your Sia Storage email at the approval step and names the account after it. Change it here any time.
|
||||
- **Which Sia account this is**: the account key, app name, storage used, last use and indexer, read from the indexer.
|
||||
|
||||
### Overview
|
||||
|
|
@ -123,11 +123,14 @@ Remote access: `PITHOS_PASSWORD='long random secret' node bin/pithos-web.js --li
|
|||
|
||||
### Desktop app
|
||||
|
||||
Windows: [installer](https://dl.silentmode.st/latest/Pithos-Setup.exe) or [portable exe](https://dl.silentmode.st/latest/Pithos-portable.exe) (SHA-256 sums in [releases-manifest.json](https://dl.silentmode.st/releases-manifest.json) under `pithos-desktop`). The builds are not code-signed yet, so Windows SmartScreen may ask you to confirm with More info › Run anyway. macOS and Linux builds are not published yet; run it from source:
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm run desktop
|
||||
```
|
||||
|
||||
The window signs itself in; quitting stops s3d.
|
||||
The window signs itself in, installs s3d into its own folder (`%APPDATA%\pithos\bin` on Windows) and stops s3d when you quit. The version in the footer turns into "↑ vX" when a newer build is out; click it to download that build, then run it to update. Build the installers yourself with `npm run dist:win` (or `dist:linux` / `dist:mac` on those systems).
|
||||
|
||||
### Which s3d Pithos manages
|
||||
|
||||
|
|
|
|||
|
|
@ -281,8 +281,8 @@
|
|||
</div>
|
||||
<div class="card">
|
||||
<div class="ic">🖥️</div><h3>Desktop app</h3>
|
||||
<p>A standalone window for Windows, macOS and Linux. Quitting stops s3d cleanly, so your upload buffer is always flushed to disk.</p>
|
||||
<span class="status soon">Installers coming</span>
|
||||
<p>A standalone window for Windows: install it, or run the portable exe from anywhere. It fetches s3d on first run, keeps it running while open and stops it when you quit; files s3d has accepted are already safe on disk. It tells you when a new version is out.</p>
|
||||
<a class="status ok" style="text-decoration:none" href="https://dl.silentmode.st/latest/Pithos-Setup.exe">Windows installer</a> <a class="status ok" style="text-decoration:none" href="https://dl.silentmode.st/latest/Pithos-portable.exe">Portable exe</a> <span class="status soon">macOS & Linux coming</span>
|
||||
</div>
|
||||
<div class="card">
|
||||
<div class="ic">🌐</div><h3>Web console</h3>
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue