{"id":13478864,"url":"https://github.com/urbainvaes/fzf-marks","last_synced_at":"2025-04-04T10:09:56.021Z","repository":{"id":33234101,"uuid":"36877843","full_name":"urbainvaes/fzf-marks","owner":"urbainvaes","description":"Plugin to manage bookmarks in bash and zsh","archived":false,"fork":false,"pushed_at":"2024-08-15T16:01:53.000Z","size":2031,"stargazers_count":493,"open_issues_count":13,"forks_count":40,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-28T09:09:13.704Z","etag":null,"topics":["bookmarks","fzf","shell-script","zsh-plugin"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"symfony/requirements-checker","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/urbainvaes.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":"2015-06-04T15:11:27.000Z","updated_at":"2025-03-12T02:23:42.000Z","dependencies_parsed_at":"2024-01-03T04:17:04.232Z","dependency_job_id":"0f152f43-9c22-4bcf-8d3b-5873049e0dcf","html_url":"https://github.com/urbainvaes/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/urbainvaes%2Ffzf-marks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbainvaes%2Ffzf-marks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbainvaes%2Ffzf-marks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbainvaes%2Ffzf-marks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/urbainvaes","download_url":"https://codeload.github.com/urbainvaes/fzf-marks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247157283,"owners_count":20893220,"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":["bookmarks","fzf","shell-script","zsh-plugin"],"created_at":"2024-07-31T16:02:04.763Z","updated_at":"2025-04-04T10:09:55.997Z","avatar_url":"https://github.com/urbainvaes.png","language":"Shell","funding_links":[],"categories":["Shell","Plugins"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"readme":"# fzf-marks\nThis plugin can be used to create, delete, and navigate marks in *bash* and *zsh*.\nIt depends on Junegunn Choi's fuzzy-finder [fzf](https://github.com/junegunn/fzf).\n\n![](https://raw.github.com/uvaes/fuzzy-zsh-marks/demo/demo.gif)\n(This video was generated with `screenkey -g $(slop -n -f '%g')` and `simplescreenrecorder`.)\n\n# Installation\n\n### Zsh\n\nIf you use *zsh*, I recommend installing with a plugin manager.\nIn the case of [zgen](https://github.com/tarjoilija/zgen), for example,\nsimply add the following line to your plugin list:\n```zsh\nzgen load urbainvaes/fzf-marks\n```\n### Fish\n\nIf you use *fish*, then you can use [fisher](https://github.com/jorgebucaran/fisher):\n```fish\nfisher install urbainvaes/fzf-marks\n```\n\n### Bash\n\nIf you use *bash*,\nor if you use *zsh* without a plugin manager,\nsource the file `fzf-marks.plugin.bash` or `fzf-marks.plugin.zsh` from your shell startup file\nto enable the plugin.\n\n**Bash installation example**:\n```bash\n# Clone the git repository in the current directory\ngit clone https://github.com/urbainvaes/fzf-marks.git\n\n# Add a line to ~/.bashrc to load the plugin whenever bash starts in interactive mode\necho \"source $PWD/fzf-marks/fzf-marks.plugin.bash\" \u003e\u003e ~/.bashrc\n\n# Source the plugin now so we don't have to restart bash to start using it\nsource fzf-marks/fzf-marks.plugin.bash\n```\n\n**Enabling completion**:\n\nIn `bash`, completion should be available automatically.\nIn `zsh`, completion needs to be enabled explicitly before sourcing the plugin.\nThis is usually done automatically by plugin managers,\nbut it can also be achieved manually with the following command in your `.zshrc`.\n```zsh\nautoload -Uz compinit \u0026\u0026 compinit\n```\n\n# Usage\nThe script exposes two functions:\n\n- **mark \\\u003cmark\\\u003e**, to register a new mark to the current directory;\n- **fzm [\\\u003coptional-initial-query\\\u003e]**, to jump to or delete a mark using `fzf`.\n\nMost of the keybindings in the search window are the default fzf ones.\nThe only additions are\n\n- **ctrl-y**, to jump to a match;\n- **ctrl-t**, to toggle a match for deletion;\n- **ctrl-d**, to delete selected matches.\n\nBy default, the plugin binds the key `ctrl-g` to `fzm`.\n\n# Customization\n\n| Config                  | Default                         | Description                          |\n| ------                  | -------                         | -----------                          |\n| `FZF_MARKS_FILE`        | `${HOME}/.fzf-marks`            | File containing the marks data       |\n| `FZF_MARKS_COMMAND`     | `fzf --height 40% --reverse`    | Command used to call `fzf`           |\n| `FZF_MARKS_JUMP`        | `\\C-g` (*bash*) or `^g` (*zsh*)     | Keybinding to `fzm`                  |\n| `FZF_MARKS_COLOR_LHS`   | 39 (default)                    | ANSI color code of left-hand side    |\n| `FZF_MARKS_COLOR_RHS`   | 36 (cyan)                       | ANSI color code of right-hand side   |\n| `FZF_MARKS_COLOR_COLON` | 33 (yellow)                     | ANSI color code of separator         |\n| `FZF_MARKS_NO_COLORS`   | 0                               | Set this to 1 to disable colors      |\n| `FZF_MARKS_KEEP_ORDER`  | 0                               | Set this to 1 to keep order of marks |\n\nSee e.g. [here](http://pueblo.sourceforge.net/doc/manual/ansi_color_codes.html) for a description of ANSI color codes.\n\n# FAQ\n\n**Question**: *Is it possible to limit the fzf search to the mark label, i.e. to exclude the path from the search?*\n\nYes, this is possible by passing the options `-n` (for the field number to use for the search) and `-d` (for the delimiter) to `fzf`.\nFor example,\n```\nFZF_MARKS_COMMAND=\"fzf --height 40% --reverse -n 1 -d ' : '\"\n```\n\n# License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furbainvaes%2Ffzf-marks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Furbainvaes%2Ffzf-marks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furbainvaes%2Ffzf-marks/lists"}