{"id":13642780,"url":"https://github.com/naclander/Calibre-Remarkable-Device-Driver-Plugin","last_synced_at":"2025-04-20T20:32:51.894Z","repository":{"id":39795468,"uuid":"335825611","full_name":"naclander/Calibre-Remarkable-Device-Driver-Plugin","owner":"naclander","description":"Work in progress Calibre plugin to send files to a Remarkable Tablet","archived":true,"fork":false,"pushed_at":"2022-09-17T01:06:17.000Z","size":80,"stargazers_count":78,"open_issues_count":8,"forks_count":13,"subscribers_count":10,"default_branch":"main","last_synced_at":"2024-08-02T01:17:16.592Z","etag":null,"topics":["remarkable-tablet"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/naclander.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}},"created_at":"2021-02-04T03:21:26.000Z","updated_at":"2024-08-02T01:17:16.592Z","dependencies_parsed_at":"2022-09-03T22:20:14.413Z","dependency_job_id":null,"html_url":"https://github.com/naclander/Calibre-Remarkable-Device-Driver-Plugin","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naclander%2FCalibre-Remarkable-Device-Driver-Plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naclander%2FCalibre-Remarkable-Device-Driver-Plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naclander%2FCalibre-Remarkable-Device-Driver-Plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naclander%2FCalibre-Remarkable-Device-Driver-Plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/naclander","download_url":"https://codeload.github.com/naclander/Calibre-Remarkable-Device-Driver-Plugin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223838995,"owners_count":17211851,"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":["remarkable-tablet"],"created_at":"2024-08-02T01:01:36.119Z","updated_at":"2024-11-09T14:30:39.400Z","avatar_url":"https://github.com/naclander.png","language":"Python","funding_links":[],"categories":["Python","Other"],"sub_categories":["Template Builders"],"readme":"I am no longer actively maintainig this plugin myself, but I will continue to accept patches if anyone contributes improvements. \n\nSync your books to Remarkable with Calibre\n==========================================================\nThis Calibre plugin implements Calibre's [Device Plugin](https://manual.calibre-ebook.com/plugins.html#module-calibre.devices.interface), \nmaking the Remarkable  Tablet a device Calibre can communicate with, similar to other supported Ebook readers. \nThis plugin creates the folders and files within the Remarkable file structure, such that they are viewable using the \nRemarkable interface. It does not  simply copy files over in the filesystem, but integrates with the Calibre Document \nFormat, thanks to [remarkable-fs](https://github.com/nick8325/remarkable-fs).\n\nRequirements\n------------\nThis plugin relies on SSH communication between the machine running Calibre, and the Remarkable tablet. Please ensure\nthat you can successfully SSH to your Remarkable tablet.\n\nInstallation\n------------\nDownload the zipped version of this plugin, and install it in Calibre via the Plugin interface.\n\nIf you are a developer, you can install the source version of this plugin by running `calibre-customize -b` from the\nroot directory of this project to install the source code plugin directly. See \n`calibre-customize --help` for more detail.\n\nConfiguration\n-------------\nClicking on the plugin from Calibre's plugin interface brings up the settings box where you will see several values\nyou can customize:\n\n| Parameter     | Description                                                                                                                       | Default Value   |\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------|-----------------|\n| Remarkable IP | IP Address of Remarkable Tablet                                                                                                   | `\"10.11.99.1\"`  |\n| Books Path    | Path where you would like Calibre to transfer your books to on the device ( Folders will be created if they do not exist )        | `\"/\"`           |\n| Metadata Path | Location of calibre metadata file which is stored on the device                                                                   | `\"/home/root/\"` |\n| Password      | If not using SSH key, the SSH password for the Remarkable user                                                                    | `\"\"`            |\n\nUsage\n-----\nOnce the plugin is installed and configured, the plugin should work automatically. At Calibre startup, the plugin will attempt to find your Remarkable device, and ssh to it. If it succeeds you should see \"Device\" button at the top which shows your books on your Remarkable Tablet. \n\nTo send a book to your Remarkable Tablet, right click on the book, select \"send to device\" and then \"send to main memory\". The book will transfer and you should now see your book in the Device tab. If you want to remove a book, go to the Device tab, right click on the book and select to remove it.\n\nIf you start Calibre and you don't see the Device tab, most likely Calibre was not able to find or connect to your Remarkable tablet. Try running Calibre in debug using `calibre-debug -g` and see the messages in the console regarding trying to connect to the device.\n\nDevelopment\n-----------\nGit clone this repository. First run `create-plugin-zip.sh` in order to install the local dependencies. After making\nthe desired changes, run `calibre-customize -b ./ \u0026\u0026 calibre-debug -g ` from the  root project directory to install the\nlatest version of this plugin and launch Calibre.\n\nEnsure all plugin functionality still works and submit a patch.\n\nThis repo contains a submodule for remarkable-fs. Unfortunately the version of remarkable-fs in pypy and the current\nsource on the master branch are not in sync. I would ideally have liked to require remarkable-fs as a dependency and have\nthe user install the pip version. However, because the current pypy version is out of date and because have remarkable-fs\nincluded in the zipped plugin makes installation simpler for users I've decided just to include it in this repo. It is\nthe responsibility of this repo to keep the remarkable-fs submodule up to date. I would like to eventually stop\nincluding this submodule, and have a requirement of installing it with pip like other normal dependencies.\n\nArchitecture\n------------\nThis plugin sends files and creates folders by using `remarkable-fs` under the hood. Files and folders are created via\nRemarkable's custom format, which makes them viewable in the default Remarkable UI. This means you will not be able to\nsee them in the Linux filesystem directly.\n\nTo keep track of which books have been synced on the device, we create a `.calbire.json` metadata file which stores the\nCalibre state on the device. We try and maintain this file in sync with the state in Calibre.\n\nBugs\n----\nYes.\n\nThanks\n------\n[Calibre](https://github.com/kovidgoyal/calibre) for making a great ebook manager.\n\n[remarkable-fs](https://github.com/nick8325/remarkable-fs) for implementing a great API for \ncommunication with the Remarkable tablet.\n\nAll developers in the Remarkable community.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaclander%2FCalibre-Remarkable-Device-Driver-Plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnaclander%2FCalibre-Remarkable-Device-Driver-Plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaclander%2FCalibre-Remarkable-Device-Driver-Plugin/lists"}