https://akawashiro.github.io/jendeley/ jendeley jendeley is a JSON-based document organizing software. * jendeley is JSON-based. You can see and edit your database quickly. * jendeley works locally. Your important database is owned only by you. No cloud. * jendeley is browser-based. You can run it anywhere node.js runs. Table of Contents * Why jendeley? * Quickstart * Install * Generate JSON database file + Recommended filename style + When jendeley fails to scan your PDFs * Launch the service daemon and open the web user interface + Launch jendeley automatically o Linux o Windows * Use the web user interface + Add a webpage + Add a PDF file on the Web + Upload a PDF file + Use tags and comments * Advanced topics + Check and edit your database (advanced) + Check source code (advanced) * Contact me * Support me Why jendeley? As programmers, we require various documents in different formats, such as recent machine learning papers, classic compiler books, CPU and accelerator specification documents, programming language documents, and informative blog articles. To efficiently manage these documents, it's important to categorize and classify them. Additionally, we need to ensure that they are saved and accessible in the long term, as we never know when we need them. To address these challenges, I developed jendeley. It allows you to register both PDFs and webpages in the same database, making categorization easy through the use of tags. Moreover, the database is stored as a plain text JSON file, making it easily editable using your preferred editor. This means that even if I discontinue development of jendeley, you can still access your information and even create alternative applications to manage it. Quickstart npm install @a_kawashiro/jendeley -g jendeley scan --papers_dir jendeley launch --db /jendeley_db.json Then you can see a screen like this! image Install npm install @a_kawashiro/jendeley -g You can find the latest package at npm page. Generate JSON database file jendeley scan --papers_dir This command outputs the database to / jendeley_db.json. If you have no PDF file, please specify an empty directory as . If jendeley encounters an issue scanning some PDFs, it generates a shell script named edit_and_run.sh. Please refer to the following subsection to learn how to rename the files accordingly, so that jendeley can properly recognize them. Recommended filename style jendeley uses a filename to find the document ID (e.g., DOI or ISBN )). jendeley recognizes parts of a filename that are not enclosed by [ and ] as the title of the file. So I recommend you to name the file accordingly, for example, * RustHorn CHC-based Verification for Rust Programs.pdf + When the document's title includes spaces, the filename should include spaces. * RustHorn CHC-based Verification for Rust Programs [matushita].pdf + If you want to write additional information in a filename, please enclose it by [ and ]. When jendeley fails to scan your PDFs jendeley heavily relies on DOI or ISBN to find the title, authors and published the year of PDFs. So jendeley tries to find the DOI of a given PDF in multiple ways. But sometimes, it fails to find DOI. In such cases, you can manually specify DOI of the PDF using the filename. * To specify DOI, change the filename to include [jendeley doi ]. + For example, cyclone [jendeley doi 10_1145_512529_512563].pdf. * To specify ISBN, change the filename to include [jendeley isbn ]. + For example, Types and Programming Languages [jendeley isbn 0262162091].pdf. * When the PDF doesn't have any DOI or ISBN, you can specify it by [jendeley no id]. + For example, ARM reference manual [jendeley no id].pdf. Launch the service daemon and open the web user interface jendeley launch --db /jendeley_db.json This command launches the jendeley daemon and opens the web user interface in your web browser at http://localhost:5000. You have the option to change the default port by using the -port option. Launch jendeley automatically Linux When using Linux, you can set up jendeley to start automatically by using systemd. To do this, please create a file named ~/.config/ systemd/user/jendeley.service with the following contents, and then run systemctl --user enable jendeley && systemctl --user start jendeley. You can then access jendeley at http://localhost:5000. You can monitor the logs using the command journalctl --user -f -u jendeley.service. # jendeley.service [Unit] Description=jendeley JSON-based document organization software [Service] ExecStart=jendeley launch --db --no_browser [Install] WantedBy=default.target Windows When using Windows, you can set up jendeley to launch automatically at startup. To do this, first open the startup directory by pressing Windows+R and typing shell:startup and then pressing Enter. [win-startup] And make autorun-jendeley.bat with the following contents using notepad.exe. :: autorun-jendeley.bat jendeley launch --db --no_browser >> [startup-directory] Use the web user interface When jendeley launches, jendeley opens the web user interface automatically. If not, please access http://localhost:5000/. image Add a webpage You can add a webpage to the database using REGISTER WEBPAGE button. When you register, you can write tags or comments. Tags are just commas (,) separated text. By the way, the date tags are automatically added to the database. Register webpage Add a PDF file on the Web You can add a PDF file to the web by using the REGISTER PDF FROM URL button. When you add the file, jendeley will attempt to locate its Digital object identifier (DOI) or International Standard Book Number (ISBN) and register the meta information, such as the author's name or publication date, to the database. In some cases, jendeley may not be able to find the DOI or ISBN for the PDF, or there may not be a corresponding DOI or ISBN for it. In such situations, you can specify the DOI or ISBN by using the filename. For more information, please refer to the Recommended filename style section. Register PDF from URL Upload a PDF file You can upload a PDF file in your computer using UPLOAD PDF button. Use tags and comments You can edit tags or comments after you register. You can edit tags or comments by double-clicking them. Edit comments Furthermore, you can filter the database using tags or comments. Filter by tag Advanced topics Check and edit your database (advanced) Because jendeley is fully JSON-based, you can quickly check the database's contents. > cat jendeley_db.json | jq '.' | head { "jendeley_meta": { "idType": "meta", "version": "0.0.17" }, "doi_10.1145/1122445.1122456": { "path": "/A Comprehensive Survey of Neural Architecture Search.pdf", "idType": "doi", "tags": [], "comments": "", You can edit your database using your preferred editor. However, after making the changes, it is important to verify that your database is still valid as a jendeley database using the command jendeley validate --db . Check source code (advanced) You can check the source code https://github.com/akawashiro/jendeley here. We welcome your pull request. Contact me You can find me on Twitter at https://twitter.com/a_kawashiro and on Mastodon at https://mstdn.jp/@a_kawashiro. Additional contact information can be found on my website at https:// akawashiro.github.io/#links. Also, feel free to create an issue or submit a pull request on the repository. Support me Please star akawashiro/jendeley. It encourages me a lot. This site is open source. Improve this page.