You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 4-6.RSVP
Socket
Book a DemoInstallSign in
Socket

justduh

Package Overview
Dependencies
Maintainers
1
Versions
5
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

justduh

A deceptively simple floating desktop button that sits quietly on your screen, always accessible with a single click.

1.0.4
latest
Source
npmnpm
Version published
Weekly downloads
361
Maintainers
1
Weekly downloads
 
Created
Source

just duh.

The deceptively simple floating button that could change everything.

npm version npm downloads

Quick Start

Get just duh up and running in seconds:

# Install globally
npm install -g justduh

# Run it
justduh

Or try it instantly without installing:

# Run with npx (no installation needed)
npx justduh

What is this?

just duh is a minimalist floating desktop button that sits quietly on your screen, always accessible, always ready. On the surface, it's just a button that says "duh." But beneath that simplicity lies the potential for something much more powerful.

"The best interfaces are invisible until you need them."

Current Features

🎯 The Button

  • Always on top: Stays visible across all applications and workspaces
  • Draggable: Position it anywhere on your screen
  • Persistent: Remembers its position and stays there
  • Cross-platform: Works on macOS, Windows, and Linux

🔒 Hidden Powers

The button has secret functionality that only reveals itself when you know how to unlock it:

  • Single click: Increments an internal counter (tracking your "duh" moments)
  • Shift + click: Opens a hidden control panel with stats and controls
  • ESC + click: Closes the application entirely

🎛️ Control Panel

Access the hidden control panel with Shift + click to reveal:

  • Click counter display
  • Reset counter functionality
  • Application controls
  • More features coming soon...

Installation & Usage

# Install globally
npm install -g justduh

# Run from anywhere
justduh
# or
duh

⚡ Option 2: Run Without Installing

# Run instantly with npx
npx justduh

🛠️ Option 3: Development Setup

# Clone the repository
git clone https://github.com/yourusername/justduh.git
cd justduh

# Install dependencies
npm install

# Run in development mode
npm start

# Build for production
npm run build

How to Use

  • Launch the app: The button appears on your desktop
  • Position it: Drag it to your preferred location
  • Start clicking: Each click tracks your "duh" moments
  • Discover secrets: Try different key combinations
  • Access controls: Shift + click for the control panel

The Vision

just duh is designed to be the ultimate productivity companion that grows with you. Today it's a simple button, but tomorrow it could be:

🚀 Automation Hub

  • Quick Actions: Double-click to trigger your most-used automation
  • Script Launcher: Right-click menu with custom scripts and shortcuts
  • System Monitor: Visual indicators for CPU, memory, network status
  • Notification Center: Aggregate notifications from all your apps

🧠 AI Assistant

  • Voice Commands: "Hey duh, open my morning routine"
  • Smart Suggestions: Learn your patterns and suggest actions
  • Context Awareness: Know what you're working on and offer relevant tools
  • Natural Language: "duh, remind me to call mom in 2 hours"

🔗 Integration Platform

  • App Connections: Connect to Slack, Discord, email, calendar, todo apps
  • Webhook Support: Trigger external services with a simple click
  • Plugin System: Community-driven extensions and integrations
  • API Access: Let other apps interact with your duh button

🎨 Customization Engine

  • Themes: Change appearance based on mood, time of day, or system theme
  • Layouts: Multiple button arrangements for different workflows
  • Gestures: Swipe, hold, multi-touch interactions
  • Adaptive UI: Interface that changes based on context and usage

🔐 Privacy-First

  • Local Processing: All data stays on your device
  • Encrypted Settings: Your configurations are secure
  • No Tracking: We don't know what you're clicking
  • Open Source: Full transparency in how it works

Technical Details

  • Built with: Electron for cross-platform compatibility
  • Package size: Lightweight and fast to install
  • Window size: Minimal ~220x200px window
  • Performance: Minimal resource usage
  • Persistence: Remembers position and settings
  • Available on: npm

Roadmap

  • Phase 1: ✅ Basic floating button with hidden features
  • Phase 1.5: ✅ Published on npm for easy installation
  • Phase 2: 🔄 Plugin system and customization options
  • Phase 3: 🔮 AI integration and smart features
  • Phase 4: 🌟 Community marketplace and sharing

Troubleshooting

Permission Issues on macOS/Linux

If you get permission errors during installation:

# Set up npm to use a different directory
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Now install
npm install -g justduh

Electron Not Found

If you get "electron not found" errors:

# Try using npx instead
npx justduh

Philosophy

In a world of increasingly complex interfaces, sometimes the most powerful solution is the simplest one. just duh embraces the philosophy that the best tools are:

  • Invisible when you don't need them
  • Instant when you do need them
  • Intuitive without requiring explanation
  • Powerful without being overwhelming

Contributing

We believe the best ideas come from the community. Whether you want to:

  • Report a bug
  • Suggest a feature
  • Contribute code
  • Share your workflow

Visit us at justduh.com or open an issue here.

License

MIT License - Because good ideas should be free to grow.

"It's not just a button. It's a philosophy."

just duh - Making the complex simple, one click at a time.

Now available on npm: npm install -g justduh

Keywords

desktop

FAQs

Package last updated on 13 Jul 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts