{"id":13479801,"url":"https://github.com/alefragnani/vscode-bookmarks","last_synced_at":"2025-05-14T09:06:39.640Z","repository":{"id":2293114,"uuid":"46173821","full_name":"alefragnani/vscode-bookmarks","owner":"alefragnani","description":"Bookmarks Extension for Visual Studio Code","archived":false,"fork":false,"pushed_at":"2025-05-11T15:23:27.000Z","size":12296,"stargazers_count":1837,"open_issues_count":95,"forks_count":171,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-05-14T09:05:25.120Z","etag":null,"topics":["bookmark","navigation","visual-studio-code","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=alefragnani.Bookmarks","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alefragnani.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","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},"funding":{"github":"alefragnani","patreon":"alefragnani","custom":"https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=EP57F3B6FXKTU\u0026lc=US\u0026item_name=Alessandro%20Fragnani\u0026item_number=vscode%20extensions\u0026currency_code=USD\u0026bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"}},"created_at":"2015-11-14T12:31:40.000Z","updated_at":"2025-05-11T15:23:31.000Z","dependencies_parsed_at":"2023-02-15T21:15:37.725Z","dependency_job_id":"f45b4484-f3c0-4d79-9e52-fc964ba9cbe0","html_url":"https://github.com/alefragnani/vscode-bookmarks","commit_stats":{"total_commits":606,"total_committers":31,"mean_commits":"19.548387096774192","dds":0.1452145214521452,"last_synced_commit":"e9240fa7bdc2856c6cf7413e9196b699c5c4efcb"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alefragnani%2Fvscode-bookmarks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alefragnani%2Fvscode-bookmarks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alefragnani%2Fvscode-bookmarks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alefragnani%2Fvscode-bookmarks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alefragnani","download_url":"https://codeload.github.com/alefragnani/vscode-bookmarks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254110374,"owners_count":22016391,"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":["bookmark","navigation","visual-studio-code","vscode","vscode-extension"],"created_at":"2024-07-31T16:02:23.212Z","updated_at":"2025-05-14T09:06:39.621Z","avatar_url":"https://github.com/alefragnani.png","language":"TypeScript","funding_links":["https://github.com/sponsors/alefragnani","https://patreon.com/alefragnani","https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=EP57F3B6FXKTU\u0026lc=US\u0026item_name=Alessandro%20Fragnani\u0026item_number=vscode%20extensions\u0026currency_code=USD\u0026bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted","https://www.patreon.com/alefragnani"],"categories":["TypeScript","visual-studio-code","vscode-extension"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cbr /\u003e\n  \u003ca title=\"Learn more about Bookmarks\" href=\"http://github.com/alefragnani/vscode-bookmarks\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/alefragnani/vscode-bookmarks/master/images/vscode-bookmarks-logo-readme.png\" alt=\"Bookmarks Logo\" width=\"50%\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# What's new in Bookmarks 13.5\n\n* Published to **Open VSX**\n* Adds **Getting Started / Walkthrough**\n* Adds **Side Bar** badge\n* Adds Toggle bookmark via mouse click\n* Adds **Icon** customization\n\n# Support\n\n**Bookmarks** is an extension created for **Visual Studio Code**. If you find it useful, please consider supporting it.\n\n\u003ctable align=\"center\" width=\"60%\" border=\"0\"\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003ca title=\"Paypal\" href=\"https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=EP57F3B6FXKTU\u0026lc=US\u0026item_name=Alessandro%20Fragnani\u0026item_number=vscode%20extensions\u0026currency_code=USD\u0026bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted\"\u003e\u003cimg src=\"https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca title=\"GitHub Sponsors\" href=\"https://github.com/sponsors/alefragnani\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/alefragnani/oss-resources/master/images/button-become-a-sponsor-rounded-small.png\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca title=\"Patreon\" href=\"https://www.patreon.com/alefragnani\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/alefragnani/oss-resources/master/images/button-become-a-patron-rounded-small.png\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n# Bookmarks\n\nIt helps you to navigate in your code, moving between important positions easily and quickly. _No more need to search for code._ It also supports a set of **selection** commands, which allows you to select bookmarked lines and regions between bookmarked lines. It's really useful for log file analysis.\n\nHere are some of the features that **Bookmarks** provides:\n\n* **Mark/unmark positions** in your code\n* Mark positions in your code and **give it name**\n* **Jump** forward and backward between bookmarks\n* Icons in **gutter** and **overview ruler**\n* See a list of all Bookmarks in one **file** and **project**\n* **Select lines** and **regions** with bookmarks\n* A dedicated **Side Bar**\n\n# Features\n\n## Available commands\n\n* `Bookmarks: Toggle` Mark/unmark positions with bookmarks\n* `Bookmarks: Toggle Labeled` Mark labeled bookmarks\n* `Bookmarks: Jump to Next` Move the cursor forward, to the bookmark below\n* `Bookmarks: Jump to Previous` Move the cursor backward, to the bookmark above\n* `Bookmarks: List` List all bookmarks in the current file\n* `Bookmarks: List from All Files` List all bookmarks from all files\n* `Bookmarks: Clear` remove all bookmarks in the current file\n* `Bookmarks: Clear from All Files` remove all bookmarks from all files\n* `Bookmarks (Selection): Select Lines` Select all lines that contains bookmarks\n* `Bookmarks (Selection): Expand Selection to Next` Expand the selected text to the next bookmark\n* `Bookmarks (Selection): Expand Selection to Previous` Expand the selected text to the previous bookmark\n* `Bookmarks (Selection): Shrink Selection` Shrink the select text to the Previous/Next bookmark\n\n## Manage your bookmarks\n\n### Toggle / Toggle Labeled\n\nYou can easily Mark/Unmark bookmarks on any position. You can even define **Labels** for each bookmark.\n\n![Toggle](images/printscreen-toggle.png)\n\n## Navigation\n\n### Jump to Next / Previous\n\nQuicky move between bookmarks backward and forward, even if located outside the active file.\n\n### List / List from All Files\n\nList all bookmarks from the current file/project and easily navigate to any of them. It shows a line preview and temporarily scroll to its position.\n\n![List](images/bookmarks-list-from-all-files.gif)\n\n* Bookmarks from the active file only shows the line number and its contents\n* Bookmarks from other files in the project also shows the relative path\n\n## Improved Multi-root support\n\nWhen you work with **multi-root** workspaces, the extension can manage the bookmarks individually for each folder. \n\nSimply define `saveBookmarksInProject` as `true` on your **User Settings** or in the **Workspace Settings**, and when you run the `Bookmarks: List from All Files` command, you will be able to select from which folder the bookmarks will be shown.\n\n![List](images/bookmarks-list-from-all-files-multi-root.gif)\n\n### Remote Development support\n\nThe extension now fully supports **Remote Development** scenarios. \n\nIt means that when you connect to a _remote_ location, like a Docker Container, SSH or WSL, the extension will be available, ready to be used. \n\n\u003e You don't need to install the extension on the remote anymore.\n\nBetter yet, if you use `bookmarks.saveBookmarksInProject` setting defined as `true`, the bookmarks saved locally _will be available_ remotely, and you will be able to navigate and update the bookmarks. Just like it was a resource from folder you opened remotely.\n\n## Selection\n\nYou can use **Bookmarks** to easily select lines or text blocks. Simply toggle bookmarks in any position of interest and use some of the _Selection_ commands available.\n\n#### Select Lines\n\nSelect all bookmarked lines. Specially useful while working with log files.\n\n![Select Lines](images/bookmarks-select-lines.gif)\n\n#### Expand Selection to the Next/Previous Bookmark or Shrink the Selection\n\nManipulate the selection of lines _between_ bookmarks, up and down.\n\n## Available Settings\n\n* Allow navigation through all files that contains bookmarks _(`true` by default)_\n```json\n    \"bookmarks.navigateThroughAllFiles\": false\n```\n\n* Allow navigation to wrap around at the first and last bookmarks in scope (current file or all files) _(`true` by default)_\n```json\n    \"bookmarks.wrapNavigation\": true\n```\n\n* Bookmarks are always saved between sessions, and you can decide if it should be saved _in the Project_, so you can add it to your Git/SVN repo and have it in all your machines _(`false` by default)_\n```json\n    \"bookmarks.saveBookmarksInProject\": true\n```\n\n* Path to another image to be shown as Bookmark (16x16 px)\n```json\n    \"bookmarks.gutterIconPath\": \"c:\\\\temp\\\\othericon.png\"\n```\n\u003e Deprecated in 13.3: Use `bookmarks.gutterIconFillColor` and `bookmarks.gutterIconBorderColor` instead\n\n* Specifies the fill color of the bookmark icon\n```json\n    \"bookmarks.gutterIconFillColor\"\n```\n\n* Specifies the border color of the bookmark icon\n```json\n    \"bookmarks.gutterIconBorderColor\"\n```\n\n* Choose the background color to use on a bookmarked line\n\n```json\n    \"bookmarks.backgroundLineColor\"\n```\n\u003e Deprecated in 10.7: Use `workbench.colorCustomizations` instead. More info in [Available Colors](#available-colors)\n\n* Allow bookmarks commands, (Toggle, Jump to Next/Previous), to be displayed on the editor contex menu _(`true` by default)_\n```json\n    \"bookmarks.showCommandsInContextMenu\": true\n```\n\n* **Experimental**. Enables the new **Sticky engine** with support for Formatters, improved source change detections and undo operations _(`true` by default)_\n\n```json\n    \"bookmarks.experimental.enableNewStickyEngine\": false\n```\n\n* \"Specifies whether bookmarks on deleted line should be kept on file, moving it down to the next line, instead of deleting it with the line where it was toggled.\" _(`false` by default)_\n\n```json\n    \"bookmarks.keepBookmarksOnLineDelete\": true\n```\n\n\u003e **Limitation:** It does not support `Undo` operations. It means that, once you delete a line and the bookmark is moved to the next available line, the `Undo` operation won't move the bookmark back to the previous line. The next line is now the new location of the bookmark.\n\n* Use a **workaround** for formatters, like Prettier, which does not notify on document changes and messes Bookmark's _Sticky_ behavior _(`false` by default)_\n\n```json\n    \"bookmarks.useWorkaroundForFormatters\": true\n```\n\u003e This workaround can be turned off if you are using the new Sticky Engine (setting above)  \n\n* Choose if the Side Bar should start expanded _(`false` by default)_\n```json\n    \"bookmarks.sideBar.expanded\": true\n```\n\n* Controls the count badge on the Bookmark icon on the Activity Bar _(`all` by default)_\n\n  * `all`: Show the sum of bookmarks from all files\n  * `files`: Show the sum of files that contains some bookmarks\n  * `off`: Disable the Bookmarks count badge\n\n```json\n    \"bookmarks.sideBar.countBadge\": \"files\"\n```\n\n* Choose how multi cursor handles already bookmarked lines _(`allLinesAtOnce` by default)_\n\n  * `allLinesAtOnce`: Creates bookmarks in all selected lines at once, if at least one of the lines don't have a bookmark\n  * `eachLineIndependently`: Literally toggles a bookmark in each line, instead of making all lines equal\n\n```json\n    \"bookmarks.multicursor.toggleMode\": \"eachLineIndependently\"\n```\n\n* Choose how labels are suggested when creating bookmarks _(`dontUse` by default)_\n\n  * `dontUse`: Don't use the selection (original behavior)\n  * `useWhenSelected`: Use the selected text _(if available)_ directly, no confirmation required\n  * `suggestWhenSelected`: Suggests the selected text _(if available)_. You still need to confirm.\n  * `suggestWhenSelectedOrLineWhenNoSelected`: Suggests the selected text _(if available)_ or the entire line (when has no selection). You still need to confirm\n\n```json\n    \"bookmarks.label.suggestion\": \"useWhenSelected\"\n```\n\n* Choose the location where the bookmarked line will be revealed _(`center` by default)_\n\n  * `top`: Reveals the bookmarked line at the top of the editor\n  * `center`: Reveals the bookmarked line in the center of the editor\n\n```json\n    \"bookmarks.revealPosition\": \"center\"\n```\n\n* Specifies the lane in the overview ruler where the bookmarked line will be shown _(`full` by default)_\n\n  * `none`: Don't show the bookmarked line in the overview ruler\n  * `left`: Show the bookmarked line in the left lane of the overview ruler\n  * `center`: Show the bookmarked line in the center lane of the overview ruler\n  * `right`: Show the bookmarked line in the right lane of the overview ruler\n  * `full`: Show the bookmarked line in the full height of the overview ruler\n\n```json\n    \"bookmarks.overviewRulerLane\": \"left\"\n```\n\n## Available Colors\n\n* Choose the background color to use on a bookmarked line\n```json\n    \"workbench.colorCustomizations\": {\n      \"bookmarks.lineBackground\": \"#157EFB22\"  \n    }\n```\n\n* Choose the border color to use on a bookmarked line\n```json\n    \"workbench.colorCustomizations\": {\n      \"bookmarks.lineBorder\": \"#FF0000\"  \n    }\n```\n\n* Choose marker color to use in the overview ruler\n```json\n    \"workbench.colorCustomizations\": {\n      \"bookmarks.overviewRuler\": \"#157EFB88\"  \n    }\n```\n\n## Side Bar\n\nThe **Bookmarks** extension has its own **Side Bar**, with a variety of commands to improve you productivity. \n\n| Single Folder | Multi-root Workspace |\n|---------------|------------|\n| ![Side Bar](images/printscreen-activity-bar.png) | ![Side Bar](images/printscreen-activity-bar-multi-root.png) |\n\n## Project and Session Based\n\nThe bookmarks are saved _per session_ for the project that you are using. You don't have to worry about closing files in _Working Files_. When you reopen the file, the bookmarks are restored.\n\nIt also works even if you only _preview_ a file (simple click in TreeView). You can put bookmarks in any file and when you preview it again, the bookmarks will be there.\n\n# License\n\n[GPL-3.0](LICENSE.md) \u0026copy; Alessandro Fragnani","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falefragnani%2Fvscode-bookmarks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falefragnani%2Fvscode-bookmarks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falefragnani%2Fvscode-bookmarks/lists"}