- Blazing fast search: Indexes folders you specify, cataloging files and subdirectories matching your specified filters
- Globally available via a user-configurable hotkey
- Learns your preferences, bringing previously-opened files and applications to the top of search results
You can install Canaveral in (at least) two different ways, depending on your needs:
- Install in an isolated virtual environment from PyPI via
pipx
. This path is generally recommended for normal usage. - Create your own virtual environment, clone the Canaveral git repo, and install Canaveral in 'dev mode' with
pip install -e
(also known as 'editable' mode). This path is recommended for development.
- Install pipx first, if you don't already have pipx installed. Simply run the following commands at the terminal:
python -m pip install --user pipx
python -m pipx ensurepath
-
After installing
pipx
, you'll need to log out and log back in so that it will be added to your path. -
Use
pipx
to install Canaveral from PyPI.pipx
will automatically create an isolated virtual environment and install Canaveral into it from PyPI:
pipx install canaveral
- Create a virtual environment and activate it. If you're choosing this path, we'll assume you already know how to do this.
- Install Canaveral into the virtual environment in 'editable' mode by running the following command from the canaveral source directory (where setup.py is located):
pip install -e .
- If you've installed Canaveral into your own virtual environment, you'll need to activate it first. You can skip this step if you installed Canaveral via
pipx
. - Run from the command line:
canaveral
. - Canaveral looks in %APPDATA%\Canaveral for a file called paths.py that defines the locations and extensions it should index. The first time you run Canaveral, this directory is created and a paths.py with the default search locations will be placed there. Modify this file to suit your needs and save it in place, as paths.py.
- Bring up the Canaveral window with the
Ctrl+Alt+Space
hotkey. - Start typing your search.
- Select your desired entry from the drop-down list (via keyboard or mouse) and press enter. If no entry is selected, the first item in the list will be launched (so there's no need to select it).
- As you search for items and launch them, Canaveral will remember your choices and place the launched items at the top of the results for relevant searches.
- If you are interested in developing Canaveral and have installed it via the
pip install -e .
method above, you can directly launch Canaveral from its source directory by activating the virtual environment and then running themain.py
file directly:
python main.py
- You can also launch Canaveral from a Windows shortcut if you put the full path to the virtual environment's python location and to main.py as the Target, and the Canaveral directory as the working directory (the 'Start In' location). If you put this shortcut in your Startup directory, it will launch Canaveral on Windows startup.
- First public release