Go to file
Sunshine 59a8be493d
add support for working with local assets
2020-03-22 15:48:23 -04:00
docs Merge pull request #133 from Y2Z/docker-instructions 2020-03-18 00:42:40 -04:00
snap Update snapcraft configuration 2020-01-13 11:14:08 +00:00
src add support for working with local assets 2020-03-22 15:48:23 -04:00
.adr-dir add ADR describing asset minimization 2020-03-15 23:04:03 -04:00
.appveyor.yml add black box tests 2020-02-23 22:48:14 -05:00
.gitignore add support for working with local assets 2020-03-22 15:48:23 -04:00
.travis.yml add support for working with local assets 2020-03-22 15:48:23 -04:00
Cargo.lock add black box tests 2020-02-23 22:48:14 -05:00
Cargo.toml add black box tests 2020-02-23 22:48:14 -05:00
Dockerfile add Dockerfile 2020-03-05 04:14:37 -05:00
LICENSE Rewrite program in Rust 2019-08-22 23:17:15 -04:00
Makefile add black box tests 2020-02-23 22:48:14 -05:00
README.md move Docker instructions into docs/ 2020-03-14 12:51:05 -04:00

README.md

Travis CI Build Status AppVeyor Build status

 ___     ___________    __________      ___________________    ___
|   \   /           \  |          |    |                   |  |   |
|    \_/     __      \_|    __    |    |    ___     ___    |__|   |
|           |  |           |  |   |    |   |   |   |   |          |
|           |__|    _      |__|   |____|   |   |   |   |    __    |
|   |\_/|          | \                     |   |   |   |   |  |   |
|___|   |__________|  \____________________|   |___|   |___|  |___|

A data hoarder's dream come true: bundle any web page into a single HTML file. You can finally replace that gazillion of open tabs with a gazillion of .html files stored somewhere on your precious little drive.

Unlike the conventional "Save page as", monolith not only saves the target document, it embeds CSS, image, and JavaScript assets all at once, producing a single HTML5 document that is a joy to store and share.

If compared to saving websites with wget -mpk, this tool embeds all assets as data URLs and therefore lets browsers render the saved page exactly the way it was on the Internet, even when no network connection is available.


Installation

From source

$ git clone https://github.com/Y2Z/monolith.git
$ cd monolith
$ make install

With Homebrew (on macOS and GNU/Linux)

$ brew install monolith

Using Snapcraft (on GNU/Linux)

$ snap install monolith

Via Docker

The guide can be found here


Usage

$ monolith https://lyrics.github.io/db/P/Portishead/Dummy/Roads/ -o portishead-roads-lyrics.html

Options

  • -c: Ignore styles
  • -f: Exclude frames and iframes
  • -i: Remove images
  • -I: Isolate the document
  • -j: Exclude JavaScript
  • -k: Accept invalid X.509 (TLS) certificates
  • -o: Write output to file
  • -s: Silent mode
  • -t: Set custom network request timeout
  • -u: Provide own User-Agent

HTTPS and HTTP proxies

Please set https_proxy, http_proxy, and no_proxy environment variables.


Contributing

Please open an issue if something is wrong, that helps make this project better.



License

The Unlicense


Keep in mind that monolith is not aware of your browser's session