{"id":13696583,"url":"https://github.com/laggardkernel/ranger-fzf-marks","last_synced_at":"2026-01-23T16:23:25.871Z","repository":{"id":103434799,"uuid":"187341390","full_name":"laggardkernel/ranger-fzf-marks","owner":"laggardkernel","description":"Ranger plugin to manage bookmarks with fzf","archived":false,"fork":false,"pushed_at":"2021-07-18T10:41:18.000Z","size":9,"stargazers_count":29,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-03T18:21:05.442Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/laggardkernel.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}},"created_at":"2019-05-18T09:55:03.000Z","updated_at":"2024-03-18T16:06:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"72ec87f6-210e-4855-a936-1776f060dcdc","html_url":"https://github.com/laggardkernel/ranger-fzf-marks","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laggardkernel%2Franger-fzf-marks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laggardkernel%2Franger-fzf-marks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laggardkernel%2Franger-fzf-marks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laggardkernel%2Franger-fzf-marks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/laggardkernel","download_url":"https://codeload.github.com/laggardkernel/ranger-fzf-marks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224369615,"owners_count":17299931,"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":[],"created_at":"2024-08-02T18:00:42.886Z","updated_at":"2026-01-23T16:23:25.841Z","avatar_url":"https://github.com/laggardkernel.png","language":"Python","funding_links":[],"categories":["Plugins"],"sub_categories":[],"readme":"# ranger-fzf-marks\n\n[![License: MIT][license icon]][license]\n\nA [ranger][ranger] plugin ported from [urbainvaes/fzf-marks][urbainvaes-fzf-marks].\nIt depends on command-line fuzzy finder [junegunn/fzf][junegunn-fzf].\n\n## Installation\n\nGit clone the plugin into ranger's plugin folder. (`ranger \u003e= 1.9.3`)\n\n```bash\ngit clone https://github.com/laggardkernel/ranger-fzf-marks.git ~/.config/ranger/plugins/fzf-marks\n```\n\nThen add key binding for bookmark jump in `rc.conf`.\n\n```bash\nmap \u003cC-g\u003e fzm\n```\n\n## Usage\n\nCommands:\n\n- `:fmark \u003cmarkname\u003e`, add a current dir as bookmark\n- `:fzm [\u003coptional-query-keyword\u003e]`, jump to a bookmark\n- `:dmark [\u003coptional-query-keyword\u003e]`, delete a bookmark\n\nBookmark jumping could be also be triggered with key binding like `\u003cC-g\u003e`.\n\nOther features like output colorization, custom fzf command are not implemented.\nThis plugin only ensure basic usage of bookmark with fzf support.\n\n## Settings\n\nCustomization is supported by environment variables.\n\n`FZF_MARKS_FILE`, same variable used in\n[urbainvaes/fzf-marks][urbainvaes-fzf-marks], defaults to `${HOME}/.fzf-marks`.\n\n`FZF_MARKS_CMD`, path to the `fzf` executable binary. You don't need this\nunless your `fzf` is not added in the `PATH`.\n\n`FZF_FZM_OPTS`, controls how command `fzm` (from this plugin) behave, defaults to\n`--cycle +m --ansi --bind=ctrl-o:accept,ctrl-t:toggle --select-1`.\n\n`FZF_DMARK_OPTS`, controls how command `dmark` (from this plugin) behave,\ndefaults to `--cycle -m --ansi --bind=ctrl-o:accept,ctrl-t:toggle`.\n(`dmark` only supports delete one mark at each time for now, that's why I use `-m`)\n\nBesides above `FZF_*` related settings, fzf's behavior is also controlled by\n`FZF_DEFAULT_OPTS`, which is an env from `fzf` itself. Read `man fzf` for\ndetail.\n\n## Layout\n\nThe default `fzf` layout `--layout=default` **display from the bottom of the screen**.\nFor anyone who like it to be display from the top to the bottom,\ntry `--reverse` and `--height`, `--min-height` to get what you want. e.g.\n\n```bash\nexport FZF_FZM_OPTS=\"--reverse --height 75% --min-height 30 --cycle +m --ansi --bind=ctrl-o:accept,ctrl-t:toggle --select-1\"\nexport FZF_DMARK_OPTS=\"--reverse --height 75% --min-height 30 --cycle -m --ansi --bind=ctrl-o:accept,ctrl-t:toggle\"\n```\n\n## TODO\n\n- [x] Custom storage support with `FZF_MARKS_FILE`\n- [ ] Delete action support in `:fzm`\n- [ ] Batch deletion support in `:dmark`\n- [x] Make `fmark`, `dmark` style customizable\n\n## License\n\nThe MIT License (MIT)\n\nCopyright (c) 2021 laggardkernel\n\n[license icon]: https://img.shields.io/badge/License-MIT-blue.svg\n[license]: https://opensource.org/licenses/MIT\n[ranger]: https://github.com/ranger/ranger\n[urbainvaes-fzf-marks]: https://github.com/urbainvaes/fzf-marks\n[junegunn-fzf]: https://github.com/junegunn/fzf\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaggardkernel%2Franger-fzf-marks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaggardkernel%2Franger-fzf-marks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaggardkernel%2Franger-fzf-marks/lists"}