WhereWhat-BB 🔍

Precision File Search · Smart Multi-File Replace · High-Performance Refactoring

WhereWhat-BB is a high-performance, professional-grade desktop application designed for precision search and smart multi-file replacement. Built for developers, data analysts, and power users, it provides a fast, portable, and visually stunning alternative to standard system search tools.

---

✨ Why WhereWhat-BB?

If you've ever struggled to find a specific string across thousands of files or needed to refactor code across an entire project safely, WhereWhat-BB is built for you. It combines the power of raw system scanning with a premium modern GUI and thread-safe architecture.

🌟 Key Features

• 🚀 Optimized Search Engine: Implements time-based throttling (0.1s updates) to prevent UI hanging even when scanning massive drives with millions of files.
• 🛡️ Internal Progress Overlay: A custom-engineered internal frame overlay that provides real-time scan feedback without typical Windows Toplevel visibility bugs.
• 🖥️ HiDPI / 4K Native: Full DPI awareness integration for crystal clear rendering on high-resolution displays.
• 🏗️ Dual Architecture: Supports both 32-bit and 64-bit Windows binaries for maximum compatibility.
• 📐 Compact & Ergonomic: Redesigned UI header and results bar to maximize vertical space for search results.
• 📋 Exclusion Presets: One-click filters for Web Dev, Python Dev, and more to skip unnecessary folders like node_modules or venv.

---

🛠️ Features at a Glance

1. Advanced Search & Filter

• Multi-Tab Workflow: Independent tabs for File Search, Content Search (Inside text), and Search & Replace.
• RegEx & Exact Match: Full support for Regular Expressions and case-sensitive matching.
• Extension-only Mode: Quickly list all files of specific types without needing a search query.
• Metadata Filtering: Filter results by minimum file size (KB).

2. Developer-Focused Workflow

• Triple-Step Replace: Safe refactoring with a Preview -> Replace Selected -> Replace ALL workflow.
• Context Actions: Right-click to "Open File," "Show in Folder," or "Copy Full Path."
• Sorting: Multi-column sorting support for Name, Extension, Size, Date, and Path.

3. Premium UI/UX

• Warm Aesthetics: Eye-friendly color palette designed for long coding sessions.
• Taskbar Integration: Explicit AppUserModelID ensures the brand icon stays correctly pinned to the Windows taskbar.
• Tooltips: Every button and field features interactive guidance for ease of use.

---

🚀 Getting Started

📦 For Users (Windows)

1. Download the Latest Release
2. Choose the 64-bit (standard) or 32-bit executable based on your OS.
3. Double-click to launch!
   • Note: As the app is a standalone independent utility, you may need to click "More Info" -> "Run Anyway" if Windows SmartScreen alerts appear.

🛠️ For Developers

# Clone the repository
git clone https://github.com/beighbyte/WhereWhat-BB.git
cd WhereWhat-BB

# Set up environment
pip install -r requirements.txt

# Run directly
python src/main.py

# Build your own binaries
scripts\build.bat

---

🤝 Contributing

Contributions are welcome! Whether it's a bug fix, feature request, or documentation improvement, please check our Contribution Guidelines to get started.

---

👤 Credits & Links

Developed with ❤️ by Abrar Hussain Beigh (@beighbyte).

• 🌐 Portfolio/GitHub: github.com/beighbyte
• 📸 Instagram: @beighbyte
• 📺 YouTube: Beigh Byte Tutorials

Search Keywords (SEO)

Best File Search Tool Windows, Search and Replace in multiple files, Grep GUI for Windows, Find text in files, Developer search utility, Portable file search, Fast text search tool, 32-bit File Search, SSD Optimized Search, Multi-file refactoring tool.

---

© 2026 WhereWhat-BB. Precision Tooling for Modern Workflows.