Giter VIP home page Giter VIP logo

ulauncher-fzf's Introduction

Ulauncher Fuzzy Finder

Find files and directories in Ulauncher using fzf (and fd).

ulauncher-fzf preview

Requirements

  • Ulauncher
  • Python 3
  • fzf
  • fd

Features

  • Fuzzy searching for files, directories or both
  • Allow hidden files to be searched
  • Specify preferred number of results returned
  • Specify base directory to be searched
  • Ignore certain files and directories - you can do this by creating an ignore-file which follows the .gitignore format, then specify the path to ignore-file in the extension's settings.

Actions:

  • Click or press "Enter" to open
    • file with default application
    • directory in your file manager
  • Press "Alt+Enter" to open the directory in which the file is contained.
    If the path is a directory, this will be the same as pressing Enter

Development

You can use command runners make or just to run project-specific commands. Any make target can also be run with just. E.g., make dev or just dev

  1. Clone repository

    git clone https://github.com/hillaryychan/ulauncher-fzf.git
  2. (Optional) Install developer dependencies.
    This is used to install dependencies for running lint and lint-fix. It will require Python 3.10 and poetry.

    make setup
  3. Create a symlink to the Ulauncher extensions directory

    make link
  4. Stop Ulauncher

  5. Run Ulauncher with no extensions and logging enabled

    make dev
  6. In a separate terminal, run ulauncher-fzf.
    The command to run the extension should be visible in the logging for Step 4. It should look like this:

    VERBOSE=1 ULAUNCHER_WS_API=ws://127.0.0.1:5050/ulauncher-demo PYTHONPATH=/home/username/projects/ulauncher /usr/bin/python /home/username/.local/share/ulauncher/extensions/ulauncher-demo/main.py

Full list of targets for the command runners:

  • setup - install developer dependencies
  • lint - run code linters
  • format-check - run code formatter checks
  • format - run code formatters
  • link - create symlink to Ulauncher extensions directory
  • unlink - remove symlink created by link
  • start - run Ulauncher with logging enabled
  • dev - run Ulauncher with no extensions and logging enabled

Contributing

All contributions are welcome. Raise an issue or open a pull request.

License

This source code is licensed under the MIT license.

ulauncher-fzf's People

Contributors

friday avatar hillaryychan avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.