Skip to content

shenzhuoyan/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

Kooha-2023-10-21-19-25-36.gif

我做了什么

  • 可以多个搜索目录
  • 可以多个关键词来联合筛选文件
  • 添加是否包含隐藏文件的开关

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

手动安装

下载、解压,然后将文件夹 ulauncher-file-search-master 复制到 ~/.local/share/ulauncher/extensions,没有这个目录的话需要先创建

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 89.6%
  • Makefile 10.4%