AWS Favicons WebExtension

Tired of all your AWS browser tabs having the same orange cube favicon? This WebExtension fixes that by setting the favicon to the appropriate one for the current service.

It's a complete rewrite of JB4GDI/awsfaviconupdater with much simpler code.

Building

Firefox

To build the extension for Firefox:

$ cd aws-favicons-webextension
$ npm install
$ npm run build:firefox

The built extension will be in web-ext-artifacts/v2/aws_favicons-<version>.zip. The v2 signifies Manifest V2.

To install it into a production version of Firefox, you will first need to sign the built extension using web-ext sign - you'll need a Mozilla developer account for this.

Chrome

To build the extension for Chrome:

$ cd aws-favicons-webextension
$ npm install
$ npm run build:chromium

The built extension will be in web-ext-artifacts/v3/aws_favicons-<version>.zip. The v3 signifies Manifest V3.

Updating the icons and service definitions

This repository includes a script to update the service definitions and download the service icons. It has a few dependencies:

a recent version of Bash
sed
curl
jq
pup
node

The update script scrapes some generic metadata from the AWS cloud console in order to get a list of all AWS services and their associated icons. The page containing this metadata is only available when logged in, but the metadata itself isn't sensitive, and it doesn't include any information about the logged-in user.

Before you run the script, you will need to log in to an AWS account and follow these steps:

Go to your AWS console home page (URL should be https://<region>.console.aws.amazon.com/console/home?region=<region>#)
Open the devtools (Ctrl+Shift+I or inspect element)
Navigate to the Network panel
Search for console.aws.amazon.com/console/home?region and select the first matching requst with status code 200
Right click on the request and select Copy Value > Copy as cURL

To run the script:

cd into the root of this repo
Paste the cURL command into your terminal but do not run it
Replace the first word of the command, curl, with ./scripts/update.sh
Press return to run the script. The ./services.json file and the icons in ./icons/ will be updated

After the script finishes, you should log out of your AWS session and log back in to invalidate the session.

License

MIT License

b0o / aws-favicons-webextension Goto Github PK