save_url

A CLI utility to save any web page into a single, self-contained HTML file with an automatic and structured filename.

✨ Features

• Self-contained HTML: Bundles CSS, JavaScript, images, and fonts into a single offline .html file.
• Dedicated CLI Commands:
  • save_url / save_url_monolith: Ultra-fast, lightweight Rust-based capture using monolith without requiring a browser engine (default backend).
  • save_url_singlefile: High-fidelity capture supporting modern JavaScript/SPAs via single-file-cli with automatic anti-cookie banner suppression.
• Automatic Title Extraction: Retrieves the page title from downloaded content (with fallback to mechanize or interactive prompt).
• Structured Filenames: Names output files predictably by default with timestamp and page title:

  YYYYMMDD HHMM Page Title.html
  

• Customizable Output: Option to omit the date/time prefix (--notime).
• Colorful CLI Feedback: Displays operation status, error reporting, and humanized saved file sizes.

📋 Prerequisites

save_url relies on external backend executables available in your system $PATH:

1. Monolith (monolith) — Default Backend

Used by save_url (default) and save_url_monolith:

• Gentoo Linux: Available in turulomio's portage repository.
• Via Cargo (Rust):

  cargo install monolith
  

• Other Platforms / Prebuilt Binaries: Visit the monolith releases page.

2. SingleFile CLI (single-file-cli) — Alternative Backend

Used by save_url_singlefile. Requires Node.js and a Chromium-based browser (Chromium, Google Chrome, Brave, etc.):

npm install -g single-file-cli

🚀 Installation

Using pip / pipx

pip install save_url

Or with pipx (recommended for CLI tools):

pipx install save_url

Gentoo Linux

An ebuild is available in the myportage repository:

emerge -av www-apps/save_url

📖 Usage

Using Monolith Backend (save_url or save_url_monolith)

save_url https://www.kde.org
# o explícitamente:
save_url_monolith https://www.kde.org

Output example:

20260921 0752 KDE Community Home - KDE.org.html

Using SingleFile Backend (save_url_singlefile)

save_url_singlefile https://www.kde.org

Omit Date & Time Prefix

To save the file using only the page title:

save_url https://www.kde.org --notime
# o con singlefile:
save_url_singlefile https://www.kde.org --notime

Output example:

KDE Community Home - KDE.org.html

Command-Line Options

usage: save_url [-h] [--version] [--notime] url

Script to save an url in a single file with an automatic and structured name.

positional arguments:
  url         Url to save

options:
  -h, --help  show this help message and exit
  --version   show program's version number and exit
  --notime    Removes date and time from the beginning of the file name

🛠️ Development & Testing

This project uses Poetry and poethepoet for development tasks.

# Clone the repository
git clone https://github.com/turulomio/save_url.git
cd save_url

# Install dependencies
poetry install

# Run unit tests with coverage
poetry run poe test

# Manage and compile translations (Release only)
poetry run poe translate

📄 License

This project is licensed under the GPL-3.0-only License. See the LICENSE.txt file for details.

Developed by Mariano Muñoz (@turulomio).