{"id":50807804,"url":"https://github.com/jabbalaci/qjump","last_synced_at":"2026-06-13T02:35:00.748Z","repository":{"id":358309750,"uuid":"1240730241","full_name":"jabbalaci/qjump","owner":"jabbalaci","description":"Bookmark directories on your local machine and switch between them easily","archived":false,"fork":false,"pushed_at":"2026-05-31T09:46:38.000Z","size":570,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-13T02:35:00.499Z","etag":null,"topics":["bash","bookmark","directories","fish","nim","shell","zsh"],"latest_commit_sha":null,"homepage":"","language":"Nim","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jabbalaci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-16T13:52:22.000Z","updated_at":"2026-06-06T23:45:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jabbalaci/qjump","commit_stats":null,"previous_names":["jabbalaci/qjump"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jabbalaci/qjump","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jabbalaci%2Fqjump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jabbalaci%2Fqjump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jabbalaci%2Fqjump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jabbalaci%2Fqjump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jabbalaci","download_url":"https://codeload.github.com/jabbalaci/qjump/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jabbalaci%2Fqjump/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34270414,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","bookmark","directories","fish","nim","shell","zsh"],"created_at":"2026-06-13T02:34:59.381Z","updated_at":"2026-06-13T02:35:00.732Z","avatar_url":"https://github.com/jabbalaci.png","language":"Nim","funding_links":[],"categories":[],"sub_categories":[],"readme":"QJump\n=====\n\nQJump (short for QuickJump) allows you to bookmark directories on your local machine and switch between them easily.\nIt's like a URL shortener but it's designed for your local machine.\n\nSupported platforms\n-------------------\n\nI tried it under Linux only. It works with Bash, ZSH and Fish shells (settings are included).\nI think it should also work under Mac OS.\n\nDemo\n----\n\n![QJump in action](demo/demo.gif)\n\nAfter the bookmark, you can also specify a substring\nand you'll be redirected to the first subdirectory\nwhose name contains this substring:\n\n```shell\n$ cd\n$ pwd\n/home/jabba\n\n$ qj nim\n$ pwd\n/home/jabba/Dropbox/nim\n\n$ cd\n$ pwd\n/home/jabba\n\n$ qj nim/26\n$ pwd\n/home/jabba/Dropbox/nim/Nim-2026\n```\n\nHere, only \"`nim`\" was present in the database. However,\n\"`nim/26`\" worked and the current directory was changed to \"`.../nim/Nim-2026`\".\n\nHelp\n----\n```text\nQJump 0.3.4 by Jabba Laci (jabba.laci@gmail.com), 2026\nhttps://github.com/jabbalaci/qjump\n\nUsage: qj [alias] [option]\n\nLocation of DB file: /home/jabba/Dropbox/qjump.txt\n\nProvide an alias (bookmark) or use one of these options:\n\n-h, --help          show this help\n-v, --version       version info\n-l, --list          show list of available aliases\n-d, --dead          list dead (non-existing) paths\n-a, --alive         list existing paths\n```\n\nMotivation\n----------\n\nDuring my daily work, there are some folders that I visit regularly.\nQJump lets me change directories with the speed of light :)\n\nInstallation\n------------\n\n* The program tries to read the environment variable\n  `DROPBOX`. If it exists, then the database file\n  will be created inside your Dropbox folder, thus\n  you'll get auto synchronization. If this env. variable\n  doesn't exist, then the database file will be created\n  in your HOME folder. When you ask the help (`--help`),\n  the location of the database file will be printed.\n* If you're not satisfied with these default values,\n  then modify the value of `DB_FILE` in the source code.\n  If you modify anything, don't forget to recompile the project (see the `Makefile`).\n* Add the content of `function.bash` / `function.zsh` / `function.fish` to your\n  shell's settings file (depending on what shell you use).\n  Modify the variable `QJ` to point to the binary `qjump` .\n* Open a new terminal and issue the command `qj`, which calls the shell function.\n  When you call `qj` for the first time and no database file exists yet,\n  then `qjump` will create a simple DB file that you can extend later.\n\nNotes\n-----\n\nQJump generates a hash for a directory, it'll be the bookmark. You are encouraged to change it by editing the database file (`qjump.txt`) manually.\nJust make sure that all bookmarks are unique.\nThe program generates 3-character-long bookmarks but you can use\nshorter / longer bookmarks if you want.\n\nLinks\n-----\n\n* [QuickJump](https://github.com/jabbalaci/quickjump) is the predecessor of this project,\n  written in Python. QJump (this project) is similar but it contains some improvements,\n  and since it's written in [Nim](https://nim-lang.org/) (a compiled language), it ships as a single binary.\n  QuickJump is retired; use QJump instead.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjabbalaci%2Fqjump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjabbalaci%2Fqjump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjabbalaci%2Fqjump/lists"}