Docs sounds update, warning header on migration guide (#181)

* Beefed up initial and updating guides with sounds and an updated screenshot

* Added scary warning to top of blockchain migration guide

* Changed purchased to downloaded since EmbassyOS is 100% free now

* Added vaultwarden browser secure context faq question

* Update updating.rst

* Update faq-services.rst

Co-authored-by: kn0wmad <39687477+kn0wmad@users.noreply.github.com>

poetry.lock

@@ -177,11 +177,11 @@ python-versions = ">=3.7"
 
 [[package]]
 name = "more-itertools"
-version = "8.14.0"
+version = "9.0.0"
 description = "More routines for operating on iterables, beyond itertools"
 category = "dev"
 optional = false
-python-versions = ">=3.5"
+python-versions = ">=3.7"
 
 [[package]]
 name = "packaging"
@@ -279,7 +279,7 @@ checkqa-mypy = ["mypy (==v0.761)"]
 
 [[package]]
 name = "pytz"
-version = "2022.4"
+version = "2022.5"
 description = "World timezone definitions, modern and historical"
 category = "main"
 optional = false
@@ -774,8 +774,8 @@ markupsafe = [
     {file = "MarkupSafe-2.1.1.tar.gz", hash = "sha256:7f91197cc9e48f989d12e4e6fbc46495c446636dfc81b9ccf50bb0ec74b91d4b"},
 ]
 more-itertools = [
-    {file = "more-itertools-8.14.0.tar.gz", hash = "sha256:c09443cd3d5438b8dafccd867a6bc1cb0894389e90cb53d227456b0b0bccb750"},
+    {file = "more-itertools-9.0.0.tar.gz", hash = "sha256:5a6257e40878ef0520b1803990e3e22303a41b5714006c32a3fd8304b26ea1ab"},
-    {file = "more_itertools-8.14.0-py3-none-any.whl", hash = "sha256:1bc4f91ee5b1b31ac7ceacc17c09befe6a40a503907baf9c839c229b5095cfd2"},
+    {file = "more_itertools-9.0.0-py3-none-any.whl", hash = "sha256:250e83d7e81d0c87ca6bd942e6aeab8cc9daa6096d12c5308f3f92fa5e5c1f41"},
 ]
 packaging = [
     {file = "packaging-21.3-py3-none-any.whl", hash = "sha256:ef103e05f519cdc783ae24ea4e2e0f508a9c99b2d4969652eed6a2e1ea5bd522"},
@@ -808,8 +808,8 @@ pytest = [
     {file = "pytest-5.4.3.tar.gz", hash = "sha256:7979331bfcba207414f5e1263b5a0f8f521d0f457318836a7355531ed1a4c7d8"},
 ]
 pytz = [
-    {file = "pytz-2022.4-py2.py3-none-any.whl", hash = "sha256:2c0784747071402c6e99f0bafdb7da0fa22645f06554c7ae06bf6358897e9c91"},
+    {file = "pytz-2022.5-py2.py3-none-any.whl", hash = "sha256:335ab46900b1465e714b4fda4963d87363264eb662aab5e65da039c25f1f5b22"},
-    {file = "pytz-2022.4.tar.gz", hash = "sha256:48ce799d83b6f8aab2020e369b627446696619e79645419610b9facd909b3174"},
+    {file = "pytz-2022.5.tar.gz", hash = "sha256:c4d88f472f54d615e9cd582a5004d1e5f624854a6a27a6211591c251f22a6914"},
 ]
 pyyaml = [
     {file = "PyYAML-6.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:d4db7c7aef085872ef65a8fd7d6d09a14ae91f691dec3e87ee5ee0539d516f53"},

site/source/support/faq/faq-services.rst

@@ -66,6 +66,10 @@ What is happening if I cannot connect with another user on Mastodon?
 You can only follow someone who has an account on a Mastodon server that supports Tor. It is a new feature, so many instances do not have it yet.
 Other issues are typically related to the tor connection, check your tor daemon, orbot, or try to restart the service.
 
+What does it mean when Vaultwarden says "This browser requires HTTPS to use the web vault" upon creating an account or loging in to my Vaultwarden onion?
+---------------------------------------------------------------------------------------------------------------------------------------------------------
+You will need to tell your browser to treat .onion URLs as a "secure context".  You will need to follow this guide to configure :ref:`Tor on Firefox<tor-firefox>`.
+
 Can the browser extension be used with Bitwarden hosted on the embassy?
 -----------------------------------------------------------------------
 Yes, but only in a tor-enabled browser.  Just add your .onion address as the server in the extension.  Make sure that http:// is at the beginning, and NOT https://, as this will not work.

site/source/user-manual/initial-setup.rst

@@ -15,7 +15,16 @@ Powering On
 
     .. tip:: To avoid networking issues, it is recommended to use your `primary` router, not an extender or mesh router.
 
-#. You will hear 2 distinct sounds:
+    .. caution:: If there is something wrong with your hardware setup, such as ethernet being unavailable, you will hear this sound:
+      
+      .. raw:: HTML
+
+        <audio controls>
+          <source src="/_static/sounds/FLATLINE.mp3" type="audio/mpeg">
+          Your browser does not support the audio element.
+        </audio>
+
+#. If all is well, you will hear 2 distinct sounds:
 
     .. raw:: HTML
 

site/source/user-manual/service-guides/bitcoin/blockchain-copy.rst

@@ -8,6 +8,8 @@ Blockchain Migration
   :depth: 2
   :local:
 
+.. warning:: This is an advanced feature and should be used with caution.  Start9 is not responsible for any damage you might cause through SSH access.
+
 If you have already synced the Bitcoin blockchain to the tip on one Embassy, and would like to skip IBD on another Embassy, follow this guide.
 
 .. note:: The following guide requires that you have already :ref:`setup SSH on both Embassies<ssh>`.

site/source/user-manual/updating.rst

@@ -21,7 +21,16 @@ How to Update
 #. Read the release notes and click "Begin Update".
 #. While the new version of EmbassyOS is downloading, you may continue to use your device as usual.
 #. Once the download is complete, you will be prompted to restart Embassy.
-#. After restart, you may be prompted to refresh the browser window.
+#. After restart, but before the web interface becomes available again, there may be a brief upgrade period of up to thirty minutes where data is transitioned.  You will hear this sound every ten seconds until the upgrade is complete:
+
+    .. raw:: HTML
+
+        <audio controls>
+          <source src="/_static/sounds/UPDATING.mp3" type="audio/mpeg">
+          Your browser does not support the audio element.
+        </audio>
+   **Do not unplug or otherwise power off the embassy during this period.**
+#. Next, you may be prompted to refresh the browser window.
 
 Disabling Auto Check for Updates
 --------------------------------
@@ -44,20 +53,43 @@ Manual Update by Re-flashing
 #. `Flash the downloaded image <../flashing>`_ to your microSD card.
 #. Insert the microSD card into your Embassy and power it on.
 
-    .. note:: Embassy will power up and then initialize, a process of less than 5 minutes if you purchased an image, or about 10-20 minutes if you built from source. Once complete you will hear a _bep_ to indicate it is initialized and then a _chime_ sound to indicate it is online.
+    .. note:: Embassy will power up and then initialize, a process of less than 5 minutes if you downloaded an image, or about 10-20 minutes if you built from source. Once complete you will hear a _bep_ to indicate it is initialized and then a _chime_ sound to indicate it is online.
 
-#. On your computer, open up a browser and go to http://embassy.local.
+#. On your computer, open up a browser and go to http://embassy.local
-#. When prompted, enter your Product Key:
 
-   .. figure:: /_static/images/setup/migrate0.png
+#. Select "Recover"
+
+   .. figure:: /_static/images/setup/screen0-startfresh_or_recover.jpg
       :width: 60%
 
-#. Select "Recover".
+#. Select "Use Existing Drive"
 
-   .. figure:: /_static/images/setup/migrate1.png
+   .. figure:: /_static/images/setup/screen3-use_existing.jpg
       :width: 60%
 
-#. Assuming you have you fully-intact EmbassyOS data drive plugged in, you will receive a popup declaring that a valid data drive has been detected. Click "Use Drive" from the pop-up. If you don't see the drive, you may get a message asking you to unplug, then plug back in the drive, and refresh the page.
+#. Assuming you have you fully-intact EmbassyOS data drive plugged in, it will be automatically detected and begin the upgrade.
 
-   .. figure:: /_static/images/setup/use-drive.png
+   .. raw:: HTML
+
+      <audio controls>
+        <source src="/_static/sounds/UPDATING.mp3" type="audio/mpeg">
+        Your browser does not support the audio element.
+      </audio>
+
+      <br />This sound will play every ten seconds until the upgrade is done.  <b>Do not unplug or otherwise power off the embassy during this period.</b><br /><br />
+
+#. Create a master password for your Embassy and click "Finish."
+
+    .. warning:: Choose a strong master password.  If you don't wish to change your password from the previous version, just set it to the same thing it was before you began the upgrade.  Write this password down.  Store it somewhere safe.  DO NOT LOSE IT.
+
+   .. figure:: /_static/images/setup/screen5-set_password.jpg
       :width: 60%
+      :alt: Create A Password
+
+#. Your Embassy is now on the new version and the old version's data has been migrated to it!  Continue to the section on :ref:`connecting` to learn more about using your Embassy over Tor and LAN.
+
+    .. tip:: You will see the following screen and also be prompted to save your Embassy address and certificate info on your computer.  We recommand you backup this html file somewhere safe so that you can reference it if you ever need to connect to your Embassy from a new computer.
+
+    .. figure:: /_static/images/setup/screen7-startfresh_complete.jpg
+      :width: 60%
+      :alt: Setup Complete