Skip to content
This repository has been archived by the owner on Jun 5, 2021. It is now read-only.

brpaz/ulauncher-file-search

Repository files navigation

ulauncher-file-search

Quick Search files and directories from Ulauncher using fd.

Ulauncher Extension CI Status

GitHub license

Demo

demo

Requirements

  • Ulauncher 5+
  • Python 3+
  • fd - A simple, fast and user-friendly alternative to 'find'.

Install

Open ulauncher preferences window -> extensions -> add extension and paste the following url:

https://github.com/brpaz/ulauncher-file-search

Usage

This extension provides the following keywords:

  • fd -> Search files and directories
  • ff -> Search Files
  • fdir -> Search directories

To search, input one of the previous keywords to trigger the extension and start typing your search criteria. Ulauncher will call "fd" under the hood to perform your search and it will display a list of results.

Result items Actions

  • Press "Enter" - Open the file / folder using the default system action
  • Press "Alt+Enter" - On a folder, it will open the respective folder in a Terminal window.

Extension settings

  • Terminal Emulator -> Sets the terminal emulator to use when opening directories.
  • Base dir -> The base directory to start your searches. By detault, its the root folder "/" but you can set to your home directory, for example. Note, that only absolute paths are supported.

Development

git clone https://github.com/brpaz/ulauncher-file-search
make link

The make link command will symlink the cloned repo into the appropriate location on the ulauncher extensions folder.

Make sure Ulauncher is not running and from command line run:

ulauncher --no-extensions --dev -v |& grep "file-search"

This will start ulauncher with all the extensions disable which will make it easier to look for logs.

You then have to start the Circle CI extension manually. In the output of the previous command you should find something similar to this:

VERBOSE=1 ULAUNCHER_WS_API=ws://127.0.0.1:5054/file-search PYTHONPATH=/usr/lib/python3/dist-packages /usr/bin/python3 /home/bruno/.cache/ulauncher_cache/extensions/file-search/main.py

Copy and run that command in another terminal window.

Your extension should now be running. To see your changes, just Ctrl+C and re-run the last command.

Contributing

All contributions are welcome. Just open an issue and/or create a PR.

If you like my work, feel free to "Buy me a Coffee".

Buy Me A Coffee

Links

License

MIT © Bruno Paz

About

Quick Search files and directories from Ulauncher

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •