Skip to content

ianb/pagearchive

 
 

Repository files navigation

Page Shot

Build Status Available on Test Pilot

This is a prototype for a product to create better ways of sharing and saving content, starting with screenshots, with a planned second phase of full-page archiving.

The project will be launched through Test Pilot at pageshot.net.

It is made up of both an add-on (using the Add-on SDK) and a website using Node.js. The add-on is in addon/, and the website is in server/

Ian has been blogging about the design, definition, and development process.

Installation and Setup

Install Postgres.

Install Node.js. Version 6.x is required.

Clone the repository.

There are two scripts to run the server locally and develop the add-on:

  • ./bin/run-server will run the server on localhost:10080 and automatically restart if there are changes
  • ./bin/run-addon will build the add-on, start Firefox with the add-on installed (you must have Nightly or Developer Edition)

By default, Page Shot will connect to a Postgres database on localhost:5432. To change which database and user it connects to set/export the environmental variables: RDS_USERNAME, RDS_PASSWORD, and RDS_HOSTNAME

The server will automatically setup the tables in your database, and keep them up to date over time (using pg-patcher).

If you have growl and growlnotify installed on Mac OS X, you will get growl notifications when the build has started and completed for the server and the add-on.

We apologize but we have no story for development on Windows (though the add-on runs on Windows).

Add-on auto-reloading

To make the auto-reloading of the add-on work, after you first start Firefox using run-addon you must manually install the autoinstaller add-on into your development profile. This will allow the script to push updates into the browser without browser restarts.

Participation

There is an IRC channel #pageshot on irc.mozilla.org (you can use this link for chat access via the web if you do not otherwise use IRC).

Planning and ideation is happening in the issue tracker. We use a pattern roughly like:

Issue tags otherwise aren't very structured. Research is primarily analysis of other products that do something interesting, or some source material that could provide insight. Input on these (things like "I like this product because...") is very helpful!

About

An experiment in creating static copies of sites

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 57.6%
  • Python 26.5%
  • CSS 9.4%
  • Shell 4.0%
  • Makefile 2.1%
  • HTML 0.4%