Better instructions and rm2fb warning

This commit is contained in:
Emanuele 2021-01-04 10:48:44 +01:00
parent b95ec81dd9
commit 173c0e8d2a

View file

@ -13,6 +13,10 @@
* Clone a frame into separate window for reference * Clone a frame into separate window for reference
* Save screenshots as PNG * Save screenshots as PNG
> :warning: **For reMarkable 2 users** :warning::
> rMview should work out of the box with the stock firmware.
> If you use [`rm2fb`](https://github.com/ddvk/remarkable2-framebuffer) there are known compatibilities issues that are [being addressed](https://github.com/pl-semiotics/rM-vnc-server/issues/5).
> :loudspeaker: **Volunteers needed**: if you have experience with producing binary bundles with pyQt, and feel like contributing to the project, drop me a line! > :loudspeaker: **Volunteers needed**: if you have experience with producing binary bundles with pyQt, and feel like contributing to the project, drop me a line!
@ -44,22 +48,26 @@ Then, from anywhere, you can execute `rmview` from the command line.
The tool will ask for the connection parameters and then ask permission to install the VNC server on the tablet. The tool will ask for the connection parameters and then ask permission to install the VNC server on the tablet.
Press <kbd>Auto install</kbd> to proceed. Press <kbd>Auto install</kbd> to proceed.
If you plan to modify the source code, use `pip install -e .` so that when executing `rmview` you will be running your custom version.
### Manual installation ### Manual installation
Install the dependencies ([PyQt5][pyqt5], [Paramiko][paramiko], [Twisted][twisted]) with `pip` or `conda` manually: Install the dependencies ([PyQt5][pyqt5], [Paramiko][paramiko], [Twisted][twisted]) with `pip` or `conda` manually:
# install dependencies
pip pyqt5 paramiko twisted pip pyqt5 paramiko twisted
# build resources file
Then you can run the program with `python -m rmview`. pyrcc5 -o src/rmview/resources.py resources.qrc
On the reMarkable itself you need to install [rM-vnc-server][vnc] by copying the relevant binary from the `bin` folder: On the reMarkable itself you need to install [rM-vnc-server][vnc] by copying the relevant binary from the `bin` folder:
# For reMarkable 1 # For reMarkable 1
scp rM1-vnc-server-standalone REMARKABLE_ADDRESS:rM-vnc-server-standalone scp bin/rM1-vnc-server-standalone REMARKABLE_ADDRESS:rM-vnc-server-standalone
# For reMarkable 2 # For reMarkable 2
scp rM2-vnc-server-standalone REMARKABLE_ADDRESS:rM-vnc-server-standalone scp bin/rM2-vnc-server-standalone REMARKABLE_ADDRESS:rM-vnc-server-standalone
Then you can run the program with `python -m rmview`.
## Usage and configuration ## Usage and configuration