Unchrome Launcher

Unchrome Launcher is a simple command line tool use to update and run an instance of Unchrome Chromium.

1. Installation

You can install Unchrome Launcher using [scoop](https://scoop.sh/). It is in the unchrome_launcher bucket:

# Add my scoops.
> scoop bucket add jlanzarotta https://github.com/jlanzarotta/scoops

# Install Unchrome Launcher.
> scoop install jlanzarotta/unchrome_launcher

1.1. Other operating systems

To install Unchrome Launcher, simply unzip the archive for your specific operating system into the directory of your choice.

2. Configuration

When Unchrome Launcher starts up, it checks to make sure there is a default configuration file. If it does not exist, it is automatically created for you.

Note	Unchrome Launcher support the use of the XDG Base Directory Specification. For more information https://specifications.freedesktop.org/basedir-spec/latest/

Unchrome Launcher uses the following precedence order when determining where the configuration file is located. Each item listed, takes precedence over the item below it:

Microsoft Windows®

%XDG_CONFIG_HOME%/unchrome_launcher/.unchrome_launcher.yaml %USERPROFILE%/.unchrome_launcher.yaml

2.1. Default Configuration

The default Microsoft Windows® Unchrome Launcher configuration is as follows. These configuration options can be modified by the user after installation.

bin_directory: bin (1)
chrome_command_line_options: --no-default-browser-check (2)
chrome_distribution: unchrome (3)
debug: false (4)
download_directory: download (5)
installed_release: "" (6)
pause_after_run: false (7)

1. The directory there Unchrome Launcher will install the Unchrome Chromium runtime files.

2. Any additional command-line options used when running Chromium.

3. Which Chrome distribution you would like to use. Either unchrome or cromite. The default is unchrome.

4. If debug information should be shown or not, and written to debug file.

5. The directory where Unchrome Launcher downloads the latest release of Unchrome Chromium.

6. The version number of the installed version of Unchrome Chromium.

7. If Unchrome Launcher should pause after a successful run.

2.2. Default Browser

Unchrome Launcher has feature to use portable Chromium as default browser and it will be open links from another programs through Unchrome Launcher.

• start "SetDefaultBrowser.bat" (as admin).

• start "Control panel" → "Default programs" → "Set your default programs" → "Unchrome Launcher" and set all checkboxes on.

3. Copyright and License

BSD 3-Clause License

Copyright (c) 2018-2025, Jeff Lanzarotta All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice,this list of conditions, and the following disclaimer in the documentation and/or other materials provided with the distribution.

3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.