chromium(1)

📦
version 156.0.8078.79 · 4 versions
, in debian bookworm, debian trixie

💖 chromium — the manual page, but make it make sense 💖

okay bestie, so this is chromium(1), a USER COMMAND, and it's literally just the manual page for the web browser from Google. let's get into it 🦋

🌸 NAME 🌸

chromium — the web browser from Google. that's it, that's the name, iconic behavior honestly 👑

✨ SYNOPSIS ✨

chromium [OPTION] [PATH|URL]

so you give it options, and/or a path or a URL, and it does the thing. periodt 💅

🎀 DESCRIPTION 🎀

if you actually need help using the browser (like, the buttons and the tabs and stuff), go read the Google Chrome help center:

<https://support.google.com/chrome/>

this manpage is NOT about that. this manpage only describes invocation, environment, and arguments — the command-line girly stuff. no cap. 💖

🔥 OPTIONS 🔥

so real talk: chromium has hundreds of undocumented command-line flags that get added and removed at the whim of the developers 😭 like they're just out here vibing. here, we document the relatively stable ones. the ones that won't ghost you.

  • -h or --help — show help output. the classic.
  • -g or --debug — start a debugging session within /usr/bin/gdb. yes bestie, straight into gdb, main character energy 🫶
  • --temp-profile — use a throw-away/temporary profile for this session. it creates an entirely new user profile temporarily. and listen — it is not the same as incognito mode. do not conflate them, i'm begging 🙈
  • --enable-remote-extensions — allow installation and updates of remote extensions.
  • --user-data-dir=DIR — specifies the directory that user data (your "profile") is kept in. defaults to $HOME/.config/chromium. important: separate instances of chromium must use separate user data directories, and repeated invocations of chromium will reuse an existing process for a given user data directory. so like, they share. it's giving roommate situation.
  • --incognito — open in incognito mode. you know what you did 😏
  • --new-window — if PATH or URL is given, open it in a new window.
  • --proxy-server=host:port — specify the HTTP/SOCKS4/SOCKS5 proxy server to use for requests. this overrides any environment variables or settings picked via the options dialog. an individual proxy server is specified using the format:
[<proxy-scheme>://]<proxy-host>[:<proxy-port>]

where <proxy-scheme> is the protocol of the proxy server, and is one of:

"http", "socks", "socks4", "socks5".

if the <proxy-scheme> is omitted, it defaults to "http". also note that "socks" is equivalent to "socks5". (they're the same picture, fr fr.)

examples:

--proxy-server="foopy:99"
    Use the HTTP proxy "foopy:99" to load all URLs.

--proxy-server="socks://foobar:1080"
    Use the SOCKS v5 proxy "foobar:1080" to load all URLs.

--proxy-server="socks4://foobar:1080"
    Use the SOCKS v4 proxy "foobar:1080" to load all URLs.

--proxy-server="socks5://foobar:66"
    Use the SOCKS v5 proxy "foobar:66" to load all URLs.

it is also possible to specify a separate proxy server for different URL types, by prefixing the proxy server specifier with a URL specifier:

example:

--proxy-server="https=proxy1:80;http=socks4://baz:1080"
    Load https://* URLs using the HTTP proxy "proxy1:80". And load http://*
    URLs using the SOCKS v4 proxy "baz:1080".

like, you can have a whole roster of proxies. a little squad. 💜

  • --no-proxy-server — disables the proxy server. overrides any environment variables or settings picked via the options dialog.
  • --proxy-auto-detect — autodetect proxy configuration. overrides any environment variables or settings picked via the options dialog.
  • --proxy-pac-url=URL — specify proxy autoconfiguration URL. overrides any environment variables or settings picked via the options dialog.
  • --password-store=<basic|gnome|kwallet> — set the password store to use. the default is to automatically detect based on the desktop environment. basic selects the built in, unencrypted password store. gnome selects Gnome keyring. kwallet selects (KDE) KWallet. (note that KWallet may not work reliably outside KDE. she's a little KDE-dependent like that 💀)
  • --version — show version information.

🦋 a lil bonus note 🦋

as a GTK+ app, chromium also obeys GTK+ command-line flags, such as --display. see the GTK documentation for more:

<http://library.gnome.org/devel/gtk/stable/gtk-running.html>

<http://library.gnome.org/devel/gtk/stable/gtk-x11.html>

🌈 ENVIRONMENT 🌈

chromium obeys the following environment variables (yes, she's listening 👀):

  • all_proxy — shorthand for specifying all of http_proxy, https_proxy, ftp_proxy.
  • http_proxy, https_proxy, ftp_proxy — the proxy servers used for HTTP, HTTPS, and FTP. note: because Gnome/KDE proxy settings may propagate into these variables in some terminals, this variable is ignored (in preference for actual system proxy settings) when running under Gnome or KDE. use the command-line flags to set these when you want to force their values. Gnome/KDE stay winning, apparently 😭
  • auto_proxy — specify proxy autoconfiguration. defined and empty autodetects; otherwise, it should be an autoconfig URL. but see above note about Gnome/KDE.
  • SOCKS_SERVER — SOCKS proxy server (defaults to SOCKS v4, also set SOCKS_VERSION=5 to use SOCKS v5).
  • no_proxy — comma separated list of hosts or patterns to bypass proxying.

💅 FILES 💅

💀 BUGS 💀

Debian bug tracker:

https://bugs.debian.org/chromium

Upstream bug tracker:

http://code.google.com/p/chromium/issues/list

be sure to do your search within "All Issues" before reporting bugs, and be sure to pick the "Defect on Linux" template when filing a new one. don't skip that part bestie, they will send you back to search again 😭

if your bug is specific to Debian, please submit it only to the Debian bug tracker.

https://www.debian.org/Bugs/Reporting

👑 AUTHOR 👑

the Chromium team — <http://www.chromium.org>

and that's the whole page, babe 🎀 that footer you saw was just chromium(1) chillin' all by itself — no date, no version number, just the name, humble and unbothered. slay. go browse something. 🦋💖

📦 where this page comes from