https://github.com/jabbalaci/quickjump

QuickJump allows you to bookmark directories and switch between them easily
https://github.com/jabbalaci/quickjump

bash bookmark directories python python3 urlshortener zsh

Last synced: 8 months ago
JSON representation

QuickJump allows you to bookmark directories and switch between them easily

• Host: GitHub
• URL: https://github.com/jabbalaci/quickjump
• Owner: jabbalaci
• License: mit
• Created: 2019-06-30T09:41:45.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2024-04-02T13:19:37.000Z (about 2 years ago)
• Last Synced: 2024-04-16T00:08:41.842Z (about 2 years ago)
• Topics: bash, bookmark, directories, python, python3, urlshortener, zsh
• Language: Python
• Homepage:
• Size: 337 KB
• Stars: 10
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
QuickJump

=========

QuickJump allows you to bookmark directories and switch between them easily.

It's like a URL shortener but it's designed for your local machine.

Supported platforms

-------------------

I tried it under Linux only. It works with Bash, ZSH and Fish shell too. I think it should also work under Mac OS.

Demo

----

![QuickJump in action](demo/demo.gif)

Motivation

----------

When I work on a project, there are about 5 directories that I visit very often

and I change a lot between them. Sometimes, switching between folders takes

several seconds because I forget where they are precisely. QuickJump lets me

change between directories with the speed of light :)

Installation

------------

* Copy `quickjump.py` to somewhere.

* In `quickjump.py`, modify the value of `DB_FILE`. It contains

  the path of the database file that will be created.

* Add the content of `function.bash` / `function.zsh` to your shell's

  settings file (depending on what you use, Bash or ZSH). Modify the

  variable `QJ` to point on `quickjump.py`.

* If you have Fish shell, read the comments in `function.fish`.

* Open a new terminal and issue the command `qj`. If the database file

  doesn't exist, an empty database file will be created automatically.

Notes

-----

QuickJump generates a hash for a directory, it'll be the bookmark. Of course,

you can change it by editing the database file (`quickjump.json`) manually.

Just make sure that all bookmarks are unique. The software generates 3 characters

long bookmarks but you can use shorter / longer bookmarks if you want.