Files

zefie bd1ef1415c v0.7.2

- Rename project
- Add GPL3 License (RETROACTIVE)
- Fill out package.json
- Switch crc16 module to hopefully improve Windows end-user experience
- Update README

2021-07-17 18:50:20 -04:00

2.9 KiB

Raw Blame History

wtv minisrv node.js

The wtv minisrv, or "zefie_wtvp_minisrv" project is a node.js project that provides a mini WebTV Server, aiming for full WTVP (WebTV Protocol) support. This open source server is in alpha status. Use at your own risk.

Current status:

Supports most known WebTV service encryption scenarios, for full trusted box access
Can handle client "relogin" and "reconnect" events
Suports .async.js service files with asynchronous requests
Supports multiple simultaneous users
WebTV-compatible HTTP Proxy (via minisrv, or using an external proxy for enhanced features (such as WebOne)

Current issues:

May not run on non-development Windows machines (VS2019 with nodejs and python)
Power cycling box and re-connecting via ConnectSetup may invalidate encryption until server is restarted
wtv-update:/update does not yet function as intended
wtv-flashrom features do not yet function as intended
HTTPS Proxying untested, likely needs SSL spoofing with self-signed solution

Won't fix:

wtv-encryption stream breaks when two different sessions have the same SSID (eg spoofing, won't fix (production did it too))
No intentions to support user accounts, registration, or any form of database system

Feature Todo:

~~(maybe) implement HTTP proxy (needs to be able to defluff most of the web, think retro WAP converter)~~ Done
~~(maybe) enable "internet mode" (let user outside of minisrv)~~ Done
Flashrom flashing functionality (at least for LC2 and higher)
SSID/IP black/whitelisting (including tying SSID to an IP or multiple IPs)
(maybe) Proper wtv-star (generic service outage page) support (maybe useful for allowing a unit to multiple sub-minisrvs).
(maybe) wtvchat stuff
(probably not) url tokenizer (eg wtv-token-blabla, was mostly to secure service URLs from unintended access, which this server does not aim to do)

How To Use:

Install node.js. Be sure to say Yes when asked about Chocolatey.
If you have trouble running it on Windows, try a Linux machine, Windows may need a full development enviroment or extra steps.
Download a snapshot (either of master, or of any commit/branch/relase/tag etc)
Extract zip somewhere and enter that directory with a command prompt
Enter zefie_wtvp_minisrv subdirectory
Verify you are in the same directory as app.js, then run npm install
Check any configuration, and modify to your liking. Especally service_ip (config can be found in services.json)
Run node app.js
Test with a WebTV Viewer or connect with a real box
To connect with a real box, you will need to open ports in your firewall and have a way to connect your WebTV (and preferably reroute 10.0.0.1 to the server)

2.9 KiB Raw Blame History