{"id":19202058,"url":"https://github.com/dqneo/apple-dictionary-parser","last_synced_at":"2025-05-12T13:22:24.532Z","repository":{"id":79214541,"uuid":"594624104","full_name":"DQNEO/apple-dictionary-parser","owner":"DQNEO","description":"Tool for parsing data from MacOS's dictionary files","archived":false,"fork":false,"pushed_at":"2024-09-10T12:21:25.000Z","size":113,"stargazers_count":17,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-20T13:36:19.104Z","etag":null,"topics":["apple-dictionary","dictionary","macos","oxford-dictionary","parser"],"latest_commit_sha":null,"homepage":"","language":"Go","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/DQNEO.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-01-29T05:38:30.000Z","updated_at":"2025-01-30T14:15:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"4ab6c6c8-34f0-4a4f-9690-dc1c11232f68","html_url":"https://github.com/DQNEO/apple-dictionary-parser","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DQNEO%2Fapple-dictionary-parser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DQNEO%2Fapple-dictionary-parser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DQNEO%2Fapple-dictionary-parser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DQNEO%2Fapple-dictionary-parser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DQNEO","download_url":"https://codeload.github.com/DQNEO/apple-dictionary-parser/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253745214,"owners_count":21957324,"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":["apple-dictionary","dictionary","macos","oxford-dictionary","parser"],"created_at":"2024-11-09T12:41:21.166Z","updated_at":"2025-05-12T13:22:24.511Z","avatar_url":"https://github.com/DQNEO.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apple Dictionary Parser\n\nApple Dictionary Parser is a command line tool and a library to parse and analyze MacOS's built-in dictionary files.\n\nCurrently only \"New Oxford American Dictionary\" is supported.\n\n# Installation\n\n```\n$ go install github.com/DQNEO/apple-dictionary-parser@latest\n```\n\nThe command line tool `apple-dictionary-parser ` will be installed in your `$GOPATH/bin` directory.\n\n\n# Usage\n\n## Export dictionary contents in raw format\n\n```\n$ apple-dictionary-parser dump\n```\n\nThis `dump` subcommand automatically finds the location of the dictionary file in your MacOS, and extract the binary content into a raw dump file (`/tmp/noad.cache`).\n\nThe format of the dump file is TSV (tab separated values),  each line representing a word with definition.\n\n```\n\u003cworld title\u003e\\t\u003cdefinition of the word in XML\u003e\\n\n```\n\nIf you are just interested in the raw contents of the dictionary and want to process the data on your own, this will be all you want.\n\n## Export dictionary contents into a text file\n```\n$ apple-dictionary-parser text \u003e /tmp/all-words.txt\n```\n\n## Export dictionary contents into a json file\n```\n$ apple-dictionary-parser json \u003e /tmp/all-words.json\n```\n\n## Export dictionary contents into a HTML file\n```\n$ apple-dictionary-parser html \u003e /tmp/all-words.html\n```\n\n## Export dictionary contents into alphabetically separated HTML files\n\n```\n$ apple-dictionary-parser html-split --out-dir /tmp/\n```\n\nThis generates a.html, b.html, ..., z.html files in a given directory.\n\n### Useful options to filter words\n\nIf you want to filter words to extract, you can use filtering options such as `--words` or `--words-file`\n\n```\n$ apple-dictionary-parser text --words=--words=happiness,joy,pleasure\n\n$ apple-dictionary-parser html --words-file=your-words.txt\n```\n\nThese filtering options are applicable to most of subcommands.\n\n## Analyze etymology data\n\n```\n$ apple-dictionary-parser etym /tmp/\n```\n\nThis analyzes etymology graph and make outputs in various formats (yaml, html)\n\n## Show phonetics information\n\n```\n$ apple-dictionary-parser phonetics\n```\n\n# License\nMIT\n\n# Author\n@DQNEO\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdqneo%2Fapple-dictionary-parser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdqneo%2Fapple-dictionary-parser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdqneo%2Fapple-dictionary-parser/lists"}