Giter Club home page Giter Club logo

replayweb.page's Introduction

ReplayWeb.page

Serverless Web Archive Replay

Embedded Viewer Usage:

ReplayWeb.page provides a full web archive replay system running directly in the browser, available at: https://replayweb.page/

For full user docs, see: https://replayweb.page/docs.

See CHANGES.md for changes in the latest release.

The ReplayWeb.page App can be downloaded from the Releases page.

Embedding Guide

See the Embedding Guide for more info on embedding web archives in other sites.

What's in this repo

ReplayWeb.page is a static web site / offline web app + Electron app.

This repository contains the frontend UI for the replay system, while the backend is provided via a service worker implementation found at: https://github.com/webrecorder/wabac.js

The frontend is loaded from ui.js, while the backend service/web worker is loaded from sw.js.

This repository contains:

Running ReplayWeb.page

To run ReplayWeb.page and view web archives, a regular HTTP server is all that is needed.

ReplayWeb.page can run with any HTTP server locally. For example, you can run http-server -p 9990 or python -m http.server 9990 to run a static web server in the directory of this repository. Then, simply load http://localhost:9990/ and you'll have replayweb.page running locally.

Developing ReplayWeb.page

ReplayWeb.page is built as a Node package can be installed using yarn:

yarn install

It is also a Jekyll site for use with GitHub pages. Jekyll is only needed to build the docs.

The package provides various commands that can be used with yarn:

  • yarn run start-dev - to run in dev mode with Webpack dev server on port 9990. Autobuilds dev assets.

  • yarn run build - to build production assets sw.js, ui.js

  • yarn run start-prod - to run production site on port 9990, with previously built assets

  • yarn run start-electron - to start electron in dev mode, with previously built assets

  • yarn run dist - to build production assets + Electron app (in dist/)

  • yarn run build-docs - to build the Jekyll docs (for local use) and run Jekyll. Requires Ruby.

  • yarn run start-jekyll - to build Jekyll docs and start Jekyll static server on port 4000.

The static assets are placed in the root index.html, sw.js and ui.js, and can be used with any HTTP server.

For service workers to work, they must be served from either localhost or an HTTPS endpoint.

See the user docs for additional info about using ReplayWeb.page

LICENSE

ReplayWeb.page is made available under the AGPLv3 License.

If you would like to use it under a different license or have a question, please reach out as that may be a possibility.

Contributing and Bug Reports

Contributions are definitely welcome!

As this is still a new project and rapidly evolving, please open an issue first before submitting a pull request.

replayweb.page's People

Contributors

ikreymer avatar dependabot[bot] avatar matteocargnelutti avatar edsu avatar shrinks99 avatar suayoo avatar chickensoupwithrice avatar curtgrimes avatar pizzaisdavid avatar jnny avatar rangermauve avatar rebeccacremona avatar av8ta avatar renevoorburg avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.