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.
- 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
- Visit mutesky.app
- Sign in with your Bluesky account (ex. username.bsky.social)
- Pick your topics or dive into keyword management
- Click "Mute" to apply changes
Comprehensive documentation is available in the docs directory:
- Understanding Modes - Learn when to use Simple vs Advanced mode
- Muting Explained - How muting works with Bluesky
- State Persistence - Understanding saved changes
- 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
- Known Issues - Common problems and solutions
- Troubleshooting Guide - Debug common issues
- Frontend: Vanilla JavaScript with Web Components
- Integration: Bluesky/ATP API
- Deployment: GitHub Pages
- Build: Webpack
-
State Management:
- Centralized state object
- Local storage persistence
- Error recovery system
- Event-driven updates
-
Performance Optimization:
- Critical CSS loading
- Debounced updates
- Cached calculations
- Smart keyword thresholds
-
Security & Privacy:
- Direct Bluesky auth integration
- Zero data storage
- Secure credential handling
- Non-destructive operations
# Install dependencies
npm install
# Start dev server
npm run dev
# Create production build
npm run buildCheck out US Politician Labeler
And the Calm the Chaos Browser extension
AI-powered dynamic keyword updates: An optional service that automatically identifies and updates mute keywords hourly based on emerging trends and topics.