Start here

Install Gloom: Mac, Windows, Linux, TUI

Install the Gloom desktop app on Mac or Windows, or run it in a terminal with one command. Then update it and confirm it runs.

macOS

Either command installs the desktop app and the gloom terminal command.

bash
brew install --cask gloom
# or
curl -fsSL gloom.sh/install | bash

Or use the direct download. The desktop app and the Homebrew cask (brew install --cask gloom) need Apple Silicon; on an Intel Mac use the browser version, or look for a terminal binary in the release assets.

The script downloads the latest GitHub release, checks its SHA-256, and installs the app to /Applications and gloom to ~/.local/bin, using sudo only for a folder you can't write. It prints a PATH line and edits no shell file. Source: scripts/install.sh in gloom-sh/gloomberb.

Coming from Bloomberg? What runs on a Mac.

Linux

Terminal UI only; Ghostty, Kitty, or WezTerm render charts best.

bash
curl -fsSL gloom.sh/install | bash

The script downloads the latest GitHub release, checks its SHA-256, and installs gloom to ~/.local/bin, using sudo only for a folder you can't write. It prints a PATH line and edits no shell file. Source: scripts/install.sh in gloom-sh/gloomberb.

Windows

The desktop installer installs the app and the gloom command, with no admin rights. It is not code-signed yet, so SmartScreen may stop it:

  1. Run the installer.
  2. If Windows says "Windows protected your PC", click More info.
  3. Click Run anyway.

Terminal only, in PowerShell:

powershell
irm https://gloom.sh/install.ps1 | iex

Then open a new terminal window.

Windows notes
  • Checksum: the installer is about 280 MB. Compare Get-FileHash on it with the SHA-256 on the release page.
  • Terminal: the installer adds gloom to your PATH, so open a new terminal window. PowerShell works.
  • PowerShell line: installs gloom.exe from the latest release into %USERPROFILE%\.local\bin, checks its SHA-256 and adds the folder to your PATH, with no admin rights. Under Git Bash the bash line points here. With Bun, bun install -g @gloom-sh/terminal works too.
  • Charts: Windows Terminal has no Kitty graphics, so terminal charts draw as text. The desktop app draws them in full.
  • cmd.exe: run chcp 65001 so long dashes, € and · show, and quote an index symbol (gloom quote "^SPX"): cmd drops a bare ^. See CLI.
  • Data: %USERPROFILE%\.gloomberb, printed by gloom version. GLOOMBERB_HOME moves it.
  • Exports: save an export with --output (gloom fn RV NVDA,AMD,ASML:AMS --csv --output rv.csv), which writes UTF-8 without a byte-order mark; a > redirect in Windows PowerShell 5.1 writes UTF-16. See CLI.
  • Git and Bun: Bun ships with the app; Git does not. Some official plugins (TV, Substack, Interactive Brokers, IBKR Gateway, Public, Robinhood, SimpleFIN, Polls, Prediction Markets, BYOK AI) install from GitHub and need Git for Windows. Without it Gloom starts without them, says so, and gloom doctor names them.
  • Versions: Windows 11 x64 is tested. ARM PCs run the x64 build through Windows' emulation: the desktop app is checked to open and stay open on Windows 11 on Arm, nothing more. Windows 10 is untested.

Browser

Open term.gloom.sh. No account needed: search, charts, most panes, quotes 15 minutes delayed and news 12 hours delayed, in a one-pane workspace. Layouts stay in your browser.

A free sign-in adds filings, analysts, supply chain, scanners, sync and sharing. Real-time data and some research panes need Pro. The browser cannot connect brokers or install local plugins.

Check it works

gloom
gloom version
gloom doctor

gloom opens the terminal UI. version prints the data folder, and doctor checks that config, the cache database, plugins, and capabilities load.

Update

InstallUpdate
Terminal appUpdates itself; u retries a failed update.
Desktop appUpdates itself; Check for Updates in the menu or command bar checks now.
Homebrewbrew upgrade --cask gloom
Bunbun install -g @gloom-sh/terminal@latest
Older installs

An existing gloomberb install keeps updating as it is.

Installed before 0.18.4, when the command was gloomberb? Updating adds gloom beside it and gloomberb keeps working, with nothing to reinstall.

Had Gloomberb.app? Its next update renames it to Gloom.app; settings and data stay.

Release channels: stable and nightly

The app updates from stable releases, the ones on the changelog. Nightly is a daily build of main that gets fixes first and can break. To switch, run Release Channel from the command bar (on the Mac, also Release Channel... in the app menu), or in a terminal:

bash
gloom config set updates.channel nightly

Switching back to stable never installs an older version: your nightly build stays until a newer stable release is out. Nightly applies to the desktop app and the terminal app; Homebrew, Bun and the install script always get stable.

Uninstall

Quit Gloom, then remove it the way you installed it:

  • Homebrew: brew uninstall --cask gloom removes the app and its commands. Add --zap to delete your data too.
  • macOS install script: rm -rf /Applications/Gloom.app ~/.local/bin/gloom ~/.local/bin/gloomberb
  • macOS disk image: drag Gloom.app from Applications to the Trash.
  • Linux: rm ~/.local/bin/gloom ~/.local/bin/gloomberb
  • Windows installer: Settings > Apps, Gloom, Uninstall.
  • Windows PowerShell line: delete %USERPROFILE%\.local\bin\gloom.exe, then that folder's entry in your user PATH.
  • Bun: bun remove -g @gloom-sh/terminal

Your data stays unless you use --zap or delete it yourself.

Where Gloom keeps its data, and the small print

gloom version prints the data folder in use.

  • macOS and Windows: ~/.gloomberb (%USERPROFILE%\.gloomberb on Windows). It holds settings, the database, plugins and logs. config.json there can hold broker credentials.
  • Linux: ~/.gloomberb if you have it. A new install without it uses ~/.config/gloomberb, ~/.local/share/gloomberb and ~/.cache/gloomberb, or the folders $XDG_CONFIG_HOME, $XDG_DATA_HOME and $XDG_CACHE_HOME name when set.
  • GLOOMBERB_HOME: if you set it, everything above lives in that folder instead.

The Mac desktop app also keeps these three. With --zap, Homebrew deletes them and ~/.gloomberb:

~/Library/Application Support/com.vincelwt.gloomberb
~/Library/Preferences/com.vincelwt.gloomberb.plist
~/Library/WebKit/com.vincelwt.gloomberb

The Windows desktop app keeps this folder, if uninstalling left it:

%LOCALAPPDATA%\com.vincelwt.gloomberb

Those folders are named after the desktop app's identifier, com.vincelwt.gloomberb. If a newer build has moved to sh.gloom.desktop, delete that name too.

The small print:

  • Shell files: the macOS and Linux script edits none. If you added the PATH line it printed, delete that line.
  • sudo: use it for a folder the script needed it for.
  • Before 0.18.4: an install from then that has not updated since has Gloomberb.app, not Gloom.app.
  • Intel Mac: the script installs the terminal command only, so there is no app to delete.
  • Windows installer: its entry is listed once the app has started; before that, delete the folder above. If the app folder's bin is still on your user PATH afterwards, remove it.
  • Windows PATH: to edit your user PATH, search for "Edit environment variables for your account".

Your Gloom account and what it synced stay until you delete the account in the app's account settings.

Next: your first session.