Mutable

A web-based client for managing Nostr mute lists. Mutable allows users to back up, edit, discover, and share mute lists seamlessly. Features Mute-o-Scope, a powerful tool to search who is publicly muting any Nostr profile.

Features

Mute-o-Scope 🔍 NEW

Discover who is publicly muting any Nostr profile. Mute-o-Scope searches across public mute lists (kind:10000) to show you exactly who has muted a specific npub, complete with a color-coded Mute Score that indicates the profile's overall visibility on Nostr.

• No Login Required: Search any npub to see who is publicly muting them
• Real-time Profile Search: Dynamic profile search with autocomplete
• Mute Score System: Color-coded scoring system with 9 levels based on public mute list count
  • ⬜ Pristine (0) → 🟦 Low (1-25) → 🟩 Average (26-50) → 🟨 Moderate (51-75) → 🟧 High (76-100) → 🟥 Severe (101-200) → 🟪 Legendary (201-300) → 🟫 Shitlisted (301-400) → ⬛ Blacklisted (401+)
• Share Results: Share Mute-o-Scope results directly to Nostr
• Session-Aware: Uses your configured relays when signed in
• Profile Enrichment: View detailed profiles of who is muting whom

Personal Mute List Management (kind:10000)

• View & Edit: Fetch and display your current mute list with items organized into four categories:
  • Muted Pubkeys
  • Muted Words
  • Muted Tags (hashtags)
  • Muted Threads (event IDs)
• CRUD Operations: Add, edit, or delete entries in any category
• Publish: Sign and broadcast your updated mute list to Nostr relays

Backup & Restore

• JSON Export: Download your mute list as a portable .json file
• JSON Import: Restore a previously exported mute list
• Browser Storage: Save snapshots to localStorage for quick recovery

Public Mute Lists (kind:30001)

• Discovery: Search for public mute lists by creator npub or list name
• Subscribe: Copy public list contents into your personal mute list
• Create: Publish your own public mute lists for others to use

Advanced List Management Tools

• Muteuals: Discover users who have publicly muted you in their mute lists
• Reciprocals: Find users you follow who don't follow you back
• Decimator: Randomly remove a percentage of your follows to cull your list down to a manageable size
• Domain Purge: Find and remove all users with a specific NIP-05 domain from your follow list
• List Cleaner: Scan your mute list for inactive or abandoned profiles
• Note Nuke ☢️ NEW: Delete Nostr events across multiple relays with a single click

Multi-Device Sync via Relay Storage (NIP-78) ☁️ NEW

• Persistent Settings: Your protected users, blacklist, preferences, and imported packs are automatically synced to your Nostr relays
• Seamless Multi-Device: Access your data across all devices without manual backups
• Encrypted Storage: Sensitive data (protected users, blacklist) is encrypted using NIP-04
• Manual Sync: Trigger manual sync from Settings page
• Sync Status: View real-time sync status and last sync time

Purgatory 🔥 NEW

Find follows using specific Nostr clients or posting in hellthreads:

• Client Search: Find follows using specific apps (Damus, Primal, Amethyst, etc.)
• Hellthread Detection: Discover follows posting in conversation threads over a configurable size threshold
• NIP-65 Relay Discovery: Intelligent per-user relay lookup for comprehensive results
• Bulk Actions: Mute or unfollow multiple users at once

Snoopable 👀 NEW

Analyze public NIP-04 DM metadata to see who someone talks to most (without decrypting message content).

• DM Circle: Visualize top contacts in a shareable image
• Leaderboard + Heatmap: Rank frequent contacts and view activity timing
• Shareable Notes: Copy a ready-to-post note or publish directly to Nostr
• No Login Required: Analyze any npub using public relay data

Authentication

• NIP-07: Connect using browser extensions (Alby, nos2x)
• NIP-46: Connect with remote signers like Amber for enhanced key security
• Session Persistence: Automatic reconnection with signer restoration

Tech Stack

• Framework: Next.js 15 with App Router
• Language: TypeScript
• Styling: Tailwind CSS
• Nostr Library: nostr-tools
• State Management: Zustand with persistence
• Icons: lucide-react
• Deployment: Vercel

Getting Started

Prerequisites

• Node.js 18+ and npm
• A Nostr browser extension (Alby or nos2x) for authentication (optional - Mute-o-Scope works without login)

Installation

# Clone the repository
git clone https://github.com/dmnyc/mutable.git
cd mutable
# Install dependencies
npm install
# Run development server
npm run dev

Open http://localhost:3000 in your browser.

Build for Production

npm run build
npm start

Deployment

The app is configured for deployment on Vercel:

1. Push your code to GitHub
2. Import the project in Vercel
3. Deploy with default settings
4. Your app will be live at mutable.top

Project Structure

mutable/
├── app/ # Next.js app directory
│ ├── dashboard/ # Dashboard page
│ ├── mute-o-scope/ # Mute-o-Scope standalone page
│ ├── note-nuke/ # Note Nuke standalone page
│ ├── globals.css # Global styles
│ ├── layout.tsx # Root layout
│ └── page.tsx # Landing page
├── components/ # React components
│ ├── AuthModal.tsx # Authentication modal
│ ├── BackupRestore.tsx # Backup/restore functionality
│ ├── Backups.tsx # Backup management component
│ ├── CreatePublicList.tsx
│ ├── Decimator.tsx # Tool to aggressively filter mute lists
│ ├── DecimatorShareModal.tsx # Share options for Decimator results
│ ├── DomainPurge.tsx # Tool to remove users by NIP-05 domain
│ ├── Footer.tsx # Application footer
│ ├── GlobalUserSearch.tsx # Global search for Nostr profiles
│ ├── ImportConfirmationDialog.tsx
│ ├── ListCleaner.tsx # Tool to identify and remove inactive profiles
│ ├── Mute-o-Scope.tsx # Mute-o-Scope component
│ ├── MuteListCategory.tsx
│ ├── MuteScoreModal.tsx # Mute Score info modal
│ ├── Muteuals.tsx # Component to discover mutual mutes
│ ├── MyMuteList.tsx
│ ├── NoteNuke.tsx # Note Nuke component for event deletion
│ ├── NoteNukeSuccessModal.tsx # Success modal for event deletion
│ ├── NoteNukeWrapper.tsx # Wrapper with navigation for standalone route
│ ├── OnboardingModal.tsx # Onboarding flow for new users
│ ├── PrivacyControls.tsx
│ ├── PublicListCard.tsx
│ ├── PublicLists.tsx
│ ├── PublishSuccessModal.tsx # Success modal for publishing mute list
│ ├── Reciprocals.tsx # Component to find non-reciprocal follows
│ ├── Settings.tsx # User settings
│ ├── ShareResultsModal.tsx # Share results to Nostr
│ ├── UnsavedChangesBanner.tsx # Banner for unsaved changes notification
│ ├── UserProfileModal.tsx # User profile viewer with mute/unmute and reason input
│ └── UserSearchInput.tsx
├── hooks/ # Custom React hooks
│ ├── useAuth.ts # Authentication hook
│ └── useRelaySync.ts # Relay storage sync hook
├── lib/ # Library code
│ ├── nostr.ts # Nostr protocol functions
│ ├── store.ts # Zustand state management
│ ├── relayStorage.ts # NIP-78 relay storage implementation
│ ├── syncManager.ts # Sync coordination service
│ ├── protectionService.ts # Protected users management
│ ├── blacklistService.ts # Blacklist management
│ ├── preferencesService.ts # App preferences management
│ ├── importedPacksService.ts # Imported packs tracking
│ └── signers/ # Signer implementations
│ ├── types.ts # Signer interface
│ ├── Nip07Signer.ts # NIP-07 browser extension signer
│ ├── Nip46Signer.ts # NIP-46 remote signer
│ └── index.ts # Signer exports
├── types/ # TypeScript type definitions
│ └── index.ts
└── public/ # Static assets
├── mutable_logo.svg
├── mute_o_scope_icon.svg
└── plebs_vs_zombies_logo.svg

Usage

Mute-o-Scope

1. Search: Enter any npub, username, or hex pubkey
2. View Results: See who is publicly muting the searched profile
3. Check Score: Click the Mute Score badge to see all scoring levels
4. Share: Share results directly to Nostr with automatic tagging

Note Nuke

1. Paste: Enter a note ID or paste a direct note link
2. Preview: Review the note before deletion
3. Select Relays: Choose which relays to publish the deletion event to
4. Deploy: Broadcast deletion event to selected relays
5. Reason: Optionally add a reason for the deletion

Personal Mute List Management

1. Connect: Click "Connect with Nostr" and authorize with your NIP-07 extension
2. View Your List: See your current mute list organized by category
3. Edit: Add, remove, or modify muted items
4. Publish: Save changes to Nostr relays
5. Backup: Export your list or save to browser storage
6. Discover: Search for public lists created by other users
7. Share: Create and publish your own public mute lists

Nostr Event Kinds

• kind:10000: Personal mute list (replaceable event)
• kind:30001: Public/categorized mute list (parameterized replaceable event)
• kind:30078: Application-specific data (NIP-78) - used for relay storage sync
• kind:5: Delete event marker (for Note Nuke)
• kind:1: Text note (for sharing Mute-o-Scope results)

Relay Storage Implementation

Mutable implements NIP-78 (Application-specific Data) to sync your settings across devices:

Synced Data Types

1. Protected Users (d-tag: mutable:protected-users)

   • Users protected from the Decimator feature
   • Encrypted with NIP-04

2. Blacklist (d-tag: mutable:blacklist)

   • Pubkeys prevented from re-import (removed inactive profiles)
   • Encrypted with NIP-04

3. Preferences (d-tag: mutable:preferences)

   • Theme, onboarding status, and other app settings
   • Not encrypted (non-sensitive data)

4. Imported Packs (d-tag: mutable:imported-packs)

   • Tracking of which community packs have been imported
   • Not encrypted (tracking data)

How It Works

• Automatic Sync: Data syncs automatically on login and session restore
• Timestamp Resolution: Conflicts are resolved using timestamp (newest wins)
• Local Cache: localStorage serves as offline cache for quick access
• Manual Sync: Available in Settings for on-demand synchronization
• Encryption: Sensitive data encrypted to your own pubkey using NIP-04

Default Relays

Chosen by measuring how many mute lists each relay actually returns, so the list favors coverage over familiarity. Ordered by measured yield:

• wss://nos.lol
• wss://nostr21.com
• wss://relay.mostr.pub
• wss://nostr.mom
• wss://theforest.nostr1.com
• wss://relay.primal.net
• wss://relay.nostr.net
• wss://relay.snort.social
• wss://purplepag.es
• wss://nostr.land
• wss://relay.nostrplebs.com

purplepag.es is included for profile (kind:0) coverage rather than mute lists. relay.damus.io is intentionally excluded — it is being deprecated, and measured at only ~0.7% marginal coverage.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built for the Nostr protocol
• From the creator of Plebs vs. Zombies and Ghostr

Author

• Created by The Daniel⚡️
• Vibed mostly with Claude and a bit with Gemini