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.

• Install Firefox Add-on
• Install Chrome Extension

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:

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

To run the script:

1. cd into the root of this repo
2. Paste the cURL command into your terminal but do not run it
3. Replace the first word of the command, curl, with ./scripts/update.sh
4. 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

© 2022 Maddison Hellstrom

MIT License