You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Sunshine 2539aac4c0
Merge pull request #265 from snshn/version-bump
4 days ago
.github/workflows Fix armhf build in cd.yml 5 months ago
assets/icon add raster icon along with its Blender scene 11 months ago
docs get rid of containers.md (now part of README.md) 3 months ago
snap Update snapcraft.yaml 11 months ago
src account for charset when creating data URLs 4 days ago
utils running in container instructions update 3 months ago
.adr-dir add ADR describing asset minimization 1 year ago
.gitignore add support for working with local assets 1 year ago
Cargo.lock bump version (2.5.0 -> 2.6.0) 4 days ago
Cargo.toml bump version (2.5.0 -> 2.6.0) 4 days ago
Dockerfile running in container instructions update 3 months ago
LICENSE switch license to CC0-1.0 3 months ago
Makefile forcefully set document's charset to UTF-8 3 months ago
README.md add option for saving document using custom encoding 4 days ago
monolith.nuspec add chocolatey spec 5 months ago

README.md

Monolith Build Status for GNU/Linux Monolith Build Status for macOS Monolith Build Status for Windows

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

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

Using Cargo

$ cargo install monolith

Via Homebrew (macOS and GNU/Linux)

$ brew 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 pre-built binaries (Windows, ARM-based devices, etc)

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

Using containers

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

From source

Dependency: libssl-dev

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

Usage

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

or

$ 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
  • -e: Ignore network errors
  • -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 browser’s session