An open API service indexing awesome lists of open source software.

https://github.com/benjaminlukeclark/doggify-firefox

A Firefox extension that lets you doggify your browsing experience
https://github.com/benjaminlukeclark/doggify-firefox

css dog dog-ceo-api doggos dogs firefox firefox-extension html html-css-javascript javascript

Last synced: about 1 month ago
JSON representation

A Firefox extension that lets you doggify your browsing experience

Awesome Lists containing this project

README

          

> ๐Ÿงช **Side Project | Experimental Demo**
> This Firefox extension, created circa 2019, brings a playful โ€œdoggifyโ€ twist to your browsing.
> Built for fun and experimentation โ€” not intended for production use.
> Fully functional, but unsupported and unmaintained.
>
> ๐Ÿถ Because sometimes, the internet just needs more dogs.

---

# ๐Ÿพ Doggify-Firefox

A whimsical Firefox WebExtension that transforms your browsing experience by adding dog-themed flair. Originally built as a weekend project to explore browser APIs, DOM manipulation, and WebExtension architecture.

---

## ๐Ÿง  Features

- ๐Ÿ• Replaces certain images and words on webpages with dog-themed equivalents
- โš™๏ธ Includes a configurable settings screen (via `about:addons`)
- ๐Ÿงฉ Built as a lightweight Firefox WebExtension
- ๐Ÿ” Live DOM manipulation using content scripts
- ๐ŸŒ Local development & distribution ready (signed `.xpi` support)

---

## ๐Ÿš€ Getting started

### 1. Clone the repo
```bash
git clone https://github.com/benjaminlukeclark/Doggify-Firefox.git
```

### 2. Load the extension in Firefox
1. Navigate to `about:debugging#/runtime/this-firefox`
2. Click **Load Temporary Add-on**
3. Select any file in the project directory (e.g., `manifest.json`)

---

## โš™๏ธ Configuration

After installing, visit `about:addons` and locate **Doggify**.
Click the **Preferences** button to open the settings screen.
You can adjust:

- Select a specific breed of dog to use when replacing images
- Choose how aggressively to โ€œdoggifyโ€ web pages

![Settings screen for Doggify](documentation/settings/Settings.PNG)

---

## ๐Ÿ’ก Example usage

Visit your favorite news or blog site with Doggify enabled.
Watch images get replaced with dog-themed equivalents.

![Original web page before Doggify](documentation/overview/NastyCades.PNG)

![Dog-themed transformation applied](documentation/overview/LovelyDoggos.PNG)

You can also manually โ€œdoggifyโ€ specific images via a context menu option.

![Before Doggify transformation](documentation/doggify/Doggify-me-pre.png)

![After Doggify transformation](documentation/doggify/Doggify-me-post.PNG)

---

## ๐Ÿ›  Tech stack

- JavaScript
- Firefox WebExtension APIs
- DOM manipulation

---

## ๐Ÿงช Status & notes

- ๐Ÿ”ธ Experimental and no longer maintained
- ๐Ÿ”ธ Created as a creative exercise โ€” no tests or CI/CD
- ๐Ÿ”ธ Still works in modern Firefox as of 2025

---

## ๐Ÿ“ฆ Project structure

```
Doggify-Firefox/
โ”œโ”€โ”€ icons/ # Extension icons
โ”œโ”€โ”€ scripts/ # Content and background scripts
โ”œโ”€โ”€ options.html # Settings/preferences screen
โ”œโ”€โ”€ manifest.json # Extension metadata
โ””โ”€โ”€ README.md
```

---

## ๐Ÿถ License

[MIT License](./LICENSE)

---

## ๐Ÿ“ฌ Contact

Made with ๐Ÿ’ป by [Benjamin Luke Clark](https://github.com/benjaminlukeclark)
See more projects at [sudoblark.com](https://sudoblark.com)

---

![status: experimental](https://img.shields.io/badge/status-experimental-orange)
![tech: WebExtension](https://img.shields.io/badge/tech-WebExtension-blue)