Quickly find and open applications and files
Project description
Canaveral: Quickly find and open applications and files
- 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
Installation
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.
Installation via pipx
- 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
Installation via pip
from a local copy of the repo, in 'editable' mode
- 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 .
Running Canaveral
- 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.
Alternate ways to launch Canaveral
- 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.
Releases
0.1.0: 2021-09-28
- First public release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
canaveral-0.1.0.tar.gz
(54.3 kB
view details)
Built Distribution
canaveral-0.1.0-py3-none-any.whl
(254.0 kB
view details)