Scroll to navigation

webhttrack(1) General Commands Manual webhttrack(1)

NAME

webhttrack - offline browser : copy websites to a local directory

SYNOPSIS

webhttrack [browse] [htsserver option value ..] [key value ..]

DESCRIPTION

webhttrack starts the htsserver(1) web server and opens the WebHTTrack interface in a browser. The interface drives the httrack(1) engine to copy websites to a local directory, by default ~/websites. The server stops once the interface is closed.

OPTIONS

open the mirrored projects (~/websites/index.html) instead
passed to htsserver (default: the first free port from 8080)
passed to htsserver (default: 127.0.0.1)
passed to htsserver
any other pair is passed to htsserver
print this help and exit
print the version and exit

EXAMPLES

open the interface
webhttrack browse
open the mirrored projects without starting the interface

ENVIRONMENT

The browser to open, through xdg-open or sensible-browser. Without it, webhttrack tries a list of known browsers.
The first one set picks the language of the interface, until the interface saves its own choice in ~/.httrack.ini.
Projects are kept in ~/websites unless the interface has saved another folder.

FILES

~/.httrack.ini

The interface settings. Its path= line names the projects directory that browse opens.
~/.httrack.css
A stylesheet the interface loads after its own, to change its look. Without it, the interface reads .httrack.css in the projects directory, then httrack.css next to the system httrack.conf.
~/.httrack-ui.ini
The theme chosen on the welcome page.
html/server/themes/
This folder sits in the httrack data directory, for example /usr/share/httrack. Each folder in it that holds a theme.css is a theme the welcome page offers. A theme loads before ~/.httrack.css.
~/.httrack/themes/
Themes for this user only, laid out the same way. A theme here replaces the installed theme of the same name, all its files included.

DIAGNOSTICS

Each mirror writes its errors and warnings to hts-log.txt in the project directory.

BUGS

Please reports bugs to <bugs@httrack.com>. Include a complete, self-contained example that will allow the bug to be reproduced, and say which version of httrack you are using. Do not forget to detail options used, OS version, and any other information you deem necessary.

COPYRIGHT

Copyright (C) 1998-2026 Xavier Roche and other contributors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

AVAILABILITY

The most recent released version of httrack can be found at: https://www.httrack.com

AUTHOR

Xavier Roche <roche@httrack.com>

SEE ALSO

The HTML documentation (available online at https://www.httrack.com/html/ ) contains more detailed information. Please also refer to the httrack FAQ (available online at https://www.httrack.com/html/faq.html )

The server is htsserver(1), and the command-line engine is httrack(1).

28 October 2026 httrack website copier