DustyTab: how to install and update (Windows, Chrome)

Your saved list is stored inside Chrome, not in this folder. Replacing the files in this folder never deletes it. Only the Remove button on the DustyTab card in chrome://extensions deletes it. Never press Remove unless you have a backup and mean to start over.

THE ONE RULE: Chrome runs DustyTab from one folder, the one with manifest.json directly inside it. Keep that folder in one place (Documents is a good home), and when you update, empty it completely and paste the new version's files in. Never copy only some files over the old ones: two versions mixed in one folder is what stops DustyTab from starting.

FIRST INSTALL

1. Download the zip from https://app.austinpranger.com/dustytab
2. In Downloads, right-click the zip and choose "Extract All...". In the box "Files will be extracted to this folder", click Browse..., choose your Documents folder, click "Select Folder", then click Extract.
3. You now have Documents\DustyTab. Open it: you should see manifest.json, background.js, dustytab.html and the folders assets and icons. (If instead you see another folder called DustyTab, the inner one is the right one.)
4. In Chrome, go to chrome://extensions and turn on "Developer mode" (top right).
5. Click "Load unpacked", choose Documents\DustyTab (the folder with manifest.json directly inside), and click "Select Folder".
6. The DustyTab card should show the version number and no red "Errors" button. Click the puzzle-piece icon in Chrome's toolbar and pin DustyTab.
7. To bring back an old list: open DustyTab, go to Settings, click "Restore from backup...", pick your backup file, then "Replace everything" (or "Merge").

UPDATE TO A NEW VERSION (keeps your list)

1. Open DustyTab, go to Settings, click "Download backup". Just in case.
2. Go to chrome://extensions, click "Details" on the DustyTab card, and look at "Loaded from". That is the folder Chrome uses (for example C:\Users\you\Documents\DustyTab).
3. Close any DustyTab 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 DustyTab folder inside it, select everything (Ctrl+A), copy (Ctrl+C), go to your empty folder, and paste (Ctrl+V).
6. Check: manifest.json sits directly in the folder, not inside another DustyTab folder.
7. Back on chrome://extensions, click the round reload arrow on the DustyTab card. The version number on the card changes. Do not click Remove.
8. Open DustyTab. Your list is there.

IF SOMETHING GOES WRONG

- DustyTab shows "DustyTab couldn't start" or a red "files from different versions" message, or the page is blank: the folder has mixed files. Do update steps 2 to 7 again. Your list comes back after the reload.
- "Manifest file is missing or unreadable" when loading: you picked a folder one level too high or too low. Pick the folder with manifest.json directly inside it.
- The version number 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 DustyTab card is switched off, or shows a red "Errors" button: switch it on; click "Errors" to see the message (it helps to copy it when asking for help).
- The list is empty: the extension was removed at some point (that deletes its data). Restore your backup in Settings.
