Go to file
Jakub Jirutka 7c61b462dd disable unnecessary/unused regex features to reduce binary size
This will reduce the monolith binary size by ~15%.
2022-09-20 11:46:26 -04:00
.github/workflows update README files, set CI to ignore irrelevant paths 2021-10-20 15:31:54 -10:00
assets/icon add raster icon along with its Blender scene 2020-07-01 05:54:48 -04:00
dist update README files, set CI to ignore irrelevant paths 2021-10-20 15:31:54 -10:00
docs update Markdown files 2021-10-20 15:46:08 -10:00
snap Update snapcraft.yaml 2020-06-26 14:57:52 -04:00
src move to use http instead of https 2022-09-11 14:30:44 -04:00
tests add option to blacklist/whitelist domains 2022-09-01 13:35:52 -10:00
.adr-dir add ADR describing asset minimization 2020-03-15 23:04:03 -04:00
.gitignore add support for working with local assets 2020-03-22 15:48:23 -04:00
Cargo.lock disable unnecessary/unused regex features to reduce binary size 2022-09-20 11:46:26 -04:00
Cargo.toml disable unnecessary/unused regex features to reduce binary size 2022-09-20 11:46:26 -04:00
Dockerfile reduce size of docker image 2021-07-11 20:00:39 +02:00
LICENSE switch license to CC0-1.0 2021-02-28 19:54:46 -10:00
Makefile forcefully set document's charset to UTF-8 2021-02-23 23:35:35 -10:00
README.md add option to blacklist/whitelist domains 2022-09-01 13:35:52 -10:00
monolith.nuspec add chocolatey spec 2020-12-31 15:30:41 -10:00

README.md

monolith build status on GNU/Linux monolith build status on macOS monolith build status on Windows

 _____     ______________    __________      ___________________    ___
|     \   /              \  |          |    |                   |  |   |
|      \_/       __       \_|    __    |    |    ___     ___    |__|   |
|               |  |            |  |   |    |   |   |   |   |          |
|   |\     /|   |__|    _       |__|   |____|   |   |   |   |    __    |
|   | \___/ |          | \                      |   |   |   |   |  |   |
|___|       |__________|  \_____________________|   |___|   |___|  |___|

A data hoarders 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

Using Cargo

cargo install monolith

Via Homebrew (macOS and GNU/Linux)

brew install monolith

Via MacPorts (macOS)

sudo port install monolith

Using Snapcraft (GNU/Linux)

snap install monolith

Using FreeBSD packages (FreeBSD)

pkg install monolith

Using FreeBSD ports (FreeBSD)

cd /usr/ports/www/monolith/
make install clean

Using pkgsrc (NetBSD, OpenBSD, Haiku, etc)

cd /usr/pkgsrc/www/monolith
make install clean

Using containers

docker build -t Y2Z/monolith .
sudo install -b dist/run-in-container.sh /usr/local/bin/monolith

From source

Dependency: libssl

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

Using pre-built binaries (Windows, ARM-based devices, etc)

Every release contains pre-built binaries for Windows, GNU/Linux, as well as platforms with non-standard CPU architecture.


Usage

monolith https://lyrics.github.io/db/P/Portishead/Dummy/Roads/ -o portishead-roads-lyrics.html
cat index.html | monolith -aIiFfcMv -b https://original.site/ - > result.html

Options

  • -a: Exclude audio sources
  • -b: Use custom base URL
  • -c: Exclude CSS
  • -C: Save document using custom charset
  • -d: Allow retrieving assets only from specified domain(s)
  • -e: Ignore network errors
  • -E: Avoid retrieving assets located within specified domains
  • -f: Omit frames
  • -F: Exclude web fonts
  • -i: Remove images
  • -I: Isolate the document
  • -j: Exclude JavaScript
  • -k: Accept invalid X.509 (TLS) certificates
  • -M: Don't add timestamp and URL information
  • -n: Extract contents of NOSCRIPT elements
  • -o: Write output to file (use “-” for STDOUT)
  • -s: Be quiet
  • -t: Adjust network request timeout
  • -u: Provide custom User-Agent
  • -v: Exclude videos

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

To the extent possible under law, the author(s) have dedicated all copyright related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.


Keep in mind that monolith is not aware of your browsers session