{"id":18418953,"url":"https://github.com/smrfeld/export-safari-reading-list","last_synced_at":"2025-04-07T13:31:26.138Z","repository":{"id":115478301,"uuid":"439094650","full_name":"smrfeld/export-safari-reading-list","owner":"smrfeld","description":"Export Safari reading list to JSON or CSV","archived":false,"fork":false,"pushed_at":"2023-10-20T04:31:32.000Z","size":825,"stargazers_count":21,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-21T18:07:18.367Z","etag":null,"topics":["mac","python","reading-list","safari","web-data"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/safarireadinglist/","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/smrfeld.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}},"created_at":"2021-12-16T18:48:20.000Z","updated_at":"2024-12-14T20:15:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"e278a14e-7532-437b-8b88-fa237594de6f","html_url":"https://github.com/smrfeld/export-safari-reading-list","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/smrfeld%2Fexport-safari-reading-list","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smrfeld%2Fexport-safari-reading-list/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smrfeld%2Fexport-safari-reading-list/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smrfeld%2Fexport-safari-reading-list/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smrfeld","download_url":"https://codeload.github.com/smrfeld/export-safari-reading-list/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247661696,"owners_count":20975102,"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":["mac","python","reading-list","safari","web-data"],"created_at":"2024-11-06T04:15:07.738Z","updated_at":"2025-04-07T13:31:25.295Z","avatar_url":"https://github.com/smrfeld.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Safari reading list in Python\n\n`safarireadinglist` is a Python package to load your Safari reading list into Python, and to export it, including thumbnail icons.\n\n\u003cimg src=\"https://github.com/smrfeld/export-safari-reading-list/blob/main/readme_imgs/reading_list.jpg?raw=true\" alt=\"drawing\" width=\"400\"/\u003e\n\n## Sample results\n\n\u003cimg src=\"https://github.com/smrfeld/export-safari-reading-list/blob/main/readme_imgs/json.png?raw=true\" alt=\"drawing\" width=\"700\"/\u003e\n\n\u003cimg src=\"https://github.com/smrfeld/export-safari-reading-list/blob/main/readme_imgs/csv.png?raw=true\" alt=\"drawing\" width=\"700\"/\u003e\n\n## Installation\n\nInstall the `safarireadinglist` package from PyPI:\n\n```bash\npip install safarireadinglist\n```\n\nNote: before using, you need to give the terminal full disk access in the system preferences. Go to `Settings/Security \u0026 Privacy/Full Disk Access`. Navigate to `/Applications/Utilities/` folder and choose the `Terminal` app. If you are launching the command from VS Code you will need to add this as well.\n\n*Alternative local installation:*\n\n```bash\npip install -e .\n```\n\nNote: `setuptools` is the only requirement. For dev purposes, you may want to install the exact versions in `pip install -r requirements.txt`.\n\n## Usage\n\nIn the command line, execute:\n\n```bash\nexport-safari-rl export\n```\n\nThe reading list will be in `reading_list.json`. You may also provide other options: `export-safari-rl --help`.\n\nYou can also export the icons from the reading list:\n\n```bash\nexport-safari-rl export-icons\n```\n\nThe icons will be in the `reading_list_icons` folder.\n\nSee also the [README](examples/README.md) in the [examples](examples) folder for more examples.\n\n### Python package\n\nThe package is a Python package and can also be used as such. See [example_python.py](examples/example_python.py) for an example.\n\n### Example of output format\n\nSee [reading_list.json](reading_list.json). The format is a list of dictionaries, where each dictionary conforms to the `safarireadinglist.ReadingListItem` dataclass.\n\n### Website\n\nTo generate the website from the `website` folder, run:\n```\ncd website\npython website.py reading_list.json reading_list_icons\n```\nThe output is in the `website_out` folder.\n\n\u003cimg src=\"https://github.com/smrfeld/export-safari-reading-list/blob/main/readme_imgs/website.png?raw=true\" alt=\"drawing\" width=\"800\"/\u003e\n\n## Known errors \u0026 solutions\n\nIf you are getting some error like this:\n```bash\ncp: /Users/XXX/Library/Safari/Bookmarks.plist: Operation not permitted\n```\nYou need to give the terminal full disk access. Go to `Settings/Security \u0026 Privacy/Full Disk Access`. Navigate to `/Applications/Utilities/` folder and choose the `Terminal` app. If you are launching the command from VS Code you will need to add this as well.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmrfeld%2Fexport-safari-reading-list","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmrfeld%2Fexport-safari-reading-list","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmrfeld%2Fexport-safari-reading-list/lists"}