{"id":13565026,"url":"https://github.com/vanakat/zotero-bridge","last_synced_at":"2025-08-21T15:33:05.327Z","repository":{"id":37999925,"uuid":"455808525","full_name":"vanakat/zotero-bridge","owner":"vanakat","description":"Obsidian plugin to integrate with Zotero","archived":false,"fork":false,"pushed_at":"2024-06-23T21:37:15.000Z","size":120,"stargazers_count":44,"open_issues_count":5,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-08-01T13:33:04.896Z","etag":null,"topics":["obsidian","obsidian-md","obsidian-plugin","zotero","zotserver"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/vanakat.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":"2022-02-05T07:48:25.000Z","updated_at":"2024-08-01T10:10:14.000Z","dependencies_parsed_at":"2024-01-16T18:59:55.842Z","dependency_job_id":"efe125f8-e492-4842-b41e-8dff9ec2cb4a","html_url":"https://github.com/vanakat/zotero-bridge","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanakat%2Fzotero-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanakat%2Fzotero-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanakat%2Fzotero-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanakat%2Fzotero-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vanakat","download_url":"https://codeload.github.com/vanakat/zotero-bridge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230520394,"owners_count":18238948,"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":["obsidian","obsidian-md","obsidian-plugin","zotero","zotserver"],"created_at":"2024-08-01T13:01:39.409Z","updated_at":"2024-12-20T01:16:12.810Z","avatar_url":"https://github.com/vanakat.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Obsidian Zotero Bridge Plugin\n\nObsidian-Zotero integration plugin that provides APIs for other plugins to connect to Zotero.\n\n## Prerequisites\n\n### Zotero \u003e= 7\n\nEnable Local API feature in settings: `Settings \u003e Advanced \u003e Allow other applications on this computer to communicate with Zotero`\n\n### Zotero \u003c= 6\n\nInstall Zotero addon [ZotServer](https://github.com/MunGell/ZotServer)\n\n## How to use\n\nZotero Bridge provides APIs for other plugins to connect to Zotero.\n\nExample of such consumer plugin is [Zotero Link](https://github.com/vanakat/zotero-link).\n\nAPIs of this plugin are published with Obsidian [plugin api](https://github.com/vanakat/plugin-api) library and can be used anywhere in Obsidian.\n\nExample use of Zotero Bridge APIs in [Templater](https://github.com/SilentVoid13/Templater) [user scripts](https://silentvoid13.github.io/Templater/user-functions/script-user-functions.html):\n\n`zotero.js` user script:\n\n```js\nmodule.exports = async function () {\n    const item = await PluginApi.ZoteroBridge.v1().search();\n    return (prop) =\u003e dotAccess(prop, item.getValues());\n}\n\nfunction dotAccess(str, obj) {\n    return str.split('.').reduce((previousValue, currentValue) =\u003e previousValue[currentValue], obj);\n}\n```\n\nThis function can now be used in templates:\n\n_(this example is taken from https://github.com/vanakat/zotero-bridge/pull/2)_\n\n```\n\u003c%* const zi = await tp.user.zotero() %\u003e\n\n\n\u003c% zi('firstAuthor.lastName') %\u003e\u003c%* if (zi('authors.length')  == 2) { %\u003e and \u003c% zi('authors')[1].lastName %\u003e\u003c%* } else if (zi('authors.length') \u003e 2) { %\u003e et al.\u003c%* } %\u003e \u003c% zi('date.year') %\u003e \u003c% zi('title') %\u003e\n```\n\n## How to contribute\n\n1. Fork and clone this repository\n2. Link this directory to your plugins directory: `ln -sfn \u003cthis-directory\u003e \u003cyour-test-vault\u003e/.obsidian/plugins/obsidian-zotero`\n3. `npm install` to install all dependencies\n4. `npm run dev` will run development server\n5. Reload your Obsidian with test vault open\n\nPlease refer to following helpful resources:\n\n* [Unofficial Obsidian API docs](https://marcus.se.net/obsidian-plugin-docs/)\n* [Official Obsidian API definition file](https://github.com/obsidianmd/obsidian-api/blob/master/obsidian.d.ts)\n* [ZotServer repository](https://github.com/MunGell/ZotServer) for documentation on API\n* [Zotero search API code](https://github.com/zotero/zotero/blob/master/chrome/content/zotero/xpcom/data/search.js) for the most up-to-date search API documentation\n* [Zotero 7 Local API announcement](https://groups.google.com/g/zotero-dev/c/ElvHhIFAXrY/m/fA7SKKwsAgAJ)\n\n## Other Zotero integration plugins\n\nWhile working on this plugin I found another Zotero integration one called [Zotero Integration](https://github.com/mgmeyers/obsidian-zotero-integration).\nIf you are looking for a citation/bibliography integration with Zotero it might be a good option for you.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanakat%2Fzotero-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvanakat%2Fzotero-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanakat%2Fzotero-bridge/lists"}