GitLocker: The Coding Marketplace

Description:

fastcd 1.3.3

Fastcd allows you to navigate quickly to the desired directory that has been visited recently.

Features

Autocomplete
Fuzzy search
Shortcuts for directories
Flexible configuration

Usage
Just enter j in the terminal to launch fastcd’s jumper.
Fastcd’s jumper shows last visited directories and allows you to change cwd quickly.
Start typing to filter directories.
You can use arrows and Page Up/Down to navigate the list.
Control:
'Esc', 'F10' or 'Meta + q' to exit.
'Enter' to change directory to the selected.
'Meta + Enter' to change directory to the entered.
'Tab' for auto completion. If entered path is not valid it will be extended.
'Shift + Tab' to paste selected path.
'Ctrl + w' or 'Ctrl + u' to clean up input.
'Meta + Backspace' to remove word.
'Ctrl + c' to copy selected path to clipboard (pygtk support required).
Search:
'Meta + f' to turn on/off fuzzy search.
'Meta + r' to change search position (any pos / from the beginning of the directory name).
'Meta + s' to turn on/off case sensitive search.
'Meta + l' to move search forward.
'Meta + b' to move search backward.
Shortcuts:
'Shift + F2', 'Shift + F3', 'Shift + F4' or 'Shift + F5' to set selected path as shortcut.
'F2', 'F3', 'F4' or 'F5' to paste shortcut path.
Supported extra symbols:
* - any number of any character
$ - end of the line
Extra options and parameters can be found in fastcd/config.json.
Meta is usually stands for alt key.

Examples

Tips
Missing or non-existent directories will be displayed dimmed and marked with *.
However, if you press Enter twice, you will cd to the nearest existing directory.
If the entered path is not present in the database, but exists, you will still be able to go into it.
If you want to redefine shortcuts (~/.local/share/fastcd/config.json), but don’t know their key codes - use key_picker.py.
You can change palette in ~/.local/share/fastcd/config.json.
Your current path in shell will be first in list,
while the previous path (OLDPWD) will be the second.
Previous path is selected by default.
Thus fastcd (j) + enter is equivalent to cd -.
Type j -l to list shortcuts and directories to which they point.
If you want to change directory immediately when pressing path shortcut (F2-F8) - change exit_after_path_shortcut_pressed to 1 in config.json

Supported platforms

Linux
MacOs

Installation

Get the utility: sudo python3 -m pip install fastcd or python3 -m pip install fastcd --user
Install shell hook to make fastcd able to track visited directories: python3 -m fastcd install.
Restart console session or run source ~/.bashrc to apply changes.
Type j and press enter to run fastcd.

If you would like to install another alias name for fastcd use:
python3 -m fastcd install --alias=fcd

Installation from source code
Get source code:
cd $HOME
git clone https://github.com/frazenshtein/fastcd
Each user who wants to use fastcd should install shell hook first:
python3 fastcd/fastcd/__main__.py install
source ~/.bashrc
Utility requires python 3 + extra module:
sudo python3 -m pip install urwid
If you do not have pip try first:
sudo apt-get install python3-pip