Osgood can be built from source by cloning the repository and running the following commands. This will require that you first install Rust and Node.js on your machine. Note that these are only required for building; they are unnecessary for running Osgood.
Osgood is built using Rust. Either run the command below or visit the Install Rust page for more details.
$ curl https://sh.rustup.rs -sSf | sh
Install Node.js and npm
Osgood therefore requires that such packages be downloaded during the build process. Once all necessary packages are present they're essentially concatenated together (via Webpack) and the resulting file is distributed with Osgood.
Run the following command to get a modern version of Node.js and npm:
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash
Run the following command to build Osgood:
$ cargo build
You can compile the project by running
cargo build. This command compiles V8,
which will likely take ~10-30 minutes on your machine. If you'd like to see
V8's progress, run
cargo build -vv instead.
To avoid unnecessary work, the build script will leverage any existing
depot_tools package the machine already has, if the script can find the
necessary commands in your
The build script can optionally use a custom or precompiled version of V8. To
tell the script to do this, set the
CUSTOM_V8 environment variable to the
path to the V8 folder.
There are a few packages you'll need before you'll be able to compile:
sudo apt install build-essential pkg-config libc++-dev libc++abi-dev \ clang libclang-dev libssl-dev
Arch Linux Users
depot_tools project has known issues when running on Arch Linux due
to assumptions the project makes about the version of Python referenced by the
python binary. Fixing this requires manual intervention; consider installing
depot-tools-git from the AUR.