176 lines
5.2 KiB
Markdown
176 lines
5.2 KiB
Markdown
[](https://github.com/Y2Z/monolith/actions?query=workflow%3AGNU%2FLinux)
|
||
[](https://github.com/Y2Z/monolith/actions?query=workflow%3AmacOS)
|
||
[](https://github.com/Y2Z/monolith/actions?query=workflow%3AWindows)
|
||
|
||
```
|
||
_____ ______________ __________ ___________________ ___
|
||
| \ / \ | | | | | |
|
||
| \_/ __ \_| __ | | ___ ___ |__| |
|
||
| | | | | | | | | | | |
|
||
| |\ /| |__| _ |__| |____| | | | | __ |
|
||
| | \___/ | | \ | | | | | | |
|
||
|___| |__________| \_____________________| |___| |___| |___|
|
||
```
|
||
|
||
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](https://crates.io/crates/monolith)
|
||
|
||
```console
|
||
cargo install monolith
|
||
```
|
||
|
||
#### Via [Homebrew](https://formulae.brew.sh/formula/monolith) (macOS and GNU/Linux)
|
||
|
||
```console
|
||
brew install monolith
|
||
```
|
||
|
||
#### Via [MacPorts](https://ports.macports.org/port/monolith/summary) (macOS)
|
||
|
||
```console
|
||
sudo port install monolith
|
||
```
|
||
|
||
#### Using [Snapcraft](https://snapcraft.io/monolith) (GNU/Linux)
|
||
|
||
```console
|
||
snap install monolith
|
||
```
|
||
|
||
#### Using [FreeBSD packages](https://svnweb.freebsd.org/ports/head/www/monolith/) (FreeBSD)
|
||
|
||
```console
|
||
pkg install monolith
|
||
```
|
||
|
||
#### Using [FreeBSD ports](https://www.freshports.org/www/monolith/) (FreeBSD)
|
||
|
||
```console
|
||
cd /usr/ports/www/monolith/
|
||
make install clean
|
||
```
|
||
|
||
#### Using [pkgsrc](https://pkgsrc.se/www/monolith) (NetBSD, OpenBSD, Haiku, etc)
|
||
|
||
```console
|
||
cd /usr/pkgsrc/www/monolith
|
||
make install clean
|
||
```
|
||
|
||
#### Using [containers](https://www.docker.com/)
|
||
|
||
```console
|
||
docker build -t Y2Z/monolith .
|
||
sudo install -b dist/run-in-container.sh /usr/local/bin/monolith
|
||
```
|
||
|
||
#### From [source](https://github.com/Y2Z/monolith)
|
||
|
||
Dependency: `libssl`
|
||
|
||
```console
|
||
git clone https://github.com/Y2Z/monolith.git
|
||
cd monolith
|
||
make install
|
||
```
|
||
|
||
#### Using [pre-built binaries](https://github.com/Y2Z/monolith/releases) (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
|
||
|
||
```console
|
||
monolith https://lyrics.github.io/db/P/Portishead/Dummy/Roads/ -o portishead-roads-lyrics.html
|
||
```
|
||
|
||
```console
|
||
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.
|
||
|
||
|
||
---------------------------------------------------
|
||
|
||
|
||
## Related projects
|
||
|
||
- Monolith Chrome Extension: https://github.com/rhysd/monolith-of-web
|
||
- Pagesaver: https://github.com/distributed-mind/pagesaver
|
||
- Personal WayBack Machine: https://github.com/popey/pwbm
|
||
- Hako: https://github.com/dmpop/hako
|
||
- Monk: https://github.com/monk-dev/monk
|
||
|
||
|
||
---------------------------------------------------
|
||
|
||
|
||
## 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.
|
||
|
||
|
||
---------------------------------------------------
|
||
|
||
|
||
<!-- Microtext -->
|
||
<sub>Keep in mind that `monolith` is not aware of your browser’s session</sub>
|