capsulecode/singlefile repository overview

⁠SingleFile CLI (Command Line Interface)

⁠Introduction

SingleFile⁠ can be launched from the command line by running it into a (headless) browser.

It runs through Deno as a standalone script injected into the web page via the Chrome DevTools Protocol instead of being embedded into a WebExtension.

⁠Installation with Docker

• Installation from Docker Hub

  docker pull capsulecode/singlefile

  docker tag capsulecode/singlefile singlefile

• Manual installation

  git clone --depth 1 --recursive https://github.com/gildas-lormeau/single-file-cli.git

  cd single-file-cli

  docker build --no-cache -t singlefile .

• Run

  docker run singlefile "https://www.wikipedia.org"

• Run and redirect the result into a file

  docker run singlefile "https://www.wikipedia.org" > wikipedia.html

• Run and mount a volume to get the saved file in the current directory

  • Save one page

    docker run -v %cd%:/usr/src/app/out singlefile "https://www.wikipedia.org" wikipedia.html (Windows)

    docker run -v $(pwd):/usr/src/app/out singlefile "https://www.wikipedia.org" wikipedia.html (Linux/UNIX)

  • Save one or multiple pages by using the filename template (see --filename-template option)

    docker run -v %cd%:/usr/src/app/out singlefile "https://www.wikipedia.org" --dump-content=false (Windows)

    docker run -v $(pwd):/usr/src/app/out singlefile "https://www.wikipedia.org" --dump-content=false (Linux/UNIX)

⁠License

SingleFile and SingleFile CLI are 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.