Metadata-Version: 1.1
Name: remarkable-fs
Version: 0.1
Summary: A FUSE filesystem driver for the reMarkable tablet
Home-page: https://github.com/nick8325/remarkable-fs
Author: Nick Smallbone
Author-email: nick@smallbone.se
License: UNKNOWN
Description-Content-Type: UNKNOWN
Description: A FUSE filesystem driver for reMarkable
        =======================================
        
        ``remarkable-fs`` allows you to see the contents of your reMarkable as a normal
        folder on your computer. All your documents and folders are visible; you can
        copy documents to and from the reMarkable, create folders, and move and delete
        folders and files. You cannot, however, edit documents that are
        already on the reMarkable (apart from moving or deleting them).
        
        It supports PDF files, EPUB files, and handwritten notes, but does not
        yet support annotated PDFs (they are exported without annotations).
        
        *This software is in an early stage of development. I take no responsibility if
        it deletes your files or bricks your reMarkable! Do not use it if you are
        unwilling to lose all your documents. Use at your own risk!*
        
        Installation
        ------------
        
        ``remarkable-fs`` works on both Linux and macOS. Note that on macOS,
        copying files using the Finder does not yet work, you will have to use
        the terminal. To install it, you will need to have first installed:
        
        - FUSE. If on macOS, get this from the `Fuse for macOS`_ project. If
          on Linux, your package manager should have it.
        - ``pip``, the Python package installer. You can install this by running
          ``sudo easy_install pip`` in a terminal.
        
        .. _Fuse for macOS: https://osxfuse.github.io/
        
        Then, to install ``remarkable-fs``, run the following command in a
        terminal:
        
          sudo pip install remarkable-fs
        
        Running
        -------
        
        Make an empty directory on your computer. This directory is where your
        documents will appear. Then run ``remarkable-fs``. You will be
        prompted for the path to this directory; type it in. (On macOS, you
        can instead drag the directory to the terminal window at this point.)
        
        You will then be prompted for the root password of your reMarkable.
        You can find this by opening the settings menu of the reMarkable,
        choosing "About", scrolling to the very bottom, and finding the
        paragraph beginning: "To do so, this device acts as a USB ethernet
        device..." (If you don't want to have to type in the root password
        every time you run ``remarkable-fs``, follow the instructions on
        passwordless login from the `reMarkable wiki`_.)
        
        .. _reMarkable wiki: http://remarkablewiki.com/index.php?title=Methods_of_access#Setting_up_ssh-keys
        
        If all goes well, you will find all your documents in the directory
        you chose. You can copy PDF or EPUB files there, and they will appear
        on the reMarkable; you can also move files around. Go wild!
        
        (On macOS, your reMarkable will also appear in the finder under the
        menu Go -> Computer.)
        
        When you are finished, you can stop ``remarkable-fs`` by pressing ctrl-C.
        
        Note that your reMarkable will be unresponsive for the time you have
        ``remarkable-fs`` running. It should start responding as soon as you close
        ``remarkable-fs`` or unplug the USB cable. If for some reason it doesn't, you
        can force your reMarkable to restart by holding down the power button for five
        seconds, letting go, and then pressing the power button for another second.
        
        Copyright
        ---------
        
        The software is licensed under the MIT licence, apart from the file
        remarkable_fs/rM2svg.py. That file is is licensed under the GNU LGPL
        version 3, and is taken from https://github.com/phil777/maxio.
        
Keywords: remarkable fuse
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: System :: Hardware
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Utilities
