This repository contains a small webserver that can serve the contents of a
linux framebuffer device as video over HTTP. The video is encoded as a series
of PNGs, which are served in a multipart/x-mixed-replace stream. The primary
use case is to stream a reMarkable screen to a computer and share
it from there via video-conferencing or capturing it. For that reason, there is
also a proxy-mode, which streams the frames as raw, uncompressed data from the
remarkable and can then do the png-encoding on a more powerful machine.
Whithout that, the framerate is one or two frames per second, which might not
be acceptable (it might be, though).
This should be considered a tech demo in the current state. The code is not particularly clean, it's not in any way secured, probably not very efficient and it's taylored specifically to the reMarkable (e.g. it can only stream 16-bit grayscale images). Feel free to use it and report any bugs you find, but I don't make any promises in regards to support or stability and any issues not directly related to my usecase will likely be closed.
You can see a short video demonstrating this in this tweet
Note: This project is not compatible with the reMarkable 2 and I don't intend to change that. In general, you should consider this project in maintenance mode at best - I don't regularly use it anymore, so I'm not really incentivized to improve it.
You need a working Go installation and ssh-access to your reMarkable. You can then obtain, install and run the code via
go get -d -u github.com/Merovius/srvfb
GOARCH=arm GOARM=7 GOOS=linux go build github.com/Merovius/srvfb
scp srvfb root@10.11.99.1:
ssh root@10.11.99.1 ./srvfb -device /dev/fb0 -listen :1234
If you then open http://10.11.99.1:1234/ in your browser (only Chrome is
tested) you should see the stream from your reMarkable. To use proxy-mode, run
(in a separate terminal)
go build github.com/Merovius/srvfb
./srvfb -listen localhost:1234 -proxy 10.11.99.1:1234
and open http://localhost:1234/ in your browser.
Once you can see the reMarkable screen in your browser (via proxy or not), clicking on the image should rotate it by 90°.
This repository also contains systemd unit files to run srvfb automatically
(using socket activation). For security reasons, it only listens on the USB
network, though. To use it, run
cd $(go env GOPATH)/src/github.com/Merovius/srvfb
GOARCH=arm GOOS=linux go build github.com/Merovius/srvfb
scp srvfb root@10.11.99.1:/usr/bin
scp contrib/srvfb.service contrib/srvfb.socket root@10.11.99.1:/etc/systemd/system
ssh root@10.11.99.1 systemctl enable --now srvfb.socket
Apart where otherwise noted, this code is published under the Apache License, Version 2.0:
Copyright 2018 Axel Wagner
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.