Murmur - how to install and update

THE ONE RULE: Chrome runs Murmur from one folder, the one with manifest.json directly inside it. Keep that folder in one place (your Documents folder is a good home), and never mix files from two versions in it.

INSTALL (first time)

1. Extract the zip. In Downloads, right-click the zip, choose Extract All..., click Browse..., choose your Documents folder, then Extract.
2. You now have Documents\Murmur. Open it: you should see manifest.json, popup.html and the folder icons. If you see another Murmur folder inside, the inner one is the right one.
3. In Chrome, open chrome://extensions (paste it into the address bar) and turn on Developer mode (top right).
4. Click Load unpacked, choose Documents\Murmur (the folder with manifest.json directly inside), and click Select Folder.
5. The Murmur card shows the version number and no red Errors button. Click the puzzle-piece icon in Chrome's toolbar and pin Murmur.

Chrome may show a "Disable developer mode extensions" notice when it starts. That is normal for extensions installed this way; close it.

USING IT

Select text on a web page, right-click, and choose Read aloud with Murmur. Or click the Murmur icon in the toolbar and press Play. The popup also has Pause, Resume, Stop, a speed slider and a voice picker.

Keyboard shortcuts: none is set until you choose. Open Murmur's Settings and press Open Chrome's shortcut settings.

Pages opened from your own computer (addresses starting with file://): Chrome requires you to switch this on yourself. Open chrome://extensions, click Details on the Murmur card, and turn on Allow access to file URLs.

UPDATE (new version)

1. Open the extension's Settings and press Download backup (skip this if you have not saved anything).
2. Open chrome://extensions, click Details on the Murmur card, and look at Loaded from. That is the folder Chrome uses.
3. Close the Murmur popup and any Murmur tabs.
4. Open that folder in File Explorer. Select everything inside it (Ctrl+A) and delete it. Keep the empty folder.
5. Download the new zip. Double-click it to look inside, open the Murmur folder inside it, select everything (Ctrl+A), copy (Ctrl+C), go to your empty folder, and paste (Ctrl+V).
6. Check that manifest.json sits directly in the folder, not inside another Murmur folder.
7. Back on chrome://extensions, click the round reload arrow on the Murmur card. The version number on the card changes.

WHY EMPTY THE FOLDER FIRST? Copying new files over old ones, or copying only some of them, can leave files from two versions side by side, and then the extension can't start. An empty folder plus one version's files is always clean. Prefer reload to Remove: removing the extension deletes its saved data.

IF SOMETHING GOES WRONG

- The popup is blank, or Chrome shows errors: the folder probably has mixed files. Do the update steps 4 to 7 again.
- "Manifest file is missing or unreadable" when loading: you chose a folder one level too high or too low. Choose the folder with manifest.json directly inside it.
- The version on the card did not change after reloading: Chrome is loading a different folder than the one you updated. Check Loaded from on the card's Details page.
- The card is switched off, or has a red Errors button: switch it on; click Errors to read the message, and copy it if you ask for help.
