SingleFile README

The project's README from github.com/gildas-lormeau/SingleFile. As one markdown file: README.md.

SingleFile

SingleFile helps you to save a complete web page into a single HTML file. SingleFile is a Web Extension (and a CLI tool) compatible with Chrome, Firefox (Desktop and Mobile), Microsoft Edge, Safari, Vivaldi, Brave, Waterfox, Yandex browser, and Opera.

Table of Contents

Demo

https://user-images.githubusercontent.com/396787/156664907-cc458e35-f41b-45ca-91eb-372213812b44.mp4

Install

SingleFile can be installed from the store of:

You can also download the zip file (https://github.com/gildas-lormeau/SingleFile/archive/master.zip) of the project and install it manually by unzipping it somewhere on your disk and following these instructions:

Getting started

Additional notes

FAQ

See https://github.com/gildas-lormeau/SingleFile/blob/master/faq.md

Release notes

See https://addons.mozilla.org/firefox/addon/single-file/versions/

Known Issues and Troubleshooting

See https://github.com/gildas-lormeau/SingleFile/blob/master/known-issues.md

Command Line Interface (SingleFile CLI)

You can save web pages to HTML from the command line interface. See here for more info: https://github.com/gildas-lormeau/single-file-cli.

Integration with user scripts

You can execute a user script just before (and after) SingleFile saves a page. For more info, see https://github.com/gildas-lormeau/SingleFile/wiki/How-to-execute-a-user-script-before-a-page-is-saved.

File format comparison

| | HTML | Self-extracting ZIP | MHTML | Webarchive (Safari) | HTML+folder | | --- | :---: | :---: | :---: | :---: | :---: | | Pages are saved as a single file | ✓ | ✓ | ✓ | ✓ | | | HTML and styles are minified | ✓ | ✓ | | | | | Unused HTML and styles are removed from files | ✓ | ✓ | | | | | Binary resources are not encoded in base 64 | | ✓ | | ✓ | ✓ | | Files are compressed | | ✓ | | | | | Files can be viewed without installing any extension | ✓ | ✓¹ | ✓² | ✓³ | ✓ | | Files can be viewed without running JavaScript | ✓ | | ✓ | ✓ | ✓ | | Files can be unzipped to extract page resources | | ✓ | | | n/a | | Files contains the text of the page (plain or formatted) which can be indexed | ✓ | ✓⁴ | ✓ | ✓ | ✓ |

Footnotes:

¹ When using the "universal" self-extracting file format

² Only in Chromium-based browsers, and Internet Explorer

³ Only in Safari

⁴ An option must be enabled in the extension

Projects using/compatible with SingleFile

Privacy Policy

See https://github.com/gildas-lormeau/SingleFile/blob/master/privacy.md

Contributors

See https://github.com/gildas-lormeau/SingleFile/blob/master/contributors.md

Code derived from third party projects

Icons

License

SingleFile is licensed under AGPL. Code derived from third-party projects is licensed under MIT. Please contact me at gildas.lormeau <at> gmail.com if you are interested in licensing the SingleFile code for a commercial service or product.

Suggestions are welcome :)

SingleFile (gildas-lormeau/SingleFile)

Searching Database…

Что это такое?SingleFile — это браузерное расширение, которое сохраняет полную и точную копию любой веб-страницы в один HTML-файл, который можно хранить и открыть позже.
Это браузерное расширение или приложение для компьютера?Это браузерное расширение, которое живёт на панели инструментов вашего браузера, а не отдельная программа для компьютера. Есть ещё отдельная утилита для командной строки, SingleFile CLI, для сохранения страниц из терминала.
Как его установить и сохранить первую страницу?Установите из магазина вашего браузера (Firefox, Firefox for Android, Chrome, Safari, Edge) или вручную из zip-архива релиза. Затем нажмите кнопку SingleFile на панели инструментов, чтобы сохранить страницу, или используйте сочетание клавиш Ctrl+Shift+Y.
Сможет ли кто-то открыть мою сохранённую страницу без установки SingleFile?Да — стандартный одиночный HTML-файл открывается в любом браузере без расширения и без JavaScript. Файлы MHTML открываются только в браузерах на Chromium и в Internet Explorer, веб-архивы Safari — только в Safari, а самораспаковывающиеся ZIP-файлы требуют JavaScript, если только они не используют универсальный формат.
С какими браузерами можно его использовать?Chrome, Firefox (на компьютере и мобильный), Microsoft Edge, Safari (macOS и iOS), Vivaldi, Brave, Waterfox, Яндекс Браузер и Opera.
Куда попадают сохранённые страницы — на мой компьютер или на сервер?По умолчанию они остаются локально: страницы сохраняются в папку загрузок, настроенную в вашем браузере. При желании в настройках можно включить сохранение на Google Диск или загрузку на GitHub.
Можно пользоваться бесплатно, в том числе в коммерческих целях?Это бесплатный проект с открытым исходным кодом под лицензией AGPL, а сторонний производный код — под MIT. Чтобы использовать код SingleFile в коммерческом сервисе или продукте, автор просит связаться с ним по поводу лицензирования.
Можно ли выделять текст или добавлять заметки на страницу перед сохранением?Да. Выберите пункт 'Annotate and save the page...' в контекстном меню, чтобы выделить текст, добавить заметки или удалить лишний контент перед сохранением страницы.
Умеет ли он сохранять страницы автоматически во время просмотра?Да. Автосохранение можно включить для текущей вкладки, всех откреплённых вкладок или всех вкладок сразу — тогда каждая страница сохраняется автоматически после загрузки. Также можно одним кликом сохранить пачкой выбранные, откреплённые или все вкладки.
Что за опция подтверждения существования (proof-of-existence)?Это опция, которая записывает SHA-256 хэш сохранённой страницы в блокчейн, чтобы позже можно было доказать, что страница существовала именно в таком виде.
Есть ли другие инструменты, построенные на SingleFile?Да — ArchiveBox для веб-архивирования, менеджеры закладок linkding, Linkwarden и Karakeep, читалка электронных книг KOReader, Zotero Connector и плагин для Obsidian для чтения сохранённых страниц — все они работают с файлами SingleFile.
Size
345.6 MB
Stars
22.6K
Age
16y
Commits · 90 Days