From 4d270976a2aa7c0f3cc0fcd82b431fb7431f0386 Mon Sep 17 00:00:00 2001
From: Local Dev <dev@localhost>
Date: Sun, 4 Oct 2026 00:17:20 +0200
Subject: [PATCH] pithos.sia: drives, the viewer, a drive per user, s3d stays
 up

Pithos 0.3.5 and 0.3.6 show buckets as drives, give every user one, open pictures, music, video and text in a viewer, and keep s3d running across restarts. The site now says drives (with a note that S3 apps call them buckets), adds Drives/folders/files and Built-in viewer cards, and a FAQ on why single folders cannot be public or shared yet.
---
 index.html | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/index.html b/index.html
index 266e20d..a570e8c 100644
--- a/index.html
+++ b/index.html
@@ -4,12 +4,12 @@
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Pithos — a control panel for your Sia storage</title>
-<meta name="description" content="Pithos runs s3d, the Sia S3 gateway, for you: connect it to Sia, create S3 users and keys, browse and share buckets, and watch uploads land on the network. In Theseus, on the desktop, or in a browser.">
+<meta name="description" content="Pithos runs s3d, the Sia S3 gateway, for you: connect it to Sia, create S3 users and keys, browse and share your drives, and watch uploads land on the network. In Theseus, on the desktop, or in a browser.">
 <link rel="icon" href="assets/favicon.svg" type="image/svg+xml">
 <meta property="og:type" content="website">
 <meta property="og:site_name" content="pithos.sia">
 <meta property="og:title" content="Pithos — a control panel for your Sia storage">
-<meta property="og:description" content="Run s3d without the command line: Sia connection, S3 users and keys, buckets, live upload pipeline.">
+<meta property="og:description" content="Run s3d without the command line: Sia connection, S3 users and keys, drives and files, live upload pipeline.">
 <meta property="og:image" content="assets/logo.svg">
 <meta name="twitter:card" content="summary">
 <style>
@@ -153,7 +153,7 @@
 <header class="hero">
   <img src="assets/logo.svg" alt="Pithos">
   <h1>Your own S3, <span class="g">stored on Sia</span></h1>
-  <p class="tag">Pithos runs <a href="https://github.com/SiaFoundation/s3d">s3d</a>, the Sia Foundation's S3 gateway, without the command line. Connect it to Sia, hand out access keys, manage buckets and watch your files reach the network.</p>
+  <p class="tag">Pithos runs <a href="https://github.com/SiaFoundation/s3d">s3d</a>, the Sia Foundation's S3 gateway, without the command line. Connect it to Sia, hand out access keys, manage your drives and watch your files reach the network.</p>
   <div class="cta">
     <a class="btn primary" href="#get">Get Pithos</a>
     <a class="btn" href="#how">How it works</a>
@@ -162,7 +162,7 @@
   <div class="shot" aria-hidden="true">
     <div class="bar"><i></i><i></i><i></i></div>
     <div class="body">
-      <nav><span>Get started</span><span class="on">Overview</span><span>Buckets</span><span>Users &amp; keys</span><span>Sia connection</span><span>Settings</span><span>Logs</span></nav>
+      <nav><span>Get started</span><span class="on">Overview</span><span>Drives</span><span>Users &amp; keys</span><span>Sia connection</span><span>Settings</span><span>Logs</span></nav>
       <div class="main">
         <div class="pill">s3d running</div>
         <h3>Upload pipeline</h3>
@@ -187,11 +187,12 @@
       <div class="card"><div class="ic">🔗</div><h3>Guided setup</h3><p>A step-by-step guide takes you from a free Sia Storage account to a working S3 key. Pithos opens the approval page for you and carries on by itself the moment you approve.</p></div>
       <div class="card"><div class="ic">🔒</div><h3>Locked with your PIN</h3><p>In Theseus, Pithos opens with your vault PIN. Three wrong tries and Theseus asks for your master password instead. Lock the vault and Pithos locks with it.</p></div>
       <div class="card"><div class="ic">🔑</div><h3>Users &amp; access keys</h3><p>Create a user per app or person. Issue and revoke keys, copy ready-made config for the aws CLI, rclone or environment variables, and save keys to an encrypted file protected by a password or your Theseus vault.</p></div>
-      <div class="card"><div class="ic">🔁</div><h3>Switch Sia accounts</h3><p>See which Sia account your storage runs on and give it a name. Switch to another account any time: the old one's users, keys and buckets are set aside on your computer, never deleted, and restore with one click.</p></div>
-      <div class="card"><div class="ic">🗂️</div><h3>Buckets &amp; files</h3><p>Browse any user's buckets, drag files in, download them, delete folders, and make a bucket public-read when you want to serve files.</p></div>
+      <div class="card"><div class="ic">🔁</div><h3>Switch Sia accounts</h3><p>See which Sia account your storage runs on and give it a name. Switch to another account any time: the old one's users, keys and drives are set aside on your computer, never deleted, and restore with one click.</p></div>
+      <div class="card"><div class="ic">💽</div><h3>Drives, folders &amp; files</h3><p>Your storage looks like a computer: drives that show what they hold, folders that stay put even while empty, and files you drag in. Every new user gets a drive of their own, and a drive can be private or public.</p></div>
+      <div class="card"><div class="ic">🖼️</div><h3>Built-in viewer</h3><p>Open pictures, play music and video, and read text files right in Pithos, without downloading them first. Anything else downloads with one click.</p></div>
       <div class="card"><div class="ic">📤</div><h3>Share links</h3><p>Signed links that work without a key and expire after an hour, a day or a week.</p></div>
       <div class="card"><div class="ic">📈</div><h3>Upload pipeline</h3><p>See what is still buffered locally, what is already on Sia, and anything that failed. Flush the buffer on demand.</p></div>
-      <div class="card"><div class="ic">⚙️</div><h3>Daemon &amp; settings</h3><p>Install the official s3d release with its checksum verified, start and stop it, follow its logs and edit its settings, including redundancy and upload threads.</p></div>
+      <div class="card"><div class="ic">⚙️</div><h3>Daemon &amp; settings</h3><p>Install the official s3d release with its checksum verified, and Pithos keeps it running: it comes back after a restart and recovers from a crash by itself. Follow its logs and edit its settings, including redundancy and upload threads.</p></div>
     </div>
   </div>
 </section>
@@ -274,9 +275,10 @@
     <details class="faq"><summary>What does it cost?</summary><p>Pithos is free and open source. Storage is billed by your Sia indexer, for example sia.storage.</p></details>
     <details class="faq"><summary>Which s3d version do I need?</summary><p>v0.2.0 or newer. Pithos offers to install the right one for you and tells you when yours is too old.</p></details>
     <details class="faq"><summary>I already run s3d as a service. Can Pithos manage it?</summary><p>Yes. Pithos uses the same config file a hand-run s3d uses. If s3d is already running, Pithos shows it as external, reads its stats and leaves the process alone.</p></details>
-    <details class="faq"><summary>What is the difference between a Sia account, an S3 user and a bucket?</summary><p>The <b>Sia account</b> (for example on sia.storage) pays for the space; your s3d is connected to one. <b>S3 users</b> are logins on your own s3d, each with its own access keys, so you can give an app its own key and revoke it alone. A <b>bucket</b> is a top-level storage container, like a drive, owned by one user; folders inside it are just part of each file's name.</p></details>
-    <details class="faq"><summary>Can I switch to a different Sia account?</summary><p>Yes, under Sia connection › Switch Sia account. s3d connects to the new account and starts empty. The previous account keeps its files, and its users, keys and buckets are set aside on your computer so you can restore them later. Pithos warns you first if uploads are still on their way to Sia.</p></details>
+    <details class="faq"><summary>What is the difference between a Sia account, an S3 user and a drive?</summary><p>The <b>Sia account</b> (for example on sia.storage) pays for the space; your s3d is connected to one. <b>S3 users</b> are logins on your own s3d, each with its own access keys, so you can give an app its own key and revoke it alone. A <b>drive</b> is top-level storage owned by one user, like a disk on your computer; S3 apps call it a <i>bucket</i>. Folders and files go inside drives.</p></details>
+    <details class="faq"><summary>Can I switch to a different Sia account?</summary><p>Yes, under Sia connection › Switch Sia account. s3d connects to the new account and starts empty. The previous account keeps its files, and its users, keys and drives are set aside on your computer so you can restore them later. Pithos warns you first if uploads are still on their way to Sia.</p></details>
     <details class="faq"><summary>What if I forget my PIN?</summary><p>After three wrong tries Theseus asks for your master password, which always works. You can set a new PIN any time in Theseus Settings › Passwords.</p></details>
+    <details class="faq"><summary>Can I make a single folder public, or share a drive with someone?</summary><p>Not yet. s3d can make a whole drive public for reading, but not one folder, and it cannot give other people rights to add or change files. Keep public files on a drive of their own, and send a share link for a single file.</p></details>
     <details class="faq"><summary>Is there a size limit?</summary><p>Uploads from the Pithos window are capped at 5 GiB per file for now. S3 clients such as aws and rclone use multipart uploads and go well beyond that.</p></details>
     <details class="faq"><summary>Why the name?</summary><p>A pithos was the great storage jar of the ancient Greek world, where a household kept what it could not afford to lose.</p></details>
   </div>