https://github.com/h4l/headgear
Unleash your Reddit Avatar.
https://github.com/h4l/headgear
browser-extension chrome-extension firefox-addon firefox-extension nfts reddit webextension
Last synced: 5 months ago
JSON representation
Unleash your Reddit Avatar.
- Host: GitHub
- URL: https://github.com/h4l/headgear
- Owner: h4l
- License: other
- Created: 2022-10-13T18:19:58.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-19T06:41:05.000Z (6 months ago)
- Last Synced: 2025-04-24T06:15:43.595Z (5 months ago)
- Topics: browser-extension, chrome-extension, firefox-addon, firefox-extension, nfts, reddit, webextension
- Language: TypeScript
- Homepage:
- Size: 6.65 MB
- Stars: 10
- Watchers: 3
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing.md
- License: LICENSE
- Security: docs/security.md
Awesome Lists containing this project
README
# Headgear
[](https://chrome.google.com/webstore/detail/headgear/enohpjpndpodijgkfibkcpfdchjhfljp)
[](https://addons.mozilla.org/en-GB/firefox/addon/headgear/)
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.
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](./docs/security.md) for more.
- Chrome / Edge / Brave / Opera
-
- Firefox
-
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
- 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:
[](https://www.youtube.com/watch?v=mOUus4B1EZA "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.
[avatar builder]:
https://www.reddit.com/r/snoovatars/comments/jipi5d/announcing_reddits_new_avatar_builder/
[share avatar]:
https://www.reddit.com/r/snoovatars/comments/oh2v6o/share_and_swap_avatar_looks_with_the_reddit/
[collectable avatars]:
https://www.reddit.com/r/reddit/comments/vtkmni/introducing_collectible_avatars/
### 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][snoovatars])
- To enable them to be used beyond Reddit
- Be easy to use
- Have fun
[snoovatars]:
https://venturebeat.com/business/reddit-now-lets-you-make-your-own-snoo-avatar-adds-two-new-features/
## Contributing to & Developing Headgear
[](https://github.com/h4l/headgear/actions)
[][git-poap]
[git-poap]: https://www.gitpoap.io/gh/h4l/headgear
See [docs/contributing.md](docs/contributing.md). And
[docs/developing.md](docs/developing.md) for more technical info.