MuteSky - Bulk manage Bluesky mutes with pre-populated keyword lists

MuteSky is a web app that gives you granular control over what appears in your Bluesky feed through curated keyword collections. Working directly with Bluesky's native mute system, it provides an intuitive interface to filter out content you'd rather not see. With over 1,400 pre-populated keywords organized into 20+ smart categories, MuteSky makes content filtering both easy and effective.

 

🌟 Key Features

• Instant Setup: Pre-populated with 1,400+ keywords, continuously updated by AI to reflect current events
• Smart Categories: 20+ organized topic groups covering:
  • Political Discord
  • Violence & Security
  • Social Issues
  • Global Affairs
  • Healthcare
  • Economy
  • Environment
  • Religion
  • New Developments
• Two Ways to Filter:
  • Simple Mode: Quick topic-based filtering with 4 strength levels
  • Advanced Mode: Fine-tune individual keywords
• Smart Search: Filter keywords to find related terms, then enable/disable them all at once or individually
• Real-Time: Changes hit your feed instantly
• Zero Storage: Works directly with Bluesky's mute system - we never store your data
• Performance Optimized: Smart warnings when approaching Bluesky's performance thresholds

🖼️ Screenshots

Simple Mode

Advanced Mode

Smart Search

🚀 Get Started

1. Visit mutesky.app
2. Sign in with your Bluesky account (ex. username.bsky.social)
3. Pick your topics or dive into keyword management
4. Click "Mute" to apply changes

📚 Documentation

Comprehensive documentation is available in the docs directory:

User Guides

• Understanding Modes - Learn when to use Simple vs Advanced mode
• Muting Explained - How muting works with Bluesky
• State Persistence - Understanding saved changes

Architecture

• Core Concepts - System overview and state management
• Authentication - OAuth and session handling
• Muting System - Keyword management and API integration
• Mode System - Simple/Advanced mode implementation
• Performance - Core optimizations
• Click Performance - UI responsiveness

Development

• Known Issues - Common problems and solutions
• Troubleshooting Guide - Debug common issues

👩‍💻 Developer Quick Start

Tech Stack

• Frontend: Vanilla JavaScript with Web Components
• Integration: Bluesky/ATP API
• Deployment: GitHub Pages
• Build: Webpack

Key Technical Features

1. State Management:

   • Centralized state object
   • Local storage persistence
   • Error recovery system
   • Event-driven updates

2. Performance Optimization:

   • Critical CSS loading
   • Debounced updates
   • Cached calculations
   • Smart keyword thresholds

3. Security & Privacy:

   • Direct Bluesky auth integration
   • Zero data storage
   • Secure credential handling
   • Non-destructive operations

Local Development

# Install dependencies
npm install

# Start dev server
npm run dev

# Create production build
npm run build

🔗 Related Projects

Check out US Politician Labeler

And the Calm the Chaos Browser extension

🔮 Coming Soon

AI-powered dynamic keyword updates: An optional service that automatically identifies and updates mute keywords hourly based on emerging trends and topics.