brave-origin(1)

💅 brave-origin(1) — the manual, but make it make sense

okay so picture this: you type man brave-origin and get a wall of text. that's this. it's the brave-origin(1) page from the USER COMMANDS section of the manual, and i'm gonna walk you through it like we're on facetime. grab a snack. 🍓

✨ NAME ✨

brave-origin — the Brave Browser, bestie. that's it. that's the name section. iconic brevity.

🦋 SYNOPSIS 🦋

brave-origin [OPTION] [PATH|URL]

so like. options, then optionally a path or a URL. that's the whole shape of it. slay.

🌸 DESCRIPTION 🌸

real talk, this one's short: if you want actual help using the browser, go read the Brave Help Center, which lives here:

<https://support.brave.app/>

and this manpage? it's not about the browsing. it only covers how you invoke it, the environment, and the arguments. that's the vibe check. 💜

🔥 OPTIONS 🔥

so here's the tea: Brave Origin has hundreds of undocumented command-line flags that get added and removed at the whim of the developers. like, literally on a whim. so this page only documents the relatively stable ones — the ones that won't ghost you. 🫶

• --user-data-dir=DIR — tells it where to keep your user data, i.e. your "profile." defaults to $HOME/.config/brave-origin. important: separate instances of Brave Origin have to use separate user data directories — no sharing. and if you run brave-origin again with the same user data directory, it just reuses the existing process instead of spawning a new one. lowkey efficient. ✨
• --app=URL — runs URL in "app mode," which means no browser toolbars. just the page. main character energy, zero chrome (the UI kind, not the browser kind 😭).
• --incognito — opens in incognito mode. you know what it is. 🙈
• --new-window — if a PATH or URL is given, opens it in a new window. simple, does what it says on the tin.
• --proxy-server=host:port — specifies the HTTP/SOCKS4/SOCKS5 proxy server to use for requests. this overrides any environment variables or settings you picked via the options dialog. an individual proxy server is specified using this 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 you leave out <proxy-scheme>, it defaults to "http". also, heads up: "socks" is equivalent to "socks5". iykyk.

examples, because examples are everything:

--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.

and it gets even better — you can 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".

(that line break in the middle is literally in the original, i'm not doing that to you on purpose 😭)

• --no-proxy-server — disables the proxy server. overrides any environment variables or settings picked via the options dialog. the ultimate "nope." 💀
• --proxy-auto-detect — autodetects proxy configuration. overrides any environment variables or settings picked via the options dialog. again with the overriding, she loves to override.
• --proxy-pac-url=URL — specifies the proxy autoconfiguration URL. overrides any environment variables or settings picked via the options dialog. yes, the same override note. it's consistent, okay, it's a theme.
• --password-store=<basic|gnome|kwallet> — sets the password store to use. the default is to automatically detect based on your desktop environment. the options:
  • basic selects the built-in, unencrypted password store. (yes, unencrypted. i said what i said. 👀)
  • gnome selects Gnome keyring.
  • kwallet selects (KDE) KWallet.

note: KWallet may not work reliably outside KDE. that's a real caveat, not me being dramatic.

• --version — shows version information. the classic.

also! as a GTK+ app, Brave Origin obeys GTK+ command-line flags, such as --display. the GTK docs have more, if you're curious:

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

🌈 ENVIRONMENT 🌈

Brave Origin obeys the following environment variables. yes, obeys. she's loyal like that. 🎀

• all_proxy — shorthand for specifying all of http_proxy, https_proxy, ftp_proxy. one variable to rule them all.
• 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. no cap, this one trips people up.

• auto_proxy — specifies proxy autoconfiguration. defined and empty means autodetect; otherwise, it should be an autoconfig URL. but see the note above about Gnome/KDE. ⭐
• SOCKS_SERVER — SOCKS proxy server. defaults to SOCKS v4, and you also set SOCKS_VERSION=5 to use SOCKS v5.
• no_proxy — comma separated list of hosts or patterns to bypass proxying. the "not them" list. 💅

🧚 FILES 🧚

• $HOME/.config/brave-origin — default directory for configuration data.
• $HOME/.cache/brave-origin — default directory for cache data. (why? see <http://standards.freedesktop.org/basedir-spec/latest/> .) — and yes, the space before that period is in the original, i refuse to gaslight you. 😭

💀 BUGS 💀

bug tracker time:

https://github.com/brave/brave-browser/issues/

be sure to do your search within "All Issues" before reporting bugs — fr fr, search first, it's the respectful thing to do — and be sure to pick the "Defect on Linux" template when filing a new one. the right template = the right people see it. flair matters. 🔥

👑 AUTHOR 👑

Brave Software — <https://brave.com/>

---

and that's the whole page, bestie 🫶 you made it. this one's brave-origin(1), from the USER COMMANDS section — that's the header up top, and the footer at the bottom is literally just brave-origin(1) again, no date, no version number, nothing. we love a minimal sign-off. periodt. 💖