master
Fabien Benetou 1 year ago
parent 67460f125d
commit e4a27f273d
  1. 24
      README.md

@ -1,32 +1,32 @@
!Offtopus, offline-octopus # Offtopus, offline-octopus
!!Goal ## Goal
Provide a way to connect local machines to work and tinker with efficiently, building prototypes with resilience in mind. Provide a way to connect local machines to work and tinker with efficiently, building prototypes with resilience in mind.
!!How does it work ## How does it work
It provides a Web server with endpoints for different functions, including listing machines joining that network, make functions available to that new network of machines, sharing files, etc. Note that the point is to build on top of it, consequently functions as endpoints here are solely examples. It provides a Web server with endpoints for different functions, including listing machines joining that network, make functions available to that new network of machines, sharing files, etc. Note that the point is to build on top of it, consequently functions as endpoints here are solely examples.
!!How to install ## How to install
# clone repository 1. clone repository
# install dependancies (no package.json yet) but mostly express missing, i.e `npm i express` 1. install dependancies (no package.json yet) but mostly express missing, i.e `npm i express`
# run e.g `node .` 1. run e.g `node .`
# connect to it locally first, e.g https://localhost:8082 (assumes existing SSL certificates) or https://localhost:8082/routes 1. connect to it locally first, e.g https://localhost:8082 (assumes existing SSL certificates) or https://localhost:8082/routes
Note that the cloudinit file is an example on a brand new machine. Note that the cloudinit file is an example on a brand new machine.
!!!tested on ### tested on
- Linux machines, e.g Ubuntu on desktop, RPi Zero - Linux machines, e.g Ubuntu on desktop, RPi Zero
- Android devices using Termux, e.g Quest 1 - Android devices using Termux, e.g Quest 1
- iOS via iSH - iOS via iSH
Most likely partially works on Windows with Linux subsystem. System commands, e.g shutdown, xrandr, etc must be adapted. Most likely partially works on Windows with Linux subsystem. System commands, e.g shutdown, xrandr, etc must be adapted.
!!!Developing and debugging ### Developing and debugging
- See the console REPL, starting with help() - See the console REPL, starting with help()
- see `/routes/json` to connect to all services - see `/routes/json` to connect to all services
!!Digging deeper ## Digging deeper
For an hour long video see https://video.benetou.fr/w/aR81WVHg6H3E93GPG4jYUg For an hour long video see https://video.benetou.fr/w/aR81WVHg6H3E93GPG4jYUg
!!!Inspiration ### Inspiration
- Xerox park paper on services making themselves available, coauthor including Trevor F Smith - Xerox park paper on services making themselves available, coauthor including Trevor F Smith

Loading…
Cancel
Save