1
0
Fork 0
archivebox/README.md

61 lines
2.1 KiB
Markdown
Raw Normal View History

2017-05-05 05:10:50 -04:00
# Pocket Stream Archive
2017-05-05 05:15:19 -04:00
(Your own personal Way-Back Machine)
Save an archived copy of all websites you star using Pocket, indexed in an html file.
2017-05-05 05:10:50 -04:00
![](screenshot.png)
## Quickstart
**Dependencies:** Google Chrome headless, wget
```bash
brew install Caskroom/versions/google-chrome-canary
brew install wget
# OR on linux
wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
sudo sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list'
apt update; apt install google-chrome-beta
```
**Usage:**
1. Download your pocket export file `ril_export.html` from https://getpocket.com/export
2. Download this repo `git clone https://github.com/pirate/pocket-archive-stream`
3. `cd pocket-archive-stream/`
2017-05-05 05:15:19 -04:00
4. `./archive.py ~/Downloads/ril_export.html`
2017-05-05 05:10:50 -04:00
It produces a folder `pocket/` containing an `index.html`, and archived copies of all the sites,
organized by timestamp. For each sites it saves:
2017-05-05 05:15:19 -04:00
2017-05-05 05:10:50 -04:00
- wget of site, with .html appended if not present
- screenshot of site using headless chrome
- PDF of site using headless chrome
The wget archive is suitable for serving on your personal server, you can upload the pocket
archive to `/var/www/pocket` and allow people to access your saved copies of sites.
## Info
2017-05-05 05:15:19 -04:00
This is basically an open-source version of [Pocket Premium](https://getpocket.com/).
I got tired of sites I saved going offline or changing their URLS, so I started
archiving a copy of them locally now, similar to The Way-Back Machine provided
by [archive.org](https://archive.org).
2017-05-05 05:10:50 -04:00
Now I can rest soundly knowing important articles and resources I like wont dissapear off the internet.
2017-05-05 05:15:19 -04:00
[sweeting.me/pocket](https://home.sweeting.me/pocket)
## Security WARNING
2017-05-05 05:10:50 -04:00
Hosting other people's site content has security implications for your domain, make sure you understand
the dangers of hosting other people's CSS & JS files on your domain. It's best to put this on a domain
of its own to slightly mitigate CSRF attacks.
It might also be prudent to blacklist your archive in your `robots.txt` so that search engines dont index
the content on your domain.