monolith/README.md

[![Travis CI Build Status](https://travis-ci.org/Y2Z/monolith.svg?branch=master)](https://travis-ci.org/Y2Z/monolith)
[![AppVeyor Build status](https://ci.appveyor.com/api/projects/status/ae7soyjih8jg2bv7/branch/master?svg=true)](https://ci.appveyor.com/project/snshn/monolith/branch/master)


# monolith

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.

<!-- `This program works both on remote and local targets. -->

### Installation
    $ git clone https://github.com/Y2Z/monolith.git
    $ cd monolith
    $ cargo install --path .

### Usage
    $ monolith https://lyrics.github.io/db/p/portishead/dummy/roads/ > portishead-roads-lyrics.html

### Options
 - `-c`: Ignore styles
 - `-f`: Exclude iframes
 - `-i`: Remove images
 - `-I`: Isolate document
 - `-j`: Exclude JavaScript
 - `-k`: Accept invalid X.509 (TLS) certificates
 - `-s`: Silent mode
 - `-u`: Specify custom User-Agent

### Related Projects
 - `Pagesaver`: https://github.com/distributed-mind/pagesaver

### License
The Unlicense

<!-- Microtext -->
<sub>Keep in mind that `monolith` is not aware of your browser's session</sub>
Update README.md 2019-08-25 08:06:48 +02:00			`[![Travis CI Build Status](https://travis-ci.org/Y2Z/monolith.svg?branch=master)](https://travis-ci.org/Y2Z/monolith)`
Add CSP isolation, no CSS, and no iframe options 2019-09-22 02:06:00 +02:00			`[![AppVeyor Build status](https://ci.appveyor.com/api/projects/status/ae7soyjih8jg2bv7/branch/master?svg=true)](https://ci.appveyor.com/project/snshn/monolith/branch/master)`

Update README.md 2019-08-24 21:01:05 +02:00
			`# monolith`
Update README.md 2019-08-24 19:51:37 +02:00
Rewrite program in Rust 2019-08-23 05:17:15 +02:00			`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.`
first commit 2017-02-20 08:51:24 +01:00
Update README.md 2019-08-25 23:28:46 +02:00			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.
first commit 2017-02-20 08:51:24 +01:00
Update README.md 2019-08-25 23:28:46 +02:00			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.
first commit 2017-02-20 08:51:24 +01:00
Rewrite program in Rust 2019-08-23 05:17:15 +02:00			<!-- `This program works both on remote and local targets. -->
first commit 2017-02-20 08:51:24 +01:00
Rewrite program in Rust 2019-08-23 05:17:15 +02:00			`### Installation`
			`$ git clone https://github.com/Y2Z/monolith.git`
			`$ cd monolith`
cargo clippy 2019-08-23 20:24:45 +02:00			`$ cargo install --path .`
first commit 2017-02-20 08:51:24 +01:00
			`### Usage`
Update README.md 2019-08-23 09:38:31 +02:00			`$ monolith https://lyrics.github.io/db/p/portishead/dummy/roads/ > portishead-roads-lyrics.html`
first commit 2017-02-20 08:51:24 +01:00
			`### Options`
Add CSP isolation, no CSS, and no iframe options 2019-09-22 02:06:00 +02:00			- `-c`: Ignore styles
			- `-f`: Exclude iframes
Update README.md 2019-08-23 11:15:21 +02:00			- `-i`: Remove images
Add CSP isolation, no CSS, and no iframe options 2019-09-22 02:06:00 +02:00			- `-I`: Isolate document
Update README.md 2019-08-23 12:09:32 +02:00			- `-j`: Exclude JavaScript
Add flag to ignore errors related to TLS certificates 2019-08-27 05:17:36 +02:00			- `-k`: Accept invalid X.509 (TLS) certificates
Add flag for silent mode 2019-08-25 17:41:30 +02:00			- `-s`: Silent mode
Add -u flag for custom User-Agent 2019-08-23 20:33:18 +02:00			- `-u`: Specify custom User-Agent
first commit 2017-02-20 08:51:24 +01:00
add related projects 2019-10-07 13:57:02 +02:00			`### Related Projects`
			- `Pagesaver`: https://github.com/distributed-mind/pagesaver

first commit 2017-02-20 08:51:24 +01:00			`### License`
Rewrite program in Rust 2019-08-23 05:17:15 +02:00			`The Unlicense`

			`<!-- Microtext -->`
			<sub>Keep in mind that `monolith` is not aware of your browser's session</sub>