AO3 OR-Tag Extension 🔀

Finally search AO3 with OR logic instead of AND!

Tired of getting zero results when you want to find fics with either "Harry Potter" or "Star Wars"? This extension lets you combine multiple tags with OR logic, so you can find all the crossovers, rare pairs, and trope combinations you've been missing.

---

✨ What It Does

When you select multiple tags on AO3, they normally work with AND logic (must have ALL tags). This extension adds an "Enable OR Mode" toggle that lets you search with OR logic instead (must have ANY of the tags).

Example

Without OR Mode:

• Select "Fluff" + "Angst" = Only fics tagged with BOTH (very few results)

With OR Mode:

• Select "Fluff" + "Angst" = Fics with EITHER tag (tons of results!)

Perfect for:

• 🎭 Finding fics with multiple tropes you like
• 👥 Searching for rare pairs across different fandoms
• 🌟 Discovering crossovers between your favorite series
• 📚 Exploring works with any of your favorite characters

---

📥 Installation

Chrome / Edge / Brave

Note: Chrome Web Store link coming soon! For now, install manually:

1. Download the latest release:

   • Go to Releases
   • Download ao3-or-tag-chrome.zip
   • Extract the ZIP file to a folder you'll keep (don't delete it!)

2. Open Extensions Page:

   • Chrome: Go to chrome://extensions/
   • Edge: Go to edge://extensions/
   • Brave: Go to brave://extensions/

3. Enable Developer Mode:

   • Toggle the switch in the top-right corner

4. Load the Extension:

   • Click "Load unpacked"
   • Select the folder where you extracted the ZIP

5. Done! The extension is now active on AO3

Firefox

Note: Firefox Add-ons link coming soon! For now, install manually:

1. Download the latest release:

   • Go to Releases
   • Download ao3-or-tag-firefox.zip

2. Install Temporarily:

   • Open Firefox and go to about:debugging#/runtime/this-firefox
   • Click "Load Temporary Add-on"
   • Select the ao3-or-tag-firefox.zip file

3. Done! The extension works until you restart Firefox

⚠️ Note: Firefox requires extensions to be signed for permanent installation. We're working on getting this published to the Firefox Add-ons store!

---

🎯 How to Use

1. Go to AO3 and navigate to any works page (browse by fandom, tag, etc.)

2. Look for the toggle in the filter sidebar:

   ☐ Enable OR Mode
   Combine selected filters with OR logic.
   

3. Check the box to enable OR mode

4. Add your tags using either:

   • The "Other tags to include" search box (type and select)
   • Checkbox filters in the sidebar

5. Click "Sort and Filter"

6. Enjoy your results! You'll see works with ANY of your selected tags

💡 Pro Tips

• Mix and match: Select tags from different categories (characters, tropes, fandoms)
• Combine with filters: OR mode works alongside ratings, word count, completion status, etc.
• Save your preferences: Go to the extension options to set default behavior
• Category control: Choose which tag types use OR logic (tropes, characters, relationships, fandoms)

---

⚙️ Settings

Click the extension icon in your browser toolbar to configure:

• Enable OR Mode by default - Automatically turn on OR mode when you visit AO3
• OR Logic Categories - Choose which tag types use OR logic:
  • ✅ Additional Tags (Tropes) - Default: ON
  • ☐ Characters - Default: OFF
  • ☐ Relationships - Default: OFF
  • ☐ Fandoms - Default: OFF

---

🤝 Support & Feedback

• Found a bug? Open an issue
• Have a suggestion? Start a discussion
• Want to contribute? See CONTRIBUTING.md

---

📜 Privacy

This extension:

• ✅ Only runs on archiveofourown.org
• ✅ Stores your preferences locally (never sent anywhere)
• ✅ Doesn't collect any data
• ✅ Doesn't track your browsing
• ✅ Is completely open source

---

🛠️ For Developers

Want to build from source or contribute? See DEVELOPMENT.md for:

• Local development setup
• Building the extension
• Testing changes
• Submitting pull requests

---

📄 License

MIT License - Free to use and modify!

---

⭐ Enjoying the Extension?

If this extension makes your AO3 experience better:

• ⭐ Star this repository
• 📢 Share it with fellow fans
• 💬 Leave feedback

Happy reading! 📚✨