NAME ---- autojump - a faster way to navigate your filesystem SYNOPSIS -------- Jump to a previously visited directory 'foobar': j foo Show all database entries and their respective key weights: jumpstat DESCRIPTION ----------- autojump is a faster way to navigate your filesystem. It works by maintaining a database of the directories you use the most from the command line. The jumpstat command shows you the current contents of the database. Directories must be visited first before they can be jumped to. INSTALLATION ------------ ### REQUIREMENTS - Python v2.7+ or 3.2+ - Bash v4.0+ for tab completion If you are unable to update Python to a supported version, older versions of autojump can be [downloaded](https://github.com/joelthelion/autojump/downloads) and installed manually. - Python v2.6+ is supported by [release v19](https://github.com/downloads/joelthelion/autojump/autojump_v19.tar.gz). - Python v2.4+ is supported by [release v12](https://github.com/downloads/joelthelion/autojump/autojump_v12.tar.gz). ### AUTOMATIC INSTALLATION **Linux** autojump is included in the following distro repositories, please use relevant package management utilities to install (e.g. yum, apt-get, etc): - Debian\* testing/unstable, Ubuntu, Linux Mint - RedHat, Fedora, CentOS - ArchLinux - Gentoo - Frugalware - Slackware \* Requires manual activation for policy reasons, please see `/usr/share/doc/autojump/README.Debian`. **Mac** Homebrew is the recommended installation method for Mac OS X: brew install autojump MacPorts also available: port install autojump **Other** Please check the [Wiki](https://github.com/joelthelion/autojump/wiki) for an up to date listing of installation methods. ### MANUAL INSTALLATION Grab a copy of autojump: git clone git://github.com/joelthelion/autojump.git Run the installation script: cd autojump ./install.sh [ --local ] [ --zsh ] and follow on screen instructions. ### MANUAL UNINSTALLATION It is recommended to use your distribution's relevant package management utilities, unless you installed manually or ran into uninstallation issues. Grab a copy of autojump: git clone git://github.com/joelthelion/autojump.git Run the uninstallation script: cd autojump ./uninstall.sh and follow on screen instructions. If you keep getting `autojump: command not found` at the prompt, do:`unset PROMPT_COMMAND`. You can also restart your shell. OPTIONS ------- Options must be passed to 'autojump' and not the 'j' wrapper function. -a, --add DIR manually add path to database --preserve prevent key weight decay over time --stat show database entries and their key weights --version show version information and exit INTERNAL OPTIONS ---------------- -b, --bash enclose directory with quotes to prevent errors --complete used for tab completion ADVANCED USAGE -------------- - Prefer Symbolic Links Default behavior is to evaluate symbolic links into full paths as to reduce duplicate entries in the database. However, some users prefer a shorter working directory path in their shell prompt. To switch behavior to prefer symbolic links, export the following configuration in your \~/.bashrc: export AUTOJUMP_KEEP_SYMLINKS=1 - Change Directory Weight To manually change a directory's key weight, you can edit the file *$XDG\_DATA\_HOME/autojump/autojump.txt*. Each entry has two columns. The first is the key weight and the second is the path: 29.3383211216 /home/user/downloads All negative key weights are purged automatically. KNOWN ISSUES ------------ - zsh (bug \#86) Tab completion does not work. - jumpapplet (bug \#59) Does not work in Gnome 3 shell or LDXE. FILES ----- If installed locally, autojump is self-contained in *\~/.autojump/*. The database is stored in *$XDG\_DATA\_HOME/autojump/autojump.txt*. REPORTING BUGS -------------- For any issues please visit the following URL: *https://github.com/joelthelion/autojump/issues* THANKS ------ Special thanks goes out to: Pierre Gueth, Simon Marache-Francisco, Daniel Jackoway, and many others. AUTHORS ------- autojump was originally written by Joël Schaerer, and currently maintained by William Ting. COPYRIGHT --------- Copyright © 2012 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later . This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.