#page #browser #web-services #html #service #slide #console

app rslide

A web service that allows you to move through multiple html pages in the browser like a slide, even without focusing on the app console or the browser

1 unstable release

0.1.0 Jan 1, 2022

#471 in Template engine

AGPL-3.0-or-later

31KB
439 lines

rslide

rslide is a web service that allows you to move through multiple html pages in the browser like a slide, even without focusing on the app console or the browser. Currently only supports Windows.

The new page is sent via WebSocket. It's not for an advantage, but I just want to try making something with WebSocket.

Install

You can download it at the release page.

Note that because it will setup keyboard hook, the anti-virus may not like it. If you have the concern, you can build it from source by fetching this repo of a certain version tag and run cargo build --release.

You can also install by cargo install rslide.

Config

The app reads config from environment variable, with dotenv supports.

Variable Description Default Value Required
LISTEN Address the web service listens. The page can be viewed at /.
TEMPLATE_PAGE The path of the template page
PAGE_LIST The page of the page list file
ASSETS_DIR The page of the assets directory
HEARTBEAT The duration of each heartbeat for keeping WebSocket alive. 1s
TIMEOUT The duration of the timeout for waiting heartbeat response. 10s
PREV_CODE The scancode of the key that switches to the previous page. 26 (the [ key)
NEXT_CODE The scancode of the key that switches to the next page. 27 (the ] key)

It uses humantime to parse the duration like HEARTBEAT and TIMEOUT .

Template Page

The template page is the skeleton of the pages. It should contains an element with id mainHtml, whose innerHtml will be set to the current page.

Template page doesn't support reloading. The change of the template page file won't take effect until you start a new service.

Page List File

This file contains a list of the pathes of the html files of the pages, absolute or relative to this list file, line by line.

Pages listed in the file support reloading. The change of a page will take effect when refreshing or switch away and switch back to this page.

Assets Directory

Optionally you can set a assets directory path, which will map to the /assets path in the web service.

Dependencies

~29MB
~624K SLoC