diff --git a/README.md b/README.md
index 5feb709..b486bca 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,31 @@
-# zotero
+# ZOTERO
 
+Zotero can extract native pdf annotations and sync them with obsidian.
+## obsidian plugin usage
+
+From obsidian, run the command prompt and run `zotero: templated`.
+This opens a prompt that asks you which papers to import.
+After having done that, the corresponding notes will be synced/created.
+Note that any text written below the `summary` section, is not persistent. Write any persistent stuff preferably directly below the title.
+## setup
+
+1. Install the two plugins from `p/zotero` into zotero.
+2. Go through the [zotfile setup](https://zotfile.com/index.html#how-to-install--set-up-zotfile) for syncing files to external devices. It basically boils down to configuring the correct settings under `tools -> zotfile preferences`.
+3. Install the bibtex citation format in zotero under `edit -> preferences -> cite -> get additional styles...`
+4. Install the obsidian zotero plugin and configure an input format that takes zotero/template.md as template and the bibtex citation format.
+5. Make sure the input format's (attachment) filenames go explicitly into the zotero folder.
+6. You should be good now.
+
+## mobile sync
+
+With zotfile properly installed, you can right click any paper and do `Manage Attachments ... -> Send to Tablet`.
+Now a pdf will be created in the folder that you specified during the zotfile setup (probably `p/zotero`).
+You can sync this folder with another device (using autosync or git or whatever), edit on that device and sync back.
+Then, in zotero right click the paper again and do `Manage Attachments ... -> Get from Tablet`
+Now, any annotations should be incorporated into zotero, and _should_ then be able to be synced into obsidian, though this hasn't been tested yet.
+
+## links
+- [zotfile](https://zotfile.com/index.html)
+- [better bibtex](https://github.com/retorquere/zotero-better-bibtex/releases/tag/v6.7.212)
+- [zotero obsidian plugin doc](https://github.com/mgmeyers/obsidian-zotero-integration/tree/main/docs)
+- [template source](https://github.com/lguenth/obsidian-templates/blob/main/zotero.md)
diff --git a/bibtex.csl b/bibtex.csl
new file mode 100644
index 0000000..a825ee8
--- /dev/null
+++ b/bibtex.csl
@@ -0,0 +1,184 @@
+<?xml version="1.0" encoding="utf-8"?>
+<style xmlns="http://purl.org/net/xbiblio/csl" class="in-text" version="1.0" demote-non-dropping-particle="sort-only" default-locale="en-US">
+  <info>
+    <title>BibTeX generic citation style</title>
+    <id>http://www.zotero.org/styles/bibtex</id>
+    <link href="http://www.zotero.org/styles/bibtex" rel="self"/>
+    <link href="http://www.bibtex.org/" rel="documentation"/>
+    <author>
+      <name>Markus Schaffner</name>
+    </author>
+    <contributor>
+      <name>Richard Karnesky</name>
+      <email>karnesky+zotero@gmail.com</email>
+      <uri>http://arc.nucapt.northwestern.edu/Richard_Karnesky</uri>
+    </contributor>
+    <contributor>
+      <name>Brenton M. Wiernik</name>
+      <email>zotero@wiernik.org</email>
+    </contributor>
+    <category citation-format="label"/>
+    <category field="generic-base"/>
+    <updated>2023-09-24T18:11:40+00:00</updated>
+    <rights license="http://creativecommons.org/licenses/by-sa/3.0/">This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 License</rights>
+  </info>
+  <macro name="zotero2bibtexType">
+    <choose>
+      <if type="bill book graphic legal_case legislation motion_picture report song" match="any">
+        <text value="book"/>
+      </if>
+      <else-if type="chapter" match="any">
+        <text value="inbook"/>
+      </else-if>
+      <else-if type="article article-journal article-magazine article-newspaper" match="any">
+        <text value="article"/>
+      </else-if>
+      <else-if type="thesis" match="any">
+        <text value="phdthesis"/>
+      </else-if>
+      <else-if type="manuscript" match="any">
+        <text value="unpublished"/>
+      </else-if>
+      <else-if type="paper-conference" match="any">
+        <text value="inproceedings"/>
+      </else-if>
+      <else-if type="report" match="any">
+        <text value="techreport"/>
+      </else-if>
+      <else>
+        <text value="misc"/>
+      </else>
+    </choose>
+  </macro>
+  <macro name="citeKey">
+    <group delimiter="_">
+      <text macro="author-short" text-case="lowercase"/>
+      <text macro="issued-year"/>
+    </group>
+  </macro>
+  <macro name="author-short">
+    <names variable="author">
+      <name form="short" delimiter="_" delimiter-precedes-last="always" et-al-min="11" et-al-use-first="10"/>
+      <substitute>
+        <names variable="editor"/>
+        <names variable="translator"/>
+        <choose>
+          <if type="bill book graphic legal_case legislation motion_picture report song" match="any">
+            <text variable="title" form="short"/>
+          </if>
+          <else>
+            <text variable="title" form="short"/>
+          </else>
+        </choose>
+      </substitute>
+    </names>
+  </macro>
+  <macro name="issued-year">
+    <date variable="issued">
+      <date-part name="year"/>
+    </date>
+  </macro>
+  <macro name="issued-month">
+    <date variable="issued">
+      <date-part name="month" form="short" strip-periods="true" text-case="lowercase"/>
+    </date>
+  </macro>
+  <macro name="author">
+    <names variable="author">
+      <name sort-separator=", " delimiter=" and " delimiter-precedes-last="always" name-as-sort-order="all"/>
+    </names>
+  </macro>
+  <macro name="editor-translator">
+    <names variable="editor translator" delimiter=", ">
+      <name sort-separator=", " delimiter=" and " delimiter-precedes-last="always" name-as-sort-order="all"/>
+    </names>
+  </macro>
+  <macro name="title">
+    <text variable="title"/>
+  </macro>
+  <macro name="number">
+    <text variable="issue"/>
+    <text variable="number"/>
+  </macro>
+  <macro name="container-title">
+    <choose>
+      <if type="chapter paper-conference" match="any">
+        <text variable="container-title" prefix=" booktitle={" suffix="}"/>
+      </if>
+      <else>
+        <text variable="container-title" prefix=" journal={" suffix="}"/>
+      </else>
+    </choose>
+  </macro>
+  <macro name="publisher">
+    <choose>
+      <if type="thesis">
+        <text variable="publisher" prefix=" school={" suffix="}"/>
+      </if>
+      <else-if type="report">
+        <text variable="publisher" prefix=" institution={" suffix="}"/>
+      </else-if>
+      <else>
+        <text variable="publisher" prefix=" publisher={" suffix="}"/>
+      </else>
+    </choose>
+  </macro>
+  <macro name="pages">
+    <text variable="page"/>
+  </macro>
+  <macro name="edition">
+    <!-- This should probably be ordinal? -->
+    <text variable="edition"/>
+  </macro>
+  <citation disambiguate-add-year-suffix="true" disambiguate-add-names="false" disambiguate-add-givenname="false" collapse="year">
+    <sort>
+      <key macro="author"/>
+      <key variable="issued"/>
+    </sort>
+    <layout delimiter="_">
+      <text macro="citeKey"/>
+    </layout>
+  </citation>
+  <bibliography hanging-indent="false">
+    <sort>
+      <key macro="author"/>
+      <key variable="issued"/>
+    </sort>
+    <layout>
+      <text macro="zotero2bibtexType" prefix=" @"/>
+      <group prefix="{" suffix=" }" delimiter=", ">
+        <text macro="citeKey"/>
+        <text variable="publisher-place" prefix=" address={" suffix="}"/>
+        <!--Fix This-->
+        <text variable="chapter-number" prefix=" chapter={" suffix="}"/>
+        <!--Fix This-->
+        <text macro="edition" prefix=" edition={" suffix="}"/>
+        <text variable="genre" prefix=" type={" suffix="}"/>
+        <text variable="collection-title" prefix=" series={" suffix="}"/>
+        <text macro="title" prefix=" title={" suffix="}"/>
+        <text variable="volume" prefix=" volume={" suffix="}"/>
+        <text variable="license" prefix=" rights={" suffix="}"/>
+        <text variable="ISBN" prefix=" ISBN={" suffix="}"/>
+        <text variable="ISSN" prefix=" ISSN={" suffix="}"/>
+        <text variable="call-number" prefix=" callNumber={" suffix="}"/>
+        <text variable="archive_location" prefix=" archiveLocation={" suffix="}"/>
+        <text variable="URL" prefix=" url={" suffix="}"/>
+        <text variable="DOI" prefix=" DOI={" suffix="}"/>
+        <text variable="abstract" prefix=" abstractNote={" suffix="}"/>
+        <text variable="note" prefix=" note={" suffix="}"/>
+        <text macro="number" prefix=" number={" suffix="}"/>
+        <text macro="container-title"/>
+        <text macro="publisher"/>
+        <text macro="author" prefix=" author={" suffix="}"/>
+        <text macro="editor-translator" prefix=" editor={" suffix="}"/>
+        <text macro="issued-year" prefix=" year={" suffix="}"/>
+        <text macro="issued-month" prefix=" month=" suffix=""/>
+        <text macro="pages" prefix=" pages={" suffix="}"/>
+        <text variable="collection-title" prefix=" collection={" suffix="}"/>
+        <text variable="keyword" prefix=" keywords={" suffix="}"/>
+        <text variable="language" prefix="language={" suffix="}"/>
+        <text variable="annote" prefix="annote={" suffix="}"/>
+      </group>
+    </layout>
+  </bibliography>
+</style>
diff --git a/zotero-better-bibtex-6.7.212.xpi b/zotero-better-bibtex-6.7.212.xpi
new file mode 100644
index 0000000..34e08a6
Binary files /dev/null and b/zotero-better-bibtex-6.7.212.xpi differ
diff --git a/zotfile-5.1.2-fx.xpi b/zotfile-5.1.2-fx.xpi
new file mode 100644
index 0000000..0918c11
Binary files /dev/null and b/zotfile-5.1.2-fx.xpi differ