O O \ / O —— Cr —— O / \ O O |
Carbonyl |
Carbonyl is a Chromium based browser built to run in a terminal. Read the blog post.
It supports pretty much all Web APIs including WebGL, WebGPU, audio and video playback, animations, etc..
It's snappy, starts in less than a second, runs at 60 FPS, and idles at 0% CPU usage. It does not require a window server (i.e. works in a safe-mode console), and even runs through SSH.
Carbonyl originally started as html2svg
and is now the runtime behind it.
# Watch YouTube inside a Docker container
$ docker run -ti fathyb/carbonyl https://youtube.com
Lynx is the OG terminal web browser, and the oldest one still maintained.
Some might sound like pluses, but Browsh and Carbonyl let you disable most of those if you'd like
Browsh is the OG "normal browser into a terminal" project. It starts Firefox in headless mode and connects to it through an automation protocol.
As far as tested, the operating systems under are supported:
Few notes:
scripts/
directory are simple wrappers around gn
, ninja
, etc..Fetch Chromium's code.
$ ./scripts/gclient.sh sync
Any changes made to Chromium will be reverted, make sure to save any changes you made.
$ ./scripts/patches.sh apply
$ ./scripts/gn.sh args out/Default
Default
is the target name, you can use multiple ones and pick any name you'd like, i.e.:$ ./scripts/gn.sh args out/release $ ./scripts/gn.sh args out/debug # or if you'd like to build a multi-platform image $ ./scripts/gn.sh args out/arm64 $ ./scripts/gn.sh args out/amd64
When prompted, enter the following arguments:
import("//carbonyl/src/browser/args.gn")
# uncomment this to build for arm64
# target_cpu="arm64"
# uncomment this to enable ccache
# cc_wrapper="env CCACHE_SLOPPINESS=time_macros ccache"
# uncomment this if you're building for macOS
# use_lld=false
# uncomment this for a release build
# is_debug=false
# symbol_level=0
$ ./scripts/build.sh Default
This should produce the following outputs:
out/Default/headless_shell
: browser binaryout/Default/icudtl.dat
out/Default/libEGL.so
out/Default/libGLESv2.so
out/Default/v8_context_snapshot.bin
# Build arm64 Docker image using binaries from the Default target
$ ./scripts/docker-build.sh Default arm64
# Build amd64 Docker image using binaries from the Default target
$ ./scripts/docker-build.sh Default amd64
$ ./scripts/run.sh Default https://wikipedia.org