Skip to content

h4l/headgear

Repository files navigation

Headgear Banner

Headgear

Available in the Chrome Web Store      Available from Firefox Browser Add-Ons

Headgear makes it quick and easy to get high-quality images of your Reddit Avatar (NFT or regular). Copy & paste a clean image of your Avatar in two clicks from any Reddit page.

Headgear creates high-quality, resolution-independent images of Reddit Avatars using the original vector SVG images from Reddit's Avatar Builder. The results are sharper and more detailed than the Avatar images Reddit itself shows.

By owning an NFT Avatar, you have the right to use its images as you like. Headgear helps you make the most of your Avatar by giving you access to the best-possible quality images. You can create high-quality prints, images for other social media sites, or extract Avatar accessories to create image macros/memes or general mash-ups.

Screenshot of Headgear

Headgear is a browser extension that works in Chrome or Brave. Currently Headgear needs to be a browser extension rather than a separate website because the data it needs to create its images is not available from Reddit's public APIs. Headgear needs to use the internal APIs used by Reddit's own Avatar Builder and NFT shop.

Install

Never enter your Reddit Vault password in a browser that has extensions installed. See Headgear's security advice for more.

Chrome / Edge / Brave / Opera
Available in the Chrome Web Store
Firefox

Available from Firefox Browser Add-Ons

Headgear supports Firefox from version 109 onwards (the first version with Manifest V3 extension support).

Microsoft Edge
Edge can also install Headgear from the Chrome Web Store link above, but you need to explicitly allow Edge to use the Chrome Web Store. Edge will prompt you to enable it when you first visit. Microsoft has instructions here.
Safari
Safari can support Headgear, but Apple requires a $99/year Apple Developer Program membership to publish Safari extensions, so it's not practical to publish it with Apple.

Quickstart

  • After installing, open the Reddit website, then click Headgear under the Extensions toolbar item Screenshot of browser extensions toolbar menu

  • You can Pin Headgear to keep it on the toolbar

  • To uninstall Headgear, click Manage Extensions under the Extensions toolbar icon

Demo Video

A brief screencast demonstrating Headgear:

Headgear demo screencast

Background & Goals

Reddit's excellent Avatar Builder lets users to create customised avatars to represent themselves throughout Reddit. They have a Share Avatar feature that downloads a PNG image of moderate resolution (587 × 718 pixels) and no transparency.

Reddit recently launched Collectable Avatars — limited-edition Avatars that are NFTs which are owned by their holders, and can be re-sold or transferred to other users.

Project Goals

  • Enable Reddit users to access their Avatars in the best available quality
    • Initially this means SVG format, via the SVG assets used by the Reddit Avatar Builder
  • Decentralise Avatar assets and data:
    • So that Reddit Avatars are not lost if Reddit stops supporting them (see the previous Reddit Avatars)
    • To enable them to be used beyond Reddit
  • Be easy to use
  • Have fun

Contributing to & Developing Headgear

GitHub Workflow Status (with branch) GitPOAPs

See docs/contributing.md. And docs/developing.md for more technical info.