Skip to content

Commit 725b1ff

Browse files
committed
Documenting new setup and support for RM2, version bump
1 parent 693e709 commit 725b1ff

File tree

2 files changed

+38
-23
lines changed

2 files changed

+38
-23
lines changed

README.md

Lines changed: 37 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,65 @@
1-
# rMview: a fast live viewer for reMarkable 1
1+
# rMview: a fast live viewer for reMarkable 1 and 2
22

33
[![Demo](https://raw.githubusercontent.com/bordaigorl/rmview/vnc/screenshot.png)][demo]
44

55

66
## Features
77

88
* Demo [:rocket: here][demo]
9-
* Fast streaming of the screen of your reMarkable 1 to a window in your computer
9+
* Fast streaming of the screen of your reMarkable to a window in your computer
10+
* Support for reMarkable 1 and 2
1011
* UI for zooming, panning, rotating
1112
* Pen tracking: a pointer follows the position of the pen when hovering on the reMarkable
1213
* Clone a frame into separate window for reference
1314
* Save screenshots as PNG
1415

15-
> :warning: **WARNING** :warning::
16-
> rMview supports **reMarkable 1 only**, see [this issue](https://github.com/bordaigorl/rmview/issues/22).
17-
> Support for reMarkable 2 may come once it gets wider diffusion and a reliable method to stream the framebuffer data is found.
18-
1916

2017
> :loudspeaker: **Volunteers needed**: if you have experience with producing binary bundles with pyQt, and feel like contributing to the project, drop me a line!
2118
2219

20+
Check the [releases page](/bordaigorl/rmview/releases) for executable bundles.
21+
If there is no bundle for your operating system then follow the installation instructions below.
22+
23+
2324
## Installation
2425

25-
1. You will need [Python3][py3] on your computer.
26+
As a basic prerequisite you will need [Python3][py3] on your computer.
27+
28+
> :warning: Please make sure `pip` is pointing to the Python3 version if your system has Python2 as well.
29+
If not, use `pip3` instead of `pip` in what follows.
30+
31+
> :warning: **WARNING** :warning::
32+
> If you use [Anaconda][anaconda], please install the dependencies via `conda` (and not `pip`) then run `pip install .`.
2633
27-
> :warning: Please make sure `pip` is pointing to the Python3 version if your system has Python2 as well.
28-
If not, use `pip3` instead of `pip` in what follows.
34+
### Semi-automatic installation
2935

30-
2. The easiest installation method is by using pip, from the root folder of this repository:
36+
The easiest installation method is by using `pip`, from the root folder of this repository:
3137

3238
pip install .
3339

34-
which will install all required dependencies and install a new `rmview` command.
35-
Alternatively you may want to install the dependencies ([PyQt5][pyqt5], [Paramiko][paramiko], [Twisted][twisted]) with `pip` manually.
40+
(please note the command ends with a dot)
41+
which will install all required dependencies and install a new `rmview` command.
3642

43+
Then, from anywhere, you can execute `rmview` from the command line.
44+
The tool will ask for the connection parameters and then ask permission to install the VNC server on the tablet.
45+
Press <kbd>Auto install</kbd> to proceed.
3746

38-
3. On the reMarkable itself you need to install [rM-vnc-server][vnc] and its dependency [mxc_epdc_fb_damage](https://github.com/peter-sa/mxc_epdc_fb_damage).
39-
Instructions can be found in the [wiki](https://github.com/bordaigorl/rmview/wiki/How-to-run-the-VNC-based-version).
40-
This last step will be automated in the near future.
47+
## Manual installation
4148

42-
To run the tool after installation just run `rmview` from a console.
49+
Install the dependencies ([PyQt5][pyqt5], [Paramiko][paramiko], [Twisted][twisted]) with `pip` or `conda` manually:
4350

44-
> :warning: **WARNING** :warning::
45-
> If you use [Anaconda][anaconda], please install the dependencies via `conda` (and not `pip`) then run `pip install .`.
51+
pip pyqt5 paramiko twisted
52+
53+
Then you can run the program with `python -m rmview`.
54+
55+
On the reMarkable itself you need to install [rM-vnc-server][vnc] by copying the relevant binary from the `bin` folder:
56+
57+
# For reMarkable 1
58+
scp rM1-vnc-server-standalone REMARKABLE_ADDRESS:rM-vnc-server-standalone
59+
60+
# For reMarkable 2
61+
scp rM2-vnc-server-standalone REMARKABLE_ADDRESS:rM-vnc-server-standalone
4662

47-
Tested with Python 3.8.2, PyQt 5.14.2, MacOs 10.15.4, reMarkable firmware 2.1.1.3.
4863

4964
## Usage and configuration
5065

@@ -135,7 +150,7 @@ There are two versions of rMview, presenting the same interface but using differ
135150
* The "reStreamer-like" version, in the [`ssh` branch][ssh-branch]
136151

137152
In my tests, the VNC version is a clear winner.
138-
The `ssh` branch of this repo hosts the reStreamer-like version for those who prefer it, but I am not planning to update it.
153+
The `ssh` branch of this repo hosts the reStreamer-like version for those who prefer it, but it should be considered unmaintained.
139154

140155

141156
## Credits
@@ -145,7 +160,7 @@ I took inspiration from the following projects:
145160
- [QtImageViewer](https://github.com/marcel-goldschen-ohm/PyQtImageViewer/)
146161
- [remarkable_mouse](https://github.com/Evidlo/remarkable_mouse/)
147162
- [reStream](https://github.com/rien/reStream)
148-
- [rM-vnc-server](https://github.com/peter-sa/rM-vnc-server)
163+
- [rM-vnc-server][vnc]
149164
- [VNC client](https://github.com/sibson/vncdotool) originally written by Chris Liechti
150165

151166
Icons adapted from designs by Freepik, xnimrodx from www.flaticon.com
@@ -161,7 +176,7 @@ This project is not affiliated to, nor endorsed by, [reMarkable AS](https://rema
161176

162177
GPLv3
163178

164-
[vnc]: https://github.com/peter-sa/rM-vnc-server
179+
[vnc]: https://github.com/pl-semiotics/rM-vnc-server
165180
[demo]: https://www.reddit.com/r/RemarkableTablet/comments/gtjrqt/rmview_now_with_support_for_vnc/
166181
[ssh-branch]: https://github.com/bordaigorl/rmview/tree/ssh
167182
[vnc-branch]: https://github.com/bordaigorl/rmview/tree/vnc

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ def run(self):
3232

3333
setup(
3434
name='rmview',
35-
version='0.1',
35+
version='2.0',
3636
url='https://github.com/bordaigorl/rmview',
3737
description='rMview: a fast live viewer for reMarkable',
3838
author='bordaigorl',

0 commit comments

Comments
 (0)