File-Find for macOS

A macOS UI Utility that helps you find Files easier.

Content

• Features
• FAQ
• Download
• Running from Source
• Roadmap

Features

• Choose Filter which Files to include:

  • Name
  • In Name
  • File Ending
  • Search in System Files
  • Directory to search in
  • File Size
  • Search for Folders
  • Fn-match (Unix shell-style wildcards)
  • Search for File Content
  • Date Created and Modified

• Exclude Folders

• Search for Files and export Searches

• Dark-mode

• Choose options for Files:

  • Show in Finder
  • Open
  • Copy Path/File

• Sort Results:

  • Size
  • File Name
  • Date Modified
  • Date Created

• Reverse Results

• Generate Terminal command from Filters, supports:

  • Name
  • In Name
  • File Ending

FAQ

Q: What is File-Find and how does it work?

A: File-Find is an open-source macOS Utility, that makes it easy to find Files. To search fill in the filters you need and leave the filters you don't need empty.

Q: Why does File-Find crash when searching?

A: File-Find is only using one thread. That's why it looks like File-Find "doesn't react".

Q: How to clean the Cache?

A: File-Find is saving the cache under /Users/USERNAME/Library/Application Support/File-Find/Cached Searches. The Cache gets cleaned up on start up, that means to clean the cache just restart File Find

Download

File FInd isn't ready for Release yet Run from source or download pre-build macOS Apps from the GitHub action Page.

• Running from Source
• GitHub Action Page

Running from Source

Note:

File Find won't work properly on Linux or Windows, because the UI displays different depending on the OS and some Features depends on the system.

Dependencies

• Python 3.9 or higher
• Pyperclip 1.8.2 or higher
• PyQt 6 6.4 or higher

1. Install Python:

   Download the installer: https://python.org/download or use

   Homebrew: brew install python@3.11

2. Install pyperclip with pip: pip3 install pyperclip

3. Install PyQt 6 with pip: pip3 install PyQt6

Running

1. Clone the File-Find Repository: git clone https://gitlab.com/Pixel-Mqster/File-Find.git
2. cd into the repository: cd File-Find
3. Install dependencies
4. Run:

python3 File-Find.py

Roadmap

1. UI:
   1. Filter UI
   2. Help UI
   3. Search Result UI
2. Exporting and Importing Searches:
   1. Importing
   2. Exporting
3. Caching:
   1. Creating Caches
   2. Using Caches
   3. Deleting Caches
   4. Clear Cache option
4. Multithreading:
   1. UI using different thread as Search engine
   2. Searching trough different threads
   3. Indexing trough different threads
5. Sorting:
   1. Size
   2. File Name
   3. Modified
   4. Created
   5. Reverse
6. Searching:
   1. Name
   2. In Name
   3. File Ending
   4. Search in System Files
   5. Directory to search in
   6. Search for Folders
   7. Search for Alias
   8. Exclude Sub-folders
   9. Contains
   10. Search with root privileges
   11. Regex (used fn match instead (Unix shell-style wildcards))
   12. Date Modified
   13. Date Created
   14. Excluded Files
7. Language
   1. Language UI
   2. Languages apply
   3. Languages:
      1. English
      2. German
      3. Frensh
      4. Spanish
      5. Chinese
8. Compatible with Linux and Windows?