A fast and lightweight Python-based file search tool that scans directories and subdirectories for any file or folder containing your desired keyword.
- 🚀 Fast scanning using
os.scandir()and multithreading - 💡 Case-insensitive search for both files and folders
- 🧱 Custom search path support (default: current directory)
⚠️ Permission error handling — skips inaccessible directories safely- 📁 Optional save of results to a text file
- 🕒 Displays total search time and result count
Make sure you have Python 3.8+ installed on your system.
git clone https://github.com/ashkan0201/File_Finder.git
cd File_FinderNo extra libraries are required — this project uses only Python’s built-in modules.
Run the script directly from your terminal:
python file_finder.pyThen follow the prompts:
=============================================
⚡ Ultra Fast File Search Tool (Python) ⚡
=============================================
Search for: report
Search path (default: current folder):
If you press Enter without specifying a path, it will search in your current working directory.
You can also manually change the default path inside the code:
path = '/'Searching for 'config' in 'C:\Projects' ...
Found 12 results in 1.42 seconds:
[1] C:\Projects\App\config.json
[2] C:\Projects\Backend\old_config.txt
[3] C:\Projects\Docker\configs\main.yaml
...
You can optionally save the results:
Save results to file? (y/n): y
Results saved as search_results_config.txt
- Optimized file scanning via
os.scandir() - Thread-safe and non-blocking logic
- Lightweight and portable — no dependencies
Developed by: Ashkan Noroozi
If you find a bug or have an idea for improvement, feel free to open an issue or email me directly.