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,500 pre-populated keywords organized into 20+ smart categories, MuteSky makes content filtering both easy and effective.

🌟 Key Features

Instant Setup: Pre-populated with 1,500+ 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

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

📚 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

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

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.

License

potatoqualitee/mutesky

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages