Skip to main content

Quickly find and open applications and files

Project description

Canaveral: Quickly find and open applications and files

Canaveral logo

  • 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:

  1. Install in an isolated virtual environment from PyPI via pipx. This path is generally recommended for normal usage.
  2. 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

  1. 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
  1. After installing pipx, you'll need to log out and log back in so that it will be added to your path.

  2. 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

  1. Create a virtual environment and activate it. If you're choosing this path, we'll assume you already know how to do this.
  2. 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

  1. 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.
  2. Run from the command line: canaveral.
  3. 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.
  4. Bring up the Canaveral window with the Ctrl+Alt+Space hotkey.
  5. Start typing your search.
  6. 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).
  7. 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

  1. 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 the main.py file directly:
python main.py
  1. 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


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)

Uploaded Source

Built Distribution

canaveral-0.1.0-py3-none-any.whl (254.0 kB view details)

Uploaded Python 3

File details

Details for the file canaveral-0.1.0.tar.gz.

File metadata

  • Download URL: canaveral-0.1.0.tar.gz
  • Upload date:
  • Size: 54.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.6

File hashes

Hashes for canaveral-0.1.0.tar.gz
Algorithm Hash digest
SHA256 9cf5856ef678cebb162fd1521098edab052468f9bc3f650019a68d08617dcc46
MD5 a6d925e82aeafc3f5b99e049be566537
BLAKE2b-256 1c910bdb0b7a9f20e3312bace064aa44a7aaaa3da2e96104396e4fe8cbfac012

See more details on using hashes here.

File details

Details for the file canaveral-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: canaveral-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 254.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.6

File hashes

Hashes for canaveral-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 43164bde24793501e5a9c3f542a0aa532049d0427b418d95c8a6dae7d2f317ab
MD5 aa1d35925a89d99ff7d58a8ebb0ce551
BLAKE2b-256 369cfc2387671d3ecaf91f538586982a0eaea672d644667e1f8f2443b7bddbfa

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page