mirror of
https://github.com/wting/autojump
synced 2024-10-27 20:34:07 +00:00
112 lines
2.9 KiB
ReStructuredText
112 lines
2.9 KiB
ReStructuredText
========
|
|
AUTOJUMP
|
|
========
|
|
|
|
----------------------------
|
|
A ``cd`` command that learns
|
|
----------------------------
|
|
|
|
One of the most used shell commands is ``cd``. A quick survey among my friends revealed that between 10 and 20% of all commands they type are actually ``cd`` commands! Unfortunately, jumping from one part of your system to another with ``cd`` requires to enter almost the full path, which isn't very practical and requires a lot of keystrokes.
|
|
|
|
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. You need to work a little bit before the database becomes useable. Once your database is reasonably complete, you can "jump" to a directory by typing::
|
|
|
|
j dirspec
|
|
|
|
where dirspec is a few characters of the directory you want to jump to. It will jump to the most used directory whose
|
|
name matches the pattern given in dirspec.
|
|
|
|
Autojump supports tab completion. Try it!
|
|
|
|
Pierre Gueth contributed a very nice applet for freedesktop desktops (Gnome/KDE/...). It is called "jumpapplet", try it!
|
|
|
|
Thanks to Simon Marache-Francisco's outstanding work, autojump now works perfectly with zsh.
|
|
|
|
Examples
|
|
========
|
|
|
|
::
|
|
|
|
j mp3
|
|
|
|
could jump to ``/home/gwb/my mp3 collection``, if that is the directory in which you keep your mp3s. ::
|
|
|
|
jumpstat</b>
|
|
|
|
will print out something in the lines of::
|
|
|
|
...
|
|
54.5: /home/shared/musique
|
|
60.0: /home/joel/workspace/coolstuff/glandu
|
|
83.0: /home/joel/workspace/abs_user/autojump
|
|
96.9: /home/joel/workspace/autojump
|
|
141.8: /home/joel/workspace/vv
|
|
161.7: /home/joel
|
|
Total key weight: 1077
|
|
|
|
The "key weight" reflects the amount of time you spend in a directory.
|
|
|
|
Author
|
|
======
|
|
|
|
Joel Schaerer (joel.schaerer (at) laposte.net)
|
|
Autojump applet written by Pierre Gueth
|
|
Zsh support: Simon Marache-Francisco
|
|
Install script written by Daniel Jackoway and others.
|
|
|
|
License
|
|
=======
|
|
|
|
autojump is distributed under the terms of the GPL, version 3.
|
|
|
|
Installation
|
|
============
|
|
|
|
Auto Installation
|
|
-----------------
|
|
|
|
run::
|
|
|
|
./install.sh
|
|
|
|
or::
|
|
|
|
./install.zsh
|
|
|
|
depending on your shell.
|
|
Enter your root password if it asks.
|
|
|
|
Add the line::
|
|
|
|
source /etc/profile
|
|
|
|
to ``~/.bashrc`` or ``~/.zshrc`` if it isn't already there.
|
|
|
|
Troubleshoot
|
|
------------
|
|
|
|
If the script fails, you may need to do::
|
|
|
|
chmod +x install.(z)sh
|
|
|
|
before the first step.
|
|
|
|
|
|
Manual installation of autojump is very simple: copy
|
|
|
|
- autojump to /usr/bin,
|
|
- autojump.sh to /etc/profile.d,
|
|
- autojump.1 to /usr/share/man/man1.
|
|
|
|
Make sure to source ``/etc/profile`` in your ``.bashrc`` or ``.zshrc`` ::
|
|
|
|
source /etc/profile
|
|
|
|
Packaging
|
|
=========
|
|
|
|
For now gcarrier and I have packaged autojump for Arch Linux. It is available in [community]. To install, type::
|
|
|
|
pacman -S autojump
|
|
|
|
I would be very interested by packages for other distros. If you think you can help me with the packaging, please contact me!
|