Excel Search Engine is a lightweight desktop application built with Python and CustomTkinter that lets you search through large Excel and CSV files instantly without loading the full file into memory.

The application reads only the file header on open, then processes data in configurable chunks during search, keeping RAM usage flat even on million-row files. Results stream to the screen in real time as each chunk is processed, and the search can be cancelled at any moment.

Built with a clean dark UI and designed for non-technical users — no installation wizard, no browser, no server required. Just run and search.

Excel Search Engine is a lightweight desktop application built with Python and CustomTkinter that lets you search through large Excel and CSV files instantly without loading the full file into memory.

The application reads only the file header on open, then processes data in configurable chunks during search, keeping RAM usage flat even on million-row files. Results stream to the screen in real time as each chunk is processed, and the search can be cancelled at any moment.

Built with a clean dark UI and designed for non-technical users — no installation wizard, no browser, no server required. Just run and search.

- Python 3.8+
- Windows 10 / 11 (tested), macOS and Linux compatible
- No internet connection required
- No server or browser needed
- Install dependencies with: pip install -r requirements.txt

1. Make sure Python 3.8 or later is installed on your machine.

2. Install the required dependencies by running the following command
   in your terminal or command prompt:

   pip install -r requirements.txt

3. Launch the application by running:

   python main.py

4. Click "Open File" to load a CSV or Excel file (.csv, .xlsx, .xls).

5. Type the exact value you want to search for in the search box
   and press Enter or click the Search button.

6. Results will appear in the table live as each chunk is processed.

7. To stop the search before it finishes, click the Stop button.

8. To adjust how many rows are processed per batch,
   change the value in the Chunk field (default is 100,000).

9. To export the results, click Save as CSV, Save as XLSX,
   or Save as TXT at the bottom of the window.

10. To have the application remember and auto-reload your last
    opened file on next launch, check the Remember last file option.