{"id":22588509,"url":"https://github.com/evilmarty/safari-bookmarks-cli","last_synced_at":"2025-04-10T21:23:04.125Z","repository":{"id":188237462,"uuid":"678351741","full_name":"evilmarty/safari-bookmarks-cli","owner":"evilmarty","description":"A cli to manage bookmarks in the Safari web browser.","archived":false,"fork":false,"pushed_at":"2024-04-18T08:39:54.000Z","size":44,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-05-02T00:24:50.728Z","etag":null,"topics":["bookmarks","browser","cli","python","safari"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evilmarty.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":"2023-08-14T10:59:03.000Z","updated_at":"2024-07-21T07:20:16.399Z","dependencies_parsed_at":"2023-08-14T12:24:35.559Z","dependency_job_id":"cd491eb0-f590-4ad1-aa80-3f9ca8ec40bf","html_url":"https://github.com/evilmarty/safari-bookmarks-cli","commit_stats":null,"previous_names":["evilmarty/safari-bookmarks-cli"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilmarty%2Fsafari-bookmarks-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilmarty%2Fsafari-bookmarks-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilmarty%2Fsafari-bookmarks-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilmarty%2Fsafari-bookmarks-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evilmarty","download_url":"https://codeload.github.com/evilmarty/safari-bookmarks-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248299145,"owners_count":21080474,"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","browser","cli","python","safari"],"created_at":"2024-12-08T08:09:45.676Z","updated_at":"2025-04-10T21:23:04.105Z","avatar_url":"https://github.com/evilmarty.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# safari-bookmarks-cli\n\nA cli to manage bookmarks in the Safari web browser.\n\nThis utility interacts with Safari's `Bookmarks.plist` file. When it detects changes it is reloaded without intervention.\n\n**Note** macOS 10.14+ requires Full Disk Access for the application being used. ie. Terminal, iTerm, etc.\n\n## Installation\n\nYou can install safari-bookmarks-cli via pip:\n\n```shell\npip3 install safari-bookmarks-cli\n\n# verify installation\nsafari-bookmarks --version\n```\n\n## Usage\n\nThe following assumes the default location for Safari's bookmarks, which is `~/Library/Safari/Bookmarks.plist`. If this is not the case you can specify an alternate location by passing the arguments `-f \u003celsewhere\u003e`.\n\nFor a full list of commands and options just run:\n\n```shell\nsafari-bookmarks --help\n```\n\n### To list all bookmarks run\n\n```shell\nsafari-bookmarks list\n```\n\n### To list all bookmarks in the menubar\n\n```shell\nsafari-bookmarks list \"BookmarksMenu\"\n```\n\n### Add a new bookmark to the menubar\n\n```shell\nsafari-bookmarks add --title \"New bookmark\" --url \"http://example.com\" \"BookmarksMenu\"\n```\n\n### Add a new bookmark to the menu\n\n```shell\nsafari-bookmarks add --title \"New folder\" --list \"BookmarksBar\"\n```\n\n### Move a bookmark to a different folder\n\n```shell\nsafari-bookmarks move \"BookmarksMenu\" \"New bookmark\" --to \"BookmarksBar\" \"New folder\"\n```\n\n### Remove a bookmark or folder\n\n**Note** removing a folder will also remove all bookmarks and folders within it.\n\n```shell\nsafari-bookmarks remove \"BookmarksBar\" \"New folder\"\n```\n\n### Empty a folder\n\n```shell\nsafari-bookmarks empty \"BookmarksBar\" \"New folder\"\n```\n\n## Testing\n\nClone the repository:\n\n```shell\ngit clone https://github.com/evilmarty/safari-bookmarks-cli.git\n```\n\nInstall pytest and flake8\n\n```shell\npip3 install pytest flake8\n```\n\nRun them\n\n```shell\npytest \u0026\u0026 flake8\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevilmarty%2Fsafari-bookmarks-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevilmarty%2Fsafari-bookmarks-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevilmarty%2Fsafari-bookmarks-cli/lists"}