{"id":13468503,"url":"https://github.com/fdw/ranger-autojump","last_synced_at":"2025-03-26T05:31:09.796Z","repository":{"id":34121073,"uuid":"160048346","full_name":"fdw/ranger-autojump","owner":"fdw","description":"The combined magic of autojump, ranger and zsh","archived":false,"fork":false,"pushed_at":"2024-02-26T12:47:08.000Z","size":12,"stargazers_count":72,"open_issues_count":1,"forks_count":9,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-29T22:56:32.887Z","etag":null,"topics":["autojump","hacktoberfest","ranger","ranger-plugin","zsh","zsh-plugin"],"latest_commit_sha":null,"homepage":"","language":"Python","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/fdw.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}},"created_at":"2018-12-02T13:08:19.000Z","updated_at":"2024-08-02T14:21:50.000Z","dependencies_parsed_at":"2024-10-29T21:33:16.560Z","dependency_job_id":null,"html_url":"https://github.com/fdw/ranger-autojump","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdw%2Franger-autojump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdw%2Franger-autojump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdw%2Franger-autojump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdw%2Franger-autojump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fdw","download_url":"https://codeload.github.com/fdw/ranger-autojump/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245597240,"owners_count":20641861,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["autojump","hacktoberfest","ranger","ranger-plugin","zsh","zsh-plugin"],"created_at":"2024-07-31T15:01:12.413Z","updated_at":"2025-03-26T05:31:09.182Z","avatar_url":"https://github.com/fdw.png","language":"Python","funding_links":[],"categories":["Python","Plugins"],"sub_categories":["ZSH on Windows"],"readme":"# Ranger \u0026 Autojump\n\nThis plugin for ranger adds complete support for [autojump](https://github.com/wting/autojump) to [ranger](https://github.com/ranger/ranger):\nWhenever a new directory is opened in ranger, autojump is notified and can change the weights accordingly.\nUsing `:j` you can use autojump to jump to a directory. This is made even better by adding `map cj console j%space` to your `rc.conf`. Thus typing `cj dirname` will let you jump to dirname.\n\nAs an added bonus, there is a zsh plugin introducing a new function called `r`. Without arguments, it just opens ranger. If you supply an argument that is a directory, ranger is opened in that directory. But if you supply anything else as an argument, `autojump` is called with the argument and `ranger` is opened there 🧙\n\nIf you want similar functionality for [zoxide](https://github.com/ajeetdsouza/zoxide), you can try [ranger-zoxide](https://github.com/fdw/ranger-zoxide).\n\n# Maintenance Mode\nAs autojump seems to be unmaintained and there's not really any features missing, this repo exists as-is. I will still look at PRs and issues, but don't expect too much.\n\nIf you want similar functionality for [zoxide](https://github.com/ajeetdsouza/zoxide), you can try [ranger-zoxide](https://github.com/fdw/ranger-zoxide).\n\n# Installation\n### Ranger plugin\n- Copy `autojump.py` to `${XDG_CONFIG_HOME}/ranger/plugins`.\n- Add the following mapping to your `rc.conf` for convenience:\n\t```\n\tmap cj console j%space\n\t```\n\n### vim plugin (optional extra)\n- To use autojump with vim, the [autojump.vim](https://github.com/trotter/autojump.vim) plugin can be installed. This can also be integrated with ZSH as shown below.\n\n### zsh plugin\n- Install the zsh plugin using your favorite plugin manager, e.g.:\n\t- [zgenom](https://github.com/jandamm/zgenom):\n\t\t-\t`zgenom load fdw/ranger_autojump`\n\t- [antigen](https://github.com/zsh-users/antigen):\n\t\t-\t`antigen bundle fdw/ranger_autojump@main`\n\t- [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh):\n\t\t1. Clone this repository into oh-my-zsh's plugin directory:\n\t\t\t```\n\t\t\tgit clone https://github.com/fdw/ranger-autojump ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/ranger-autojump\n\t\t\t```\n\t\t2. Activate the plugin in `~/.zshrc`:\n\t\t\t ```\n\t\t\t plugins=( [plugins...] ranger-autojump)\n\t\t\t ```\n- (Optional) For vim integration add the following convenience function to your .zshrc:\n```\nfunction jvim { file=\"$(AUTOJUMP_DATA_DIR=~/.autojump.vim/global autojump $@)\"; if [ -n \"$file\" ]; then vim \"$file\"; fi }\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffdw%2Franger-autojump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffdw%2Franger-autojump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffdw%2Franger-autojump/lists"}